Learn how Singular pulls data from Twitter and displays it in your reports.
|Data Connector Technology||API (Twitter API version 9 - see documentation)|
|Data breakdown (segmentation)||
Data from Twitter is always broken down by:
In addition, you can get one of the following breakdowns:
If you're interested in getting geographic location instead of platform breakdown, reach out to your Customer Success Manager or Singular support and specify whether you want the user's City, Region, or DMA.
Note: Twitter does not provide publisher breakdown.
|How far back we pull data||30 days|
|Time zone||Defined by the customer per account|
|Is data available on the creative level?||Yes|
|Does Singular show your creative assets?||Yes - including images, videos, and streaming videos.
Singular does not show Polls.
|Known Limitations/ Issues
To learn more about internal discrepancies in Twitter data, see Twitter's article on the subject.
- Sub-Campaign in Singular corresponds to Twitter's Line Item.
- Creative in Singular can correspond to Twitter's Tweet, Promoted Tweet, Card, or Media Creative.
- Metrics are pulled from Twitter's Line Item, Promoted Tweet, and Media Creative objects.
- The geographic location dimensions (Country, Region, City, DMA Name) are available only if you've requested to get location instead of platform breakdown (see "Data breakdown" above).
- For a description of each field in Singular, see Metrics and Dimensions.
|Field in Singular UI||Field in Singular API||Field in Twitter|
|Campaign Dimensions||Account ID||adn_account_id||Account_object: id|
|Campaign Dimensions||Account Name||adn_account_name||Account_object: name|
|Campaign Dimensions||Agency||agency||Not pulled directly from Twitter, but Singular can set the agency per each account.|
|Campaign Dimensions||App Site ID||app_site_id||Estimated based on any URLs available in creative-related objects (Tweets, Promoted Tweets, Cards, Media Creatives, Account Medias). If not possible, we try to estimate based on campaign URLs and Line Item URLs.|
|Campaign Dimensions||Campaign URL||adn_campaign_url||
|Campaign Dimensions||Country||country_field||We query the Twitter API with segment_by=”LOCATIONS”, and take the segment name for each Line Item and Promoted Tweet.|
|Campaign Dimensions||Date||date_field||Since the Singular data connector pulls daily reports, we add the date ourselves.|
|Campaign Dimensions||DMA Name
|Campaign Dimensions||Network Campaign ID||adn_campaign_id||"id" in the Campaign object|
|Campaign Dimensions||Network Campaign Name||adn_campaign_name||"name" in the Campaign object|
|Campaign Dimensions||Network Creative ID||adn_creative_id||Depends on the type of the creative.
|Campaign Dimensions||Network Creative Name||adn_creative_name||Take the "media id" from the Card object and query Twitter for the media "name".|
|Campaign Dimensions||Network Sub Campaign ID||adn_sub_campaign_id||"id" in the Line Item object|
|Campaign Dimensions||Network Sub Campaign Name||adn_sub_campaign_name||"name" in the Line item object|
|Campaign Dimensions||Public Id||site_public_id||"googleplay_app_id" or "iphone_app_id" in the Card object, if available.|
|Campaign Dimensions||Sub Ad Network||adn_subadnetwork||
|Campaign Dimensions||Target Countries||target_countries_str||For each sub-campaign (line item), we pull "countries" from the /targeting_criteria endpoint. We concatenate the results into this field.|
|Campaign Dimensions||Text||creative_text||Depending on the type of the creative, either "name" from the Card object, "text" from the Tweet object, or "media_name" from the Account Media.|
|Campaign Dimensions||Timezone||adn_timezone||"timezone" in the Account object|
|Creative Dimensions||Creative Reported URL||creative_reported_url||Same as Campaign URL|
|Metrics||Original Currency||adn_original_currency||“currency” in the Campaign object|
|Metrics||Completed Video Views||completed_video_views||“video_views_100”|
|Metrics||Video Views - 25%||video_views_25pct||“video_views_25”|
|Metrics||Video Views - 50%||video_views_50pct||“video_views_50”|
|Metrics||Video Views - 75%||video_views_75pct||“video_views_75”|