🚧

Universal Ads（全域广告归因）集成指南

Please refer to our Universal Ads Basics guide before using any the advanced options below.

设置

带有展示像素的浏览归因（View-Through Attribution, VTA）

通过浏览归因，即使从未点击过广告，您也可以追踪安装，会话启动和转化事件，以追溯到广告展示。

当前，对于任何给定事件，我们的浏览归因逻辑如下：

• 如果在有效的归因窗口内发生点击，则应归因于点击。
• 如果在有效归因窗口内没有点击发生，则应归因于有效归因窗口内的最后一次展示。

To create an impression tracking link for non-SAN networks, simply create an ad link, and grab the impression link from the final step of link creation. SAN networks support VTA without any additional links.

使用 setDebug 测试

集成 SDK 时，使用 setDebug 来验证您的应用能够与 Branch 服务器通信并能够接收深度链接数据。但是，我们的上游系统不会注册使用 setDebug 发送的 test 事件，因此事件不会出现在 Liveview 或 Analytics（分析）中，也不会触发回传。查看 Liveview 或测试回传时，应禁用 setDebug。

服务器间广告链接

如果您有服务器间集成，则必须提供归因的特定要求。请确保将以下必填 key-value 附加到追踪广告链接中，以确保它们不会被拒绝或阻止：

• Server to Server Parameter: 在链接末尾添加服务器间 (server-to-server) click macro URL 参数，以便我们能够知道这是服务器间链接 ：

  • %24s2s=true

• Device ID Macro Value: 通过 click macro URL 参数传递用户广告标识符：

  • %24idfa={IDFA} 适用于 iOS 设备
  • %24aaid={AAID} 适用于 Android 设备

🚧

对于来自 Tune 的客户

请使用以下宏作为广告标识符：

• ios_ifa={IDFA}
• google_aid={AAID}

• IP address: 在 header 中传递用户 IP 信息，或点击宏 URL 参数以覆盖点击：

  • HTTP header x-ip-override: {IP_ADDRESS}
  • 点击宏 URL 参数： device_ip={IP_ADDRESS}

• User Agent: 在 header 中传递用户代理信息，或点击宏 URL 参数以覆盖点击：

  • HTTP header User-Agent: {USER_AGENT}
  • 点击宏 URL 参数： user_agent={USER_AGENT}

🚧

更新特定于合作伙伴的 URL 宏

请确保您使用的宏不是 {IDFA}。 {AAID}，{IP_ADDRESS}，{USER_AGENT}

添加/启用更多回传

启用广告合作伙伴后，系统会针对 Install ，Purchase 等事件自动激活基本回传。然后，您可以添加额外的回传，例如，您想为特定于应用的自定义事件（如 Account Created）添加回传。

要添加回传，您需要：

1. 在Partner Management，选择要为其添加/编辑回传的合作伙伴。
2. 点击该合作伙伴页面上的Postback Config标签。
3. 点击屏幕底部的Add New Postback按钮。
4. 弹窗将与 Branch 默认事件以及设置的任何 commerce 事件（预留事件，如 PURCHASE）或自定义事件一起出现。选择一个事件，如被要求，请输入回传 URL，然后点击Save。这将是触发新回传的事件。
   1. 注意：如果 Branch 尚没有合作伙伴的回传模板，请为您的合作伙伴提供有效的 URL。

发送所有事件

如果要发送All Events（无论是否归因于该合作伙伴），您则可以通过在每个回传上选中 All Events 框来启用此设置。

🚧

隐私提示

由于此设置将发送All Events （包括此行所列出的名称和客户事件别名，无论是否归因于此合作伙伴），因此建议您在启用时要特别谨慎，尤其是在已启用代理商访问帐户的情况下。

编辑模板

在大多数情况下，从您的选择生成的默认回传 URL 足以向有关各方提供回传通知。

但是有时您可能需要/想要编辑回传 URL 中的参数或从中删除参数，或者附加宏表达式/变量以包含额外信息。

👍

例如

You want to send your partner the actual items a user adds to their cart so they can optimize based off those items. Their current Add to Cart postback template does not include this information. Therefore, you need to add Content Items macros to their URL. To do so, you’ll first need to get the correct field from the partner in which to pass this data; e.g. cart_items. Finally, you’d append &cart_item=${(content_items[0].$product_name)!} to the postback template.

Please refer to Postback Macros & Functions when looking to append additional macros.

要编辑回传模板，您需要：

1. 在Partner Management，选择要为其添加/编辑回传的合作伙伴。
2. 点击该合作伙伴页面上的Postback Config标签。
3. 在Postback URL字段中，添加/编辑/删除必要的 key-values pairs。
   1. You must include a & before each key-value pairs you append.
4. 点击 Save。
5. 或者，将鼠标悬停在回传右侧的三个点图标上，然后点击 Advanced Edit。
6. 在Send a Webhook to字段中，添加/编辑/删除必要的 key-values pairs。
   1. You must include a & before each key-value pairs you append.
7. 点击 Save。

👍

重置回传

我们偶尔都会犯错。如果您需要重置回传和凭据，请前往 Account Settings 选项卡并查找 Reset all settings 按钮。不过请当心！这将禁用广告合作伙伴，清除所有已设置凭据和回传，并将广告合作伙伴恢复到其基本配置。然后，您可以重新开始。

授予代理商访问权限

授予广告合作伙伴访问权限

To grant an Ad Partner access to your App's data, you need to add them as an agency in your Branch account. Doing so gives said ad partner access to your app; based on the permissions you define.

1. 转到 Account Settings ，然后点击 Agencies 选项卡。
2. 在 Agencies 选项卡上，点击 Add New Agency 键。
3. 在 Add New Agency 弹窗中：
   1. 从下拉列表中选择代理名称。
   2. 选择适当的访问级别。
      • Admin - 可编辑对所有设置的访问权限，并导出对所有数据的访问权限。
      • Team Member - 可编辑对渠道和链接的访问权限，对应用设置的只读访问权限以及对聚合数据的访问权限。
      • Full Read - 以只读方式访问所有设置以及访问聚合数据。
      • Limited Read - 仅访问聚合数据。
      • Custom - 自定义设置和数据访问。
      • No Access - 不可访问操作后台 (Dashboard)。
   3. 点击 "Invite" 。
   4. 代理帐户上的所有代理管理员都将收到邀请电子邮件，并且任何这些代理管理员都可以代表自己的代理接受邀请。

🚧

授予代理敏感数据&应用级设置权限

Agencies with Sensitive Data & App-Level Settings permissions to an Org or App will have access to that Org/App's API keys, which can be used to access Branch's HTTP and Data Export APIs. Agency data filters (e.g. Only Show Agency-tagged Data) will not apply to data accessed via the Daily Export API, so we recommend against granting agencies these permissions and providing them with API keys.

定义权限

每个访问级别（如上定义）都带有预定义的权限，您可以根据需要进行编辑。

👍

修改权限

如果要修改预定义的访问级别，请点击铅笔图标以（取消）选择可用的选项。

• Link-level Settings - 可影响单个链接功能的设置。
• Channel-level Settings - 可影响整个营销渠道功能的设置。
• App-level Settings - 可影响整个应用范围功能的设置。
• Aggregate Data - 聚合数据，不包含任何粒化数据。
• Sensitive Data - 可以包含用户识别，支付相关或机密信息的数据。

附加数据筛选

在为代理商授予对 Branch 帐户的访问权限的过程中，您还可以限制代理商在任何给定时间可用的数据。

🚧

筛选以仅显示来自特定广告平台的数据

在授予广告合作伙伴访问您的 Branch 帐户的权限时，请确保将 Only Show Data from Specific Ad Networks 切换为开启，然后选择您有权访问的广告合作伙伴。

• Only Show Agency-tagged Data - 启用后，代理用户只能看到标有代理 ID 的事件。
• Restrict Access to Revenue Data - 启用后，代理用户无法查看收入数据。
• Only Show Data from Specific Ad Networks - 启用后，代理机构用户只能查看来自特定广告平台列表的事件。
• Only Show Data from Specific Locations - 启用后，代理用户只能查看在特定国家/地区列表中发生的事件。

🚧

代理邀请

为您的代理定义适当的访问级别后，您必须 Invite 代理进行访问才能访问 Branch 操作后台 (Dashboard)。只有组织管理员可以邀请代理商访问 Branch 操作后台 (Dashboard)。

追踪链接参数

Branch 追踪链接允许追踪有关广告 campaign 和单个广告效果的许多参数。您可以在 Link Parameters 标签下看到每个合作伙伴的特定链接参数：

可以在“?”或“&”字符之后添加用于高级分析的附加参数，以追踪其他信息。

👍

带有附加参数的示例追踪链接

示例 Branch Link 包括传递代理商和子发行商信息的额外参数：https://tracking.app.link?$3p=a_partner&~agency_id=1234&~agency=myAgency&~secondary_publisher=best_publisher

在预生成的追踪链接中可以使用以下参数：

Campaign 信息

设备信息

支出计算

📘

Cost 数据可用性

通过这些宏传递的 cost 数据在导出（Exports）中可用，但在 Branch 操作后台 (Dashboard)中不可见。

归因窗口

更改归因窗口

归因窗口可在全局帐户级别或在每个链接的基础上指定，它以链接级别窗口为准。请参阅以下说明进行设置。

为了改善客户体验并提高数据准确性，请不要将深度链接窗口的时间设置得比其他归因窗口长。

帐户级别归因窗口

您可以在 Link Settings > Attribution Windows 窗口项下编辑归因窗口。

Learn more about account level attribution windows in People-Based Attribution.

广告平台归因窗口

You can edit your attribution windows at the ad network level if your ad network requires it. This is recommended when you enable networks like Facebook and Google, which may have different windows for installs. With this, you can preserve your Account Level Attribution Windows, as well.

链接级别归因窗口

要在链接级别上设置归因窗口，您可以将以下参数附加到生成的 Branch Link 中。

🚧

标准Branch链接的链接级别归因支持

自2017年7月起，链接级别归因窗口设置仅适用于标准 Branch Link。当前不支持如用于 Google 的 Universal App Campaign 或具有 Branch Link ID 参数的 Play Store 链接的特殊 Branch Link。

查看您的数据

The Ads Analytics Page on the Branch dashboard shows the performance of your ad campaigns across both web and app. You can view performance over time, including purchase and other custom events.

事件通过 Branch 统一的最后点击归因模型进行归因。这意味着 Branch 将事件归因于跨渠道、跨平台的最后点击。

For example, if a customer clicks a Branch email link, and then clicks an ad, installs the app and purchases an item, Branch will attribute the install and the purchase to the last clicked ad link.

如果客户随后继续在归因窗口内进行网上购物，则 Branch 还将网上购物归因于相同的广告链接，将单个用户执行的网络和应用操作联系起来，以更准确地查看您的营销渠道和客户行为。

You can read more about Branch's Attribution logic here.