Funnel fetches data from Twitter Ads API. This is not the same data that is found on Twitter Analytics. To see the data Funnel fetches from Twitter log on to ads.twitter.com.
For more detailed troubleshooting steps, please see the sections below:
Account levels and permissions on Twitter
If you experience issues when connecting an account to Funnel, or get messages about lack of permissions reading data, please continue reading.
Each user that has access to an Ads Account will have a specific account-level permission: Account administrator, Ad manager, Campaign analyst, Organic analyst, and Creative Manager. For the most common use-cases, Campaign Analyst level will suffice. You can read more about the levels here to find out what access level you need to have to get the correct permissions.
Missing Card Data
To be able to see Card Data, you'll need to be Creative Manager, Ad Manager or Account Administrator.
If you have tweet information but are missing card data, the reason could be Cards are associated with a single ad account. It’s likely that the Tweet was created by an ad account that owns the Card but was promoted via another ad account. You will therefore only be able to see tweet data in this connected data source, but not specific card data, such as "Card Name" or "Card ID".
Why is my Twitter data not consistent in Funnel?
Metric sums are not consistent across dimension levels
A common misunderstanding is that metric sums are unaffected by which dimension level (Campaign, Ad Group or Promoted Tweet) is selected at connect. Below is a short summary of both types of level and how they differ:
Campaign and Ad Group level
On Campaign and Ad Group level, data from all Ads categories are included (Tweets, Display creatives, In-stream videos and Other). Therefore, metric sums on Campaign and Ad Group level will be consistent with each other.
Promoted Tweet level
Promoted Tweet level only represents the Tweets under the Ads category in the Twitter Ads Manager. Therefore, selecting this dimension level may lead to metric sums lower than those on Campaign level.
Segmented data is not consistent with non-segmented data
It can be confusing to see that segmented data will not be 100% consistent with non-segmented data. This is however expected behaviour according to Twitter due to how they derive the information. Twitter provides more information on segmentation here.
Campaign ID's do not match between Twitter and Funnel
The Twitter UI shows the campaign ids in base-10. In Funnel these are displayed as base-36. This is consistent with the response we get from Twitter's API, as shown in their documentation here. For joins between base-10 and base-36 columns in Excel/Sheets/Calc, you can use the BASE formula, to convert base-10 into base-36.
Missing Tweet Names
If no input was given for the Tweet Name when creating a tweet the Twitter UI uses the creative (card name) instead and hence the Ad name that you see on UI is not necessarily the same as a Tweet name.
A tweet may be missing a set Tweet name due to the following reasons:
The tweet was created before December 2021.
The tweet was originally created without a Tweet name,
The tweet is a re-tweet of a Tweet.
The original Tweet/Card belongs to another Ads Account.
A note regarding video metrics
The Video Total Views column in Funnel behaves just like the Result column in the Twitter Ads UI. The content of the column is based on the objective of the tweet.
This means that:
For the objective VIDEO_VIEWS_PREROLL, the column Video Total Views shows what Twitter refers to as In-stream video ad views.
For the objective VIDEO_VIEWS, the column Video Total Views shows what Twitter refers to as Video views.
In addition, unlike Funnel, Twitter's UI breaks down other video metrics depending on the objective of the tweet.
For the objective VIDEO_VIEWS_PREROLL, the column Video 3s 100pct views shows what Twitter refers to as 3s/100% in-stream video ad views.
For the objective VIDEO_VIEWS, the column Video 3s 100pct views shows what Twitter refers to as 3s/100% video views.
The same applies to Video played 25pct, Video played 50pct, and Video played 75pct; which are populated with the contents of either In-stream video ad played or Video played in Twitter.
If desired, it is possible to create custom metrics in Funnel that performs the same breakdown based on objective as Twitter.
No data in the "Media Creative" report
A "Media Creative" is not to be confused with creatives such as images, gifs, videos etc. The "Media Creative" report only contains data for Ad Groups across the Twitter Audience Platform.
The Twitter Audience Platform (TAP) is a network where advertisers can expand the reach of their campaigns beyond Twitter through devices served by MoPub. Read more about the The Twitter Audience Platform (TAP) here.
If you don't see any data in Funnel, the cause is most likely that you don't have any Ad Groups across the Twitter Audience Platform, and therefore no "Media Creatives" to fetch data for. Try to connect a "Promoted Tweet" report instead.
No Mobile Conversions data
Mobile conversion stats are available only to advertiser accounts enabled for MACT.
Read more about MACT here.
My Twitter connection has stopped working and doesn't download data
If your Twitter connection has stopped working and doesn't download data into Funnel, it could be because Funnel doesn't have access to your twitter account. To check if this is the case, please follow these steps:
Log into your account on twitter.com, then click "More" (3 dots logo).
Click "Settings and Privacy".
Click "Account", then under "Data and Permissions", click "Apps and Sessions".
Is there a Funnel.io app there? Good, we have access.
If not, the reason could be the following:
Accounts not fully set up on the Ads API are not available for Funnel to access
In particular, this may affect Analytics accounts that are not fully set up on the Ads API and fetch organic analytics. This change was made by Twitter to maintain consistency across the Ads API and to keep it focused on ads accounts and ads use cases.
In order to continue to be able to access these ads accounts, you must complete the one-time setup. To do so, follow the instructions on Twitter Ads account creation setup.
I have gone to ads.twitter.com and there is already an ads account set up. Do I need to set up a campaign for the connector to work?
A campaign does not have to be started or paid for in order to use the account with the Ads API. However, the account itself must be fully set up. This has to be done on ads.twitter.com and includes adding the country and time zone as well as entering billing information. Details on the billing basics process can be found here.
It’s necessary to enter your billing information to complete your ads account and start your campaign.
The account itself must be fully set up. If the flow prompts you to create a campaign, go ahead and create a campaign and pause it immediately to avoid incurring costs.
I've done all of the above and it's still not working - what do I do now?
If you've completed the above setup and made sure that your Ads account is fully set up, there are two more options to try. However, they should not be attempted without first trying the above steps as the connector won't work without your account being properly set up in the first place.
Wait a couple of hours
It can take a little while for Twitter to update the account changes. Waiting an hour or two can solve the issue by itself.
Revoke and re-add permissions
If none of the above has worked, you may try the following:
Revoke and re-add Funnel permissions in TW platform for the handle.
I have a lot of connections/accounts, do I need to update credentials for each?
You would only need to manually reconnect 1 source for each set of credentials, the rest of the sources using the same credentials will then start working again.