X (Twitter) Ads 数据连接器

关注
Avatar
Vaibhav Gupta
Updated
设置 X Ads
成本聚合
设置数据连接器
广告变现聚合
不支持
数据差异
详情即将推出

 

了解 Singular 如何从 X Ads（原 Twitter）提取广告成本数据并在您的报表中展示。在 Singular 仪表板中，X Ads 广告系列数据的来源仍显示为 Twitter。

 

快速详情

数据连接器技术 API (X Ads API version 11 - 查看文档)
数据分类（细分）

X Ads（Twitter）的数据始终按以下维度分类：

  • 广告系列
  • 子广告系列（Line Item）

此外，您还可以获取 以下任一分类维度：

  • 平台 （默认）
  • DMA Name
  • 年龄
  • 性别

如果您希望获取地理位置而非平台分类，请联系您的 Customer Success Manager 或 Singular 支持团队，并说明您需要用户的 DMA。

注意： X Ads 不提供发布商分类。

X Ads 已不再支持城市或地区分类。
我们从多长时间前提取数据 30 天
时区 由客户按账户定义
创意层面的数据可用吗？ 是
Singular 是否会显示您的创意资产？ 是 - 包括图片、视频和流媒体视频。
Singular 不显示 Polls。
已知限制/问题
 
  • X Ads 不提供 Publisher 分类。
  • 在推文发布之前，Singular 无法显示 Scheduled Tweets。推文发布后我们才会提取。
  • 没有按创意统计的安装数据。
  • 创意层面的指标不一定与子广告系列层面（X Ads 的 Line Item）提取的指标一致。
  • X 的 platform 分类报表与 X 的 country 分类报表之间可能存在差异。

要详细了解 X Ads 数据的内部差异，请参阅 X Ads 关于此主题的文章。

数据映射

术语说明：

  • Sub-Campaign 在 Singular 中对应 X Ads 的 Line Item。
  • Creative 在 Singular 中可以对应 X Ads 的 Tweet、 Promoted Tweet、 Card或 Media Creative。 
  • 指标提取自 X Ads 的 Line Item、 Promoted Tweet和 Media Creative 对象。
  • 地理位置维度（Country, DMA Name）仅在您请求获取位置而非平台分类时才可用（参见上文"数据分类（细分）"）。

有关 Singular 中各字段的说明，请参阅 指标与维度。

Field in Singular UI Field in Singular API Field in X Ads API
Dimensions
Account ID adn_account_id Account_object: id
Account Name adn_account_name Account_object: name
Agency agency Not pulled directly from X Ads, 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.
Campaign URL adn_campaign_url
  • Pulled from a Card object related to a Tweet related to a Line Item in the campaign.
  • The field is "website_dest_url" in X Ads API v. 6.0 but if that is not populated we look under old field names: “website_url", "website_shortened_url", "media_url". 
  • If there was no Card, we look for the "landing_url" field in a Media Creative object.
Country country_field We query the X Ads 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.
DMA Name
 		 dma_name_field
 		 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.

  • If the creative is a Promoted Tweet: "tweet_id" in the Promoted Tweet object
  • If the creative is a Media Creative: "id" in the Account Media object.
Network Creative Name adn_creative_name Take the "media id" from the Card object and query X Ads 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
Placement
 		 placement
 		 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)
Platform platform
  • This is only available if you have asked Singular to receive the Platform breakdown instead of the Country breakdown.
  • We query the Twitter API with segment_by=”PLATFORMS”, and take the segment name for each Line Item and Promoted Tweet.
Public Id site_public_id "googleplay_app_id" or "iphone_app_id" in the Card object, if available.
Sub Ad Network adn_subadnetwork
  • Set to "twitterfeed" if the data was queried from "ALL_ON_TWITTER"
  • Set to "twittertpn" if the data was queried from "PUBLISHER_NETWORK"
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
Age age AGE
Gender gender GENDER
Metrics
Comments
 		 comments replies
Likes
 		 likes likes
Network Clicks adn_clicks “clicks”
Network Impressions adn_impressions "impressions"
Network Installs adn_installs "mobile_conversion_installs"
Original Cost adn_original_cost "billed_charge_local_micro"
Original Currency adn_original_currency “currency” in the Campaign object
Page Follows
 		 page_follows follows
Shares
 		 shares retweets
Video Views video_views “video_total_views”
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”

Singular 也支持提取此合作伙伴的广告系列属性， 请点击此处查看更多详情。