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|
|Account ID||adn_account_id||Account_object: id|
|Account Name||adn_account_name||Account_object: name|
|Agency||agency||Not pulled directly from Twitter, but Singular can set the agency per each account.|
|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.|
|Country||country_field||We query the Twitter API with segment_by=”LOCATIONS”, and take the segment name for each Line Item and Promoted Tweet.|
|Creative Reported URL||creative_reported_url|
|Date||date_field||Since the Singular data connector pulls daily reports, we add the date ourselves.|
||Same as Campaign URL|
|Network Campaign ID||adn_campaign_id||"id" in the Campaign object|
|Network Campaign Name||adn_campaign_name||"name" in the Campaign object|
|Network Creative ID||adn_creative_id||Depends on the type of the creative.
|Network Creative Name||adn_creative_name||Take the "media id" from the Card object and query Twitter for the media "name".|
|Network Sub Campaign ID||adn_sub_campaign_id||"id" in the Line Item object|
|Network Sub Campaign Name||adn_sub_campaign_name||"name" in the Line item object|
||placements (possible values: ALL_ON_TWITTER, PUBLISHER_NETWORK, TWITTER_PROFILE, TWITTER_SEARCH, TWITTER_TIMELINE, TAP_BANNER, TAP_FULL, TAP_FULL_LANDSCAPE, TAP_NATIVE, TAP_MRECT)|
|Public Id||site_public_id||"googleplay_app_id" or "iphone_app_id" in the Card object, if available.|
|Sub Ad Network||adn_subadnetwork||
|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.|
|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.|
|Timezone||adn_timezone||"timezone" in the Account object|
|Original Currency||adn_original_currency||“currency” in the Campaign object|
|Completed Video Views||completed_video_views||“video_views_100”|
|Video Views - 25%||video_views_25pct||“video_views_25”|
|Video Views - 50%||video_views_50pct||“video_views_50”|
|Video Views - 75%||video_views_75pct||“video_views_75”|