如何测试跟踪链接（Singular 合作伙伴指南）

关注
Avatar
Dipayan Dhar
Updated

在使用 Singular Links 为我们共同的客户投放广告系列之前，我们建议先使用 Singular 团队提供的演示或测试跟踪链接来验证配置。 

该流程可确保用户点击数据被正确发送至 Singular，并确保 Singular 能够成功向您的服务器发送回传通知。它还可以帮助您确认服务器已接收到跟踪安装或转化事件所需的全部信息。  

适用对象 Singular 合作伙伴
前提条件
  1. 贵组织已完成 Singular 归因集成配置。
  2. 您已配置 Singular 点击模板和回传模板。
  3. 您已收到用于测试的测试跟踪链接

工具

一台用于测试的移动设备。

 

分步指南：使用 Singular 集成团队提供的测试链接

1

重置测试设备的广告 ID

如果您的移动设备此前用于过 Singular 归因测试，或已安装 Singular Device Assist 应用，则必须在再次测试前清除设备数据。如果这是您首次使用 Singular Device Assist 应用，可以跳过此步骤。

清除设备数据的步骤：

  1. 从设备上卸载/删除 Singular Device Assist 应用。

  2. 重置设备的广告标识符： 

    • Apple 设备：
      • 打开 设置 > 隐私与安全性
      • 选择 跟踪，然后将 允许 App 请求跟踪 关闭后再重新开启。 
    • Android 设备：
      • 打开 设置 > Google > 广告
      • 选择 重置广告 ID

重要提示：

  • 在 iOS 14 及更高版本中，关闭所有应用的 IDFA 访问权限会重置设备的全局 IDFA。请确保在测试前重新开启该开关，并在打开 Singular Device Assist 应用时 接受 弹出的 “允许 App 跟踪” 提示。这样您的广告 ID 才能与 Singular 共享以用于归因测试。
  • 只需一个获得跟踪授权的应用，就可能重置整台设备的 IDFA。例如，任何调用 requestTrackingAuthorization 并获得跟踪权限的应用都可能触发重置。

有关重置广告 ID 的更详细说明，请点击此处。 

 
2

查找新的广告 ID

重置设备的广告 ID 后，您需要找到新的 ID。您可以使用第三方应用，例如 Singular 的 Device Assist 测试应用（iOS 和 Android），也可以直接在设备设置中查看：

Apple 设备：

  • 在较新的 iOS 版本中，广告 ID（IDFA）只能通过第三方应用获取。
  • 在较旧的 iOS 版本中，您可以前往 设置 > 隐私 > 广告 查看 IDFA。

Android 设备：

  • 前往 设置 > Google > 广告 即可找到 AAID / AIFA（Android 广告 ID），也称为 GAID（Google 广告 ID）。
3

使用 Singular 链接（由 Singular 提供）

您应该已经从 Singular 团队收到一条跟踪链接，与下面的示例类似。

跟踪链接的关键说明：

  • 该链接包含 “aifa”、“idfa”、“cl” 和 “pcid” 等参数。
  • {花括号} 中的值是 宏，即媒体合作伙伴在投放广告时会替换为实际值的占位符。

重要提醒：

请务必从跟踪链接中移除所有不会填入值的宏。

  • 如果发送的是宏而不是实际值，Singular 将不会记录该点击，也就不会产生归因。 
https://singularassist.sng.link/D59c0/tpa9?aifa={google_advertising_id}
&idfa={idfa}&cl={click_id}&pcid={campaign_id}&pcn={campaign_name}
&pshid={publisher_id}&psn={publisher_site_name}&psid={publisher_site_id}
&pcrid={creative_id}&pcrn={publisher_creative_name}
4

归因测试方法：准备跟踪链接

确定性归因（Deterministic）：将广告 ID 插入链接

  1. 替换广告 ID 占位符：
    • Apple 设备：将 IDFA 宏（例如 {idfa}）替换为设备的实际 IDFA。 
    • Android 设备：将 Android 广告 ID（例如 {google_advertising_id}）替换为设备的实际 AIFA。
  2. 移除或替换其他占位符：
    • 除非您的回传 URL 必须使用，否则请删除所有未使用的占位符。
    • 例如，如果您的平台需要 Click ID 或 Transaction ID，请将相应参数（例如 cl）替换为有效值。
  3. 完整链接示例（Android）： 
https://singularassist.sng.link/D59c0/tpa9?aifa=0f9f9e46-df3b-
4012-8b1e-639ebc39a20f&idfa=&cl=123&pcid=&pcn=&pshid=&psn=&psid=
&pcrid=&pcrn=

 

概率性归因（Probabilistic）：适用于无法获取广告 ID 的渠道

  1. 重置设备的归因：
  2. 修改跟踪链接：
    • 重新复制该跟踪链接，但移除所有宏的值，包括设备 ID。所有宏都应留空，如下例所示：
    • https://singularassist.sng.link/D59c0/tpa9?_smtype=3&aifa=
&idfa=&cl=&pcid=&pcn=&pshid=&psn=&psid=&pcrid=&pcrn=
  3. 发送并测试链接：
    • 将修改后的跟踪链接发送到您的移动测试设备。
    • 在设备上点击该链接，然后按照上一个测试中的相同步骤验证结果。 

按照这些步骤操作，您就可以针对无法获取广告 ID 的渠道，使用概率性归因方法测试归因流程。

 

重要提示：

  • 链接中的所有参数必须被赋予有效值或留空。
  • 如果链接中仍残留占位符（例如 {idfa} 或 {google_advertising_id}），测试可能失败，归因也不会成功。
  • 有关跟踪链接参数的更多详情，请参阅 跟踪链接参数 文档。
5

触发跟踪链接

  1. 将跟踪链接发送到您的测试设备。
  2. 在移动设备上点击并打开该链接。

点击链接后，系统会根据设备类型将您重定向到 Apple App Store 或 Google Play Store。
6

安装、打开并测试应用

  1. 下载并安装应用
    • 前往应用商店下载 Singular Device Assist 应用。
    • 在测试设备上安装该应用。
  2. 打开应用
    • 打开应用以触发 Singular 的归因流程。归因流程只有在应用被打开时才会开始。
  3. 触发安装后事件
    • 在应用内执行安装后操作，以测试这些事件的回传。
    • 使用 Singular 集成团队提供的测试链接和 Singular Device Assist 应用时，请使用应用内按钮触发测试事件：
      • Copy IDFA/GAID
      • Share IDFA/GAID
      • Start Testing.
    • 这些操作将通过测试回传发送测试事件。
  4. 回传中预期的事件名称：
    • iOS：
      • “copy IDFA” 和/或 “share IDFA”（测试事件）
      • “start Testing”（测试收入事件*）
    • Android：
      • “Copy GAID” 和/或 “Share GAID”（测试事件）
      • “Start Testing”（测试收入事件*）

*收入事件需要在回传中配置收入金额。请确保您的回传模板包含 {AMOUNT} 宏或 Singular 文档中的等效宏，以便在回传中接收收入值。 
7

验证归因

要确认该安装已被 Singular 正确归因：

  1. 将您的 AIFA（Android 广告 ID）或 IDFA（Identifier for Advertisers）提供给 Singular 集成工程师。
  2. Singular 工程师将审核数据并提供反馈，包括相关的测试日志。

该流程可确保归因配置的准确性。