测试通用广告系列设置

要求

在测试之前,请确保以下各项:

1.添加测试设备

在完成以下步骤之前,我们强烈建议将您的测试设备添加到您的分支机构帐户中。这使您能够反复测试安装应用程序而不会影响实际流量和归因。

2.创建一个Branch链接

请按照创建广告链接说明进行操作。

为确保您的广告链接模板本身可以正常进行测试,请在使用前确保创建的广告链接模板通过初始验证检查。

您的“Branch广告链接”看起来应类似于以下内容(但会因您选择的广告伙伴而异):

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.通过宏传递所需的链接数据

在您自己测试链接时(而不是您的广告合作伙伴已经将其用于实时广告系列),您将需要手动输入相关值以实现正确的归因和回发。

为了测试分支链接的路由和归因,您必须确保已提供
真实设备ID-适用于Android设备的AAID和适用于Apple设备的IDFA 。如果您没有从测试设备中提供设备ID,则Branch将使用时间点建模来进行概率归因。

📘

如何找到我的设备ID?

在此处了解如何查找您的Android和/或iOS设备ID。

使用上面的示例Branch广告链接,填写宏将产生以下链接:

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

有关Branch在回发中支持的宏的完整列表,请参见回发宏&函数

🚧

无数据传递

在链接中保留宏的形式(例如<IDFA> )将导致链接失效,因此将无法使用。您可以传递空值以使链接正常工作,但随后的回发会将空值返回给您的合作伙伴。

常见的广告链接状态场景

链接状态原因测试链接示例
客户端
可行填写了一个设备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对接(因为是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参数,但没有提供设备IDhttps://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广告链接和路由,请将广告链接通过电子邮件发送给自己。在设备上,打开电子邮件,然后点击链接(或嵌入该链接的广告)。如果您在办公室Wifi上测试,建议您关闭Wifi并使用LTE/移动网络,以确保我们获得设备的唯一指纹。

此点击将使您通过Branch系统重定向到相应的应用商店和/或下载应用的目的地。

打开应用程序,以便Branch捕获您的设备信息,并将install事件与click事件进行匹配。

🚧

解决链接格式问题

如果链接的格式不正确或缺少密钥标识符,则Branch无法完成适当的路由和归属。

有关可能的原因和解决方案,请参阅故障排除链接格式问题

5.检查Liveview中是否有相关数据

Liveview允许您通过包括高级筛选来验证和调试设置,该筛选允许您将范围限于特定事件(例如,点击,安装,购买)以及Webhook /回发记录。

事件的 Liveview

  1. 在左侧导航栏中,在Setup & Testing 下点击Liveview
  2. 默认情况下,Liveview 会加载 Events 对象。
  3. 使用左上角的过滤器,选择要查看的事件类型。这可以帮助您测试点击以及其带来的应用下载。
  4. 我们建议添加其他过滤器-设备ID和/或广告合作伙伴和/或广告系列名称-以帮助您更快地确定要测试的广告链接。
  5. 点击Update Session 查看新的筛选结果。

图像图像

Webhooks /回发的 Liveview

  1. 在左侧导航栏中,在Setup & Testing 下点击Liveview
  2. 点击Webhooks Record 选项卡以加载Webhook / Postbacks对象。
  3. 点击Add Filter 按钮,然后从下拉列表中选择Webhook Partner Key ,然后为伙伴插入相关值。
  4. 点击“列”按钮以将Webhook Response CodeWebhook Response Body 都添加为列。
  5. 点击Update Session 查看过滤的结果。

图像图像

验证时的注意事项

  • 检查是否填充了预期的宏以及response code。最重要的是,您需要验证是否已填充IDFA / AAID和Click ID。
  • 我们建议即使响应代码为200(成功),也要与广告合作伙伴验证事件。为此,向他们发送事件名称,webhook 请求URL,设备ID,时间戳,webhook reponsce code 和 webhook 响应正文。
  • 如果找不到所需的Webhook,建议您再测试几次广告链接以触发后续的Webhook /回发。

如何查找合作伙伴的Webhook Key

为了按伙伴过滤Webhook记录以验证回发是否正确触发,您需要找到伙伴的Webhook Key。

查找合作伙伴的Webhook Key:

  1. 在左侧导航中的Channels & Links下,点击Ads ,然后点击Partner Management
  2. 搜索相应的伙伴,然后点击以选中它。
  3. 选择合作伙伴后,您正在查看AdPartner Settings 页,请转到浏览器的URL窗口,您将在其中找到当前Branch仪表板页面的URL。
  4. 伙伴webhook密钥是/partner-management/ 之后的第一个参数,以a_开头;例如a_youappi

图像图像

3个月前更新


测试通用广告系列设置


建议的编辑仅限于API参考页

您只能建议对Markdown正文内容进行修改,而不能建议对API规范进行修改。