测试 Universal Ads(全域广告归因)Campaign 设置
要求
在测试之前,请确保以下几点:
- The Branch SDK is implemented in your app.
- Default link behavior and attribution windows are configured.
- Universal Ads Partners are enabled.
1.添加测试设备
Before you complete the steps below, we highly recommend adding your test device to your Branch account. This enables you to repeatedly test installing your app without affecting real traffic and attribution.
2.创建一个 Branch Link
Please follow the Creating Ad Links instructions.
为确保您的 Ad Link 模板本身可以正常进行测试,请在使用前确保创建的 Ad Link 模板通过初始验证检查。
您的 Branch Ad Link 应与以下内容相似(但会因您选择的广告伙伴而异):
https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=<IDFA>&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
3.通过宏传递所需的链接数据
在您自己测试链接时(而不是您的广告合作伙伴已经将其用于实时 campaign),您将需要手动输入相关值以实现正确的归因和回传。
为了测试 Branch Link 的路由和归因,您必须确保已提供
真实设备 ID — 适用于 Android 设备的 AAID 和适用于 Apple 设备的 IDFA 。如果您没有从测试设备中提供设备 ID,则 Branch 将使用时间点建模来进行概率归因。
如何找到我的设备 ID?
Learn how to find your Android and/or iOS device IDs here.
使用上面的示例 Branch Ad Link,填写宏将产生以下链接:
https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=38400000-8cf0-11bd-b23e-10b96e40000d&%24idfa=00000000-0000-0000-0000-000000000000&trackertoken=1234&ya_reen_id=2345&~campaign=my_test_campaign&~campaign_id=9876&~click_id=1111&~secondary_publisher=45678
For a complete list of the macros that Branch supports in postbacks, please see Postback Macros & Functions.
无数据传递
Leaving the macros in the link - e.g.
<IDFA>
- will result in broken links and therefore will not work. You can pass in empty values for the link to work, but the subsequent postbacks will return empty values to your partner.
常见的广告链接状态场景
链接状态 | 原因 | 测试链接示例 |
---|---|---|
客户端 | ||
有效 | 填写了一个设备 ID,其他的宏留为空白 | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid> |
有效 | 不是 S2S,同时指定 AAID & IDFA(从客户端获得操作系统信息) | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=38400000-8cf0-11bd-b23e-10b96e40000d&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=%3Ctrackertoken%3E&ya_reen_id=%3Cya_reen_id%3E&~campaign=%3Ccampaignname%3E&~campaign_id=%3Ccampaignid%3E&~click_id=%3Cparams%3E&~secondary_publisher=%3Cpublisherid%3E
|
无效 | 直接从用户界面点击原始链接(未传递设备 ID) | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=<IDFA>&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
|
无效 | 保留两个设备 ID 宏,而不填写它们 | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=<IDFA>&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
|
无效 | 填写了一个设备 ID,将另一个保留为宏 | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
|
服务器到服务器($s2s = true) | ||
有效 | 具有设备 ID 的 S2S(因为是服务器间,默认不会重定向) | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=%3Ctrackertoken%3E&ya_reen_id=%3Cya_reen_id%3E&~campaign=%3Ccampaignname%3E&~campaign_id=%3Ccampaignid%3E&~click_id=%3Cparams%3E&~secondary_publisher=%3Cpublisherid%3E&$s2s=true
|
无效 | 直接从用户界面点击原始链接 | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=<ANDROID_ID>&%24idfa=<IDFA>&trackertoken=<trackertoken>&ya_reen_id=<ya_reen_id>&~campaign=<campaignname>&~campaign_id=<campaignid>&~click_id=<params>&~secondary_publisher=<publisherid>
|
无效 | 具有 $S2S 参数,但没有提供设备 ID | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=&%24idfa=&trackertoken=%3Ctrackertoken%3E&ya_reen_id=%3Cya_reen_id%3E&~campaign=%3Ccampaignname%3E&~campaign_id=%3Ccampaignid%3E&~click_id=%3Cparams%3E&~secondary_publisher=%3Cpublisherid%3E&$s2s=true
|
无效 | S2S,同时指定了 AAID & IDFA(无法推断出操作系统信息) | https://branchster.app.link/Y2E3bNSaCX?%243p=a_youappi&%24aaid=38400000-8cf0-11bd-b23e-10b96e40000d&%24idfa=6D92078A-8246-4BA4-AE5B-76104861E7DC&trackertoken=%3Ctrackertoken%3E&ya_reen_id=%3Cya_reen_id%3E&~campaign=%3Ccampaignname%3E&~campaign_id=%3Ccampaignid%3E&~click_id=%3Cparams%3E&~secondary_publisher=%3Cpublisherid%3E&$s2s=true
|
4.执行点击&下载应用
要测试 Branch Ad Link 和路由,请将 Ad Link 通过电子邮件发送给自己。在设备上,打开电子邮件,然后点击链接(或嵌入该链接的广告)。如果您在办公室 Wifi 环境下测试,建议您关闭 Wifi 并使用 LTE/移动网络,以确保我们获得设备的唯一指纹。
此点击将使您通过 Branch 系统重定向到相应的应用商店和/或能够下载应用的目的地。
打开应用,以便 Branch 捕获您的设备信息,并将 install 事件与 click 事件进行匹配。
排查链接格式问题
如果链接的格式不正确或缺少 key 标识符,则 Branch 无法完成适当的路由和归因。
Please see Troubleshooting Link Formatting Issues for possible causes and solutions.
5.检查 Liveview 中是否有相关数据
Liveview 可使您通过包含高级筛选来验证和调试设置,该筛选允许您将范围限于特定事件(例如,click,install,purchase)以及 Webhook /回传记录。
事件的 Liveview
- 在左侧导航栏中,在 Setup & Testing 项下点击Liveview。
- 默认情况下,Liveview 会加载 Events 对象。
- 使用左上角的筛选器,选择要查看的事件类型。这可以帮助您测试点击以及其带来的应用下载。
- 我们建议添加其他筛选器—设备 ID 和/或广告合作伙伴和/或 campaign 名称—以帮助您更快地确定要测试的 Ad Link。
- 点击 Update Session 查看新的筛选结果。
Webhooks /回传的 Liveview
- 在左侧导航栏中,在 Setup & Testing 项下点击Liveview。
- 点击 Webhooks Record 选项卡以加载 Webhook / Postbacks 对象。
- 点击 Add Filter 按钮,然后从下拉列表中选择 Webhook Partner Key,然后为合作伙伴插入相关值。
- 点击列(columns)按钮以将 Webhook Response Code 和 Webhook Response Body 都添加为列。
- 点击 Update Session 查看筛选结果。
验证时注意事项
- 检查是否填充了预期的宏以及响应代码。最重要的是,您需要验证是否填充了 IDFA / AAID 和 Click ID。
- 我们建议即使响应代码为200 (successful),也要与广告合作伙伴验证事件。为此,请向他们发送事件名称,webhook 请求 URL,设备 ID,时间戳,webhook 响应代码和 webhook 响应体。
- 如果找不到所需的 Webhook,建议您再测试几次广告链接以触发后续的 Webhook/回传。
如何查找合作伙伴的 Webhook Key
为了按照合作伙伴筛选 Webhook 记录以验证回传是否正确触发,您需要找到合作伙伴的 Webhook key。
要查找合作伙伴的 Webhook Key,您需要:
- 在左侧导航中的 Channels & Links 项下,点击 Ads,然后点击 Partner Management。
- 搜索相应的合作伙伴,然后点击以选中它。
- 一旦选择合作伙伴,并且您正在查看 AdPartner Settings 页面,请转到浏览器的 URL 窗口,您将在其中找到当前 Branch 操作后台 (Dashboard)页面的 URL。
- The partner webhook key is the first parameter after
/partner-management/
and begins witha_
; e.g.a_youappi
。
Updated 2 months ago