X (Twitter) Web - Web 转应用广告系列

设置 X (Twitter) 广告

本文详细介绍如何为 X (Twitter) web 广告系列(非应用广告系列) 配置 Singular 的移动端、PC 和主机安装归因。有关配置和归因 X (Twitter) 应用广告系列 的说明,请参阅我们的 X (Twitter) 广告归因指南

X (Twitter) 广告系列不支持 MMP 追踪器 URL,因此所有转化仅通过点击归因来衡量,即在 Website URL 中设置 Singular 追踪器。

概述

Singular 的 web-to-app 归因解决方案帮助营销人员开展 web 广告系列,从而在移动端、PC 和主机平台上推动应用安装。更多详情请参阅 Web、Web-to-App、PC 与主机广告系列优化。

在 Singular 中添加 X (Twitter) Web 的 Partner Configuration

在 Singular 中添加 X (Twitter) Web CAPI 的 Partner Configuration

  1. 前往 Singular > Attribution > Partner Configuration
  2. 点击 " Add a Partner ",然后输入并选择 " Twitter Web CAPI "
  3. 在对话框中,选择要配置的 App 及 App site(平台)。此集成支持移动端、PC 和主机应用
  4. 粘贴您应用的 " Access Token "、" Access Secret "、" Consumer Key "、" Consumer Secret "、" Install Event ID " 和 " Pixel ID "。
    Singular Twitter Web CAPI partner configuration showing the Access Token, Access Secret, Consumer Key, Consumer Secret, Install Event ID, and Pixel ID fields
  5. (可选)配置要发送给 X (Twitter) 的任何其他事件,并将其映射到 "X Event ID"
    Configuring additional events mapped to X Event IDs in Singular

  6. 点击 " Save " 完成。
为 "Twitter Web CAPI" 创建 Singular Link

为 "Twitter Web CAPI" 创建 Singular Link

  1. 前往 Singular > Attribution > Manage Links
  2. 从左侧的应用列表中选择您的移动应用
  3. 选择 "Create Link" -> Link Type "Partner" -> Source Name "Twitter Web CAPI"
  4. 按照分步流程完成链接创建。
  5. (可选) 如果您的链接包含 iOS 深度链接目标,请启用 Social Landing Page。详情请参阅 下文
  6. 点击 "Generate"
  7. 复制 "Click-through Tracking Link" 以用于下一步。

计划使用深度链接?

X (Twitter) 的应用内浏览器不支持 iOS Universal Links。当用户在 iOS 上从 X (Twitter) 应用内点击您的广告时,深度链接会静默失败,将用户导向应用的主屏幕,而非预期的目标页面。

Singular 的 Social Landing Page 可解决此问题。它是一个中间页面, 由 Singular 自动创建 ,无需任何设置。当用户点击您的广告时,他们会进入此页面并点击 CTA 按钮,从而可靠地触发深度链接进入应用中正确的界面。

如何启用: 在链接创建流程中,前往 Social Link Settings > 切换开启 Enable Landing Page

⚠️ 当链接不包含深度链接目标时,不建议启用。

了解更多关于 Social Landing Page 的信息

设置您的 Twitter Web 广告系列

设置您的 Twitter Web 广告系列

  1. 在 Twitter Ads Manager 中,创建一个广告系列并选择 "Sales" 或 "Website Traffic" 广告系列目标:
    • Sales - 根据您在 Singular Partner Configuration 中设置的事件进行优化
    • Website Traffic - 以点击为目标进行优化
    Selecting the Sales or Website Traffic campaign objective in Twitter Ads Manager
  2. 添加媒体资源时,将上一节中的 Singular Link 设置为 Website URL
    Setting the Singular Link as the Website URL when adding the media in Twitter Ads Manager
  3. 由于 X Ads 不处理链接宏,请手动填写所有广告系列宏。示例:
    https://singular.sng.link/XXXXX/YYYY?pcn={campaign_name}&pscn={ad_group_name}&pcrn={ad_name}&wpsrc=Twitter%20Web%20CAPI&_forward_params=1&wpcn={campaign_name}&wpscn={ad_group_name}&wpcrn={ad_name}
    改为
    https://singular.sng.link/XXXXX/YYYY?pcn=Singular%20CName%20Test&pscn=Singular%20AdGroup%20Test1&pcrn=Singular%20Ad%20Test2&wpsrc=Twitter%20Web%20CAPI&_forward_params=1&wpcn=Singular%20CName%20Test&wpscn=Singular%20AdGroup%20Test1&wpcrn=Singular%20Ad%20Test2
    Example of a Singular Link with campaign macros populated manually for X Ads

FAQ

在哪里可以找到 Access 和 Consumer 的 Token 与 Secret?
  1. 如果您尚未注册 X Developer Account,请按照 X Developer Platform 的说明进行注册并 创建一个 APP: X Ads API: Getting Started
  2. 创建好 Developer APP 后,导航至 X Developer Portal 控制台。
  3. 导航至 " Projects & Apps " 页面, 选择项目并打开该 APP 的凭据页面。 Opening the app credentials page from the Projects & Apps page in the X Developer Portal
  4. 在 Keys and tokens 页面,您将找到集成所需的 全部 API 凭据: Locating the API credentials on the Keys and tokens page in the X Developer Portal
在哪里可以找到 X Event ID 和 X Pixel ID?
  1. 导航至 X Ads Manager 页面。
  2. 导航至 " Tools & Events Manager " 页面。 Navigating to the Tools & Events Manager page in X Ads Manager
  3. 在顶部复制您的 " X pixel ",并在 底部的表格中复制您的 " Event IDs " Copying the X pixel ID at the top and the Event IDs from the table in Tools & Events Manager

    如果这是新的 pixel 或事件,请按照 X Ad 的 分步指南创建一个 " Pixel "。 进一步了解 生成 Pixel 和创建事件
Singular 通过 API 发送哪些数据?
参数 详情
conversion_time
  • 安装或事件的时间戳。
event_id
  • 标准的 X Event ID。此值 用于 协助 X 对事件进行 去重。
twclid
  • X (Twitter) 点击 ID
  • 自动传递
hashed email
  • 如果提供了 twclid,则为可选。
  • 哈希后的电子邮件可作为 Singular 埋点 事件属性 "ehash" 传递
  • 哈希后的电子邮件值必须经过标准化并进行 SHA 256 哈希处理
IP address
  • 客户端 IP 地址
user agent
  • 与该事件对应的浏览器 user agent
X (Twitter) Conversions API 有哪些限制?
  • 没有可自动填充广告系列 数据的宏。如果您希望在 Singular 中获得此细分数据,则 需要在添加 Website URL 时手动设置,具体 请参见上文 " 设置您的 Twitter Web 广告系列 " 菜单中的说明。
  • X Ads 建议 将 X Conversion API 用于增强现有的 X pixel 实施,或在您无法在网站上实施 JavaScript 时使用。
  • 对于移动端集成,X 和 Singular 建议通过 Singular 专用的移动归因 与 X Ads 的集成来传递移动转化数据。如果您有兴趣通过 X Conversions API 传递 移动 转化数据,请联系 您的 Singular 客户成功经理。