第三方应用商店跟踪
Adjust 可利用安卓的广播功能或通过 Adjust SDK 中设定的预定义跟踪链接,跟踪来自第三方应用商店的安装。了解如何配置您的应用。您可使用任一方法在 Adjust 控制面板报告中显示这些推广活动,并自动向任何第三方应用商店发送回传数据。下面介绍如何配置您的应用。
利用安卓 referrer 跟踪第三方安装
若要跟踪来自第三方应用商店的安装,您需要使用安卓的 install_referrer
intent。(Google 也使用该 intent 来通知 Adjust SDK 通过 Google Play 应用商店进行的应用安装)。如果第三方应用商店已正确配置此 intent,便会针对应用安装进行触发;请确保您的应用时刻注意该 intent。
Adjust 账户所有者
- 确保您的开发者已配置了 Adjust SDK 广播接收器,以便接收
INSTALL_REFERRER
intent - 授予第三方访问您控制面板的权限,以便他们创建跟踪链接,或您自己创建跟踪链接并分享给他们
配置了 INSTALL_REFERRER
广播接收器并向第三方应用商店提交了应用和跟踪链接后,Adjust 便会开始接收安装信息,并通过您的 Adjust 控制面板报告这些信息。Adjust 将根据 intent 中提供的来源和推广活动信息报告您的推广结构数据。
第三方商店
在从客户处收到必要的跟踪链接信息后,您便可以按照以下步骤,对您应用商店中的应用进行配置:
- 设置应用商店,以接收应用安装通知。有多种设置方式,您可以自主选择合适的方式。部分方式的示例:
- 订阅
INSTALL_REFERRER
的广播接收器 - 使用可以检测到安装的第三方应用
- 订阅
- 设置广播,即
INSTALL_REFERRER
intent 的广播(请参阅此处)
配置了 INSTALL_REFERRER
后,Adjust 便可接收安装信息,并通过 Adjust 控制面板报告这些信息。Adjust 还会向 referrer 内指定的任意终端发送推广渠道和推广活动信息回传(请参阅下方示例)。
必要参数和其他参数
通过 INSTALL_REFERRER
intent,您可以向 Adjust 传递关键信息,以便我们对归因数据进行适当分类。这些关键信息需要包括安装推广渠道 (adjust_store
) 和 Adjust 跟踪码。还可以包括最多三个子层级的推广活动信息(请参阅下方示例)。
针对第三方应用商店和渠道的重要说明
referrer=
后面的所有信息必须经过编码- referrer 中包括的所有回传 URL 必须经过_双重编码_
必要参数
参数 | 值 |
---|---|
utm_source | adjust_store |
adjust_tracker | Adjust 跟踪码,例如 abc123 注意:此示例中使用了最小长度的跟踪码。始终使用 Adjust 推广活动设置向导中显示的完整跟踪码。 |
推广活动参数
参数 | 值 |
---|---|
adjust_campaign | campaign_name |
adjust_adgroup | adgroup_name |
adjust_creative | creative_name |
回传参数
参数 |
---|
adjust_install_callback |
adjust_event_callback_123456 |
adjust_session_callback |
adjust_rejected_install_callback |
adjust_reattribution_callback |
referrer intent 示例
referrer=adjust_tracker%3Dabc123%26adjust_campaign%3DChristmasCamp59_ChristmasCampId330%26adjust_adgroup%3DAppId48399_SubID%26adjust_creative%3DCreative9383_SubId%26utm_source%3Dadjust_store&adjust_install_callback=www.3rdpartydomain.com%253Fsrc%253Dadjust%2526advertiserId%253D57638%2526password%253D4d13c4dc
注意:此 referrer intent 包括一个经过双重编码的回传
使用预定义跟踪链接跟踪第三方安装
首先,您需要在 Adjust 控制面板中创建跟踪链接。
操作说明
在 Adjust 控制面板中
- 导航到应用,点击您应用选项上的 ^ 符号
- 选择 跟踪链接
- 前往窗口底部,然后选择 NEW TRACKER(新建跟踪链接)
- 输入新 Adjust 跟踪链接的所需名称,然后选择 CREATE(创建)
- 检索商店自然跟踪链接的 Adjust 跟踪码,以提交给安卓开发者进行集成
开发者说明
Adjust 需要特定的 APK 版本来进行预安装应用的跟踪,该版本会自动将安装分配给预定义的跟踪链接(已直接写入 Adjust SDK)。
Adjust 开发了一个小型的 ruby 命令行,允许您使用自定义的预分配跟踪码快速生成重复的 APK。配置完成后,Adjust SDK 将使用预设跟踪码(Adjust 用此归因您的用户),回报所有首次打开应用的操作(安装)。
系统要求
- ruby
- apktool
- jarsigner
Adjust SDK 要求
- 安卓版本 4.11 或更高版本
流程概览
- 验证系统要求
- 识别 Adjust 控制面板中生成的商店自然跟踪链接
- 使用每个第三方安卓商店的设置,生成 adjust-config.yaml 配置文件 — 完整说明见此处。
- 运行商店和预安装跟踪链接工具
完成后,商店和预安装跟踪链接工具将为您的特定商店/平台生成一个 APK,其允许 Adjust 单独跟踪每个 APK 的应用安装。
为第三方安卓应用商店中生成的付费安装设置 Adjust 跟踪
您无需使用商店和预安装跟踪链接工具来跟踪第三方安卓应用商店生成的付费安装。相反,您可以使用标准 Adjust 跟踪链接。
测试集成
若要测试 Adjust 是否正确地跟踪合作伙伴版本的 APK,请按如下步骤操作:
- 使用满足以下条件的安卓设备进行测试:
- 没有安装您的应用
- 尚未被 Adjust 跟踪。要让 Adjust 将您的测试应用启动跟踪为安装,则须从 Adjust 系统中清除先前跟踪的所有应用活动。若要从后端删除设备的应用历史记录,请使用我们的清除设备 API。有关清除设备记录的说明,请参阅 Adjust 测试控制台页面的内容。
- 利用带硬编码的跟踪码下载合作伙伴 APK
- 打开应用
- 在 Adjust 控制面板中查找与硬编码跟踪码绑定的安装
注意:虽然所有 Adjust 跟踪都是实时记录的,但您的安装可能需要最多二十分钟才能显示在 Adjust 控制面板中。若要在同一设备上进行多项测试,则必须进行不同测试时清除设备记录。