X (Twitter) 数据连接器

文档

了解 Singular 如何从 X(原 Twitter)获取广告成本数据并将其显示在报告中。在 Singular 的仪表板中,您仍然可以找到 Twitter 作为 X 的来源。

快速了解详情

数据连接器技术 应用程序接口(X 广告应用程序接口版本 9 -参见文档)
数据分类(细分)

来自 X(Twitter)的数据总是按以下方式细分:

  • 活动
  • 子活动(细项)

此外,您还可以获得 以下其中一种细分

  • 平台(默认)
  • 国家 + 城市
  • 国家 + 地区
  • 国家 + DMA 名称
  • 年龄
  • 性别

如果您希望获得地理位置而非平台细分,请联系您的客户成功经理或 Singular 支持人员,并指定您是否需要用户的城市地区DMA

注: Twitter 不提供出版商分类。

我们从多长时间前提取数据 30 天
时区 由客户按账户定义
是否提供创意层面的数据?
Singular 是否显示您的创意资产? 是的,包括图片、视频和流媒体视频。
Singular 不显示投票。
已知限制/问题
  • Twitter 不提供发布者明细。
  • Singular 无法在推文上线前显示 "预定推文"。我们会在它们上线时/上线后拉出它们。
  • 没有每个创意的安装统计。
  • 创意层面的指标并不总是与子活动层面(Twitter 的细列项目)的指标相匹配。
  • Twitter 的平台细分报告与 Twitter 的国家细分报告之间可能存在差异。

要了解有关 Twitter 数据内部差异的更多信息,请参阅Twitter 的相关文章

数据映射

术语注释:

  • Singular 中的Sub-Campaign对应 Twitter 的Line Item
  • Singular中的 "创意"可对应 Twitter 的 "鸣叫"、"推广鸣叫"、"卡片"或 "媒体创意"。
  • 度量指标来自 Twitter 的 "行项目"、"推广推文 "和 "媒体创意"对象。
  • 地理位置维度(国家、地区、城市、DMA 名称)仅在您要求获取位置而非平台细分时可用(请参阅上文 "数据细分")。

有关 Singular 中每个字段的说明,请参阅 "度量和维度"。

Singular UI 中的字段 Singular API 中的字段 Twitter 中的字段
维度
账户 ID adn_account_id 账户对象:id
账户名称 adn_account_name 账户对象:名称
机构 机构 不是直接从 Twitter 提取,但 Singular 可以为每个账户设置代理机构。
应用程序网站 ID app_site_id 根据创意相关对象(推文、推广推文、卡片、媒体创意、账户媒体)中的任何可用 URL 估算。如果不可能,我们会尝试根据广告系列 URL 和行列项目 URL 进行估算。
活动 URL adn_campaign_url
  • 从与推文相关的卡片对象中提取,该推文与广告系列中的行项目相关。
  • 在 Twitter API v. 6.0 中,该字段名为 "website_dest_url",但如果该字段名未填入,我们会查找旧的字段名:"url"、"website_shortened_url"、"media_url"。
  • 如果没有 Card,我们会在媒体创意对象中查找 "landing_url "字段。
城市
城市字段
国家 字段 我们使用 segment_by="LOCATIONS "查询 Twitter API,并获取每个行项目和推广推文的段落名称。
创意报告 URL 创意报告 URL
日期 日期字段 由于 Singular 数据连接器拉取的是每日报告,因此我们自己添加日期。
DMA 名称
字段
与广告系列 URL 相同
网络广告系列 ID adn_campaign_id "广告系列对象中的 "id
网络广告系列名称 adn_campaign_name "广告系列对象中的 "name
网络创意 ID adn_creative_id 取决于创意类型。
  • 如果创意是 "推广鸣叫":"推广推文对象中的 "tweet_id
  • 如果创意是媒体创意:账户媒体对象中的 "id"。
网络创意名称 adn_creative_name 从卡片对象中获取 "媒体 ID",并在 Twitter 中查询媒体 "名称"。
网络子广告系列 ID adn_sub_campaign_id "行项目对象中的 "id
网络子活动名称 adn_sub_campaign_name "行项目对象中的 "name
位置
位置
位置(可能的值:all_on_twitter、publisher_network、twitter_profile、twitter_search、twitter_timeline、tap_banner、tap_full、tap_full_landscape、tap_native、tap_mrect)
平台 平台
  • 只有当您要求 Singular 接收平台细分而不是国家细分时,才能使用此功能。
  • 我们使用 segment_by="PLATFORMS "查询 Twitter API,并获取每个行项目和推广推文的分段名称。
公众 ID site_public_id 卡对象中的 "googleplay_app_id "或 "iphone_app_id"(如有)。
区域
区域字段
子广告网络 adn_subadnetwork
  • 如果数据是从 "ALL_ON_TWITTER "中查询的,则设置为 "twitterfeed
  • 如果数据是从 "PUBLISHER_NETWORK "中查询的,则设置为 "twittertpn
目标国家 target_countries_str 对于每个子营销活动(行项目),我们从 /targeting_criteria 端点提取 "国家"。我们将结果连接到该字段中。
文本 创意文本 根据创意的类型,从 Card 对象中提取 "name",从 Tweet 对象中提取 "text",或从账户媒体中提取 "media_name"。
时区 adn_timezone "账户对象中的 "时区
年龄 年龄 年龄
性别 性别 性别
指标
平均频率
频率 平均频率
评论
评论 回复
喜欢
喜欢 喜欢
网络点击 adn_clicks "点击次数
网络印象 adn_impressions "印象"
网络安装 安装 "移动转换安装"
原始成本 原始成本 "计费本地微成本"
原始货币 原始货币 "广告系列对象中的 "currency
页面关注
page_follows 关注
达到
达到 受众总数
份额
份额 转发
视频浏览量 视频浏览量 "视频总观看次数
已完成的视频浏览量 已完成的视频浏览量 "videoo_views_100"
视频浏览量 - 25 视频浏览量 - 25 "video_views_25"
视频浏览量 - 50% 视频浏览量_50 "video_views_50"
视频浏览量 - 75 视频观看次数_75 "视频浏览量_75

Singular 还支持为该合作伙伴提取营销活动属性,详情请点击此处