实时回传
通过 Adjust 实时回传,您可以在 Adjust 跟踪事件后几秒钟后直接向您的服务器发送广告 ID、归因详情和应用程序数据。
Adjust 支持回传以下数据:
展示
点击
安装
会话
应用事件
再归因
归因更新
广告支出
(Business Pro 及更高级别的套餐计划)广告收入
(广告收入套餐)卸载
、重装
和再归因重装
(卸载和重装跟踪)
我们可以在每个事件级别发送回传。使用我们的基本设置说明设置单个事件的回传,或接收 Adjust 跟踪的每个事件的相同数据点。完成后,请转到高级设置说明,以接收自定义数据并筛选回传。请使用此链接分享下方视频。
操作前须知
以下是您在操作前需要了解的内容。
要求
- 您必须有接收 GET 请求的商业智能解决方案或数据仓库。(确认您的服务器能够接收您的所有参数并存储所有传入数据 — 服务器的速度要求与您的应用用户数量有关。如果您要跟踪注册等一次性事件,则您会针对每个转化用户收到一次回传。转化事件回传通常不会对服务器带宽产生重大影响。)
实用信息
- 为确保您只从 Adjust 接收数据,请将我们的服务器 IP 加入白名单
- 某些合作伙伴仅通过 HTTPS 共享推广活动信息。我们建议所有回传 URL 均使用
https://
。 - 有关如何构建回传 URL 的说明,请参阅我们的回传最佳实践。
- 我们最多可以转发 1MB 的回传
基本设置
设置全局回传
全局回传是涵盖 Adjust 跟踪的每个活动(例如点击、安装、会话等)的主回传。这是获得 Adjust 所跟踪所有单个事件的相同数据点的最快速、最简单的方法。
要设置全局回传,请按以下步骤操作。
- 查找应用并选择应用选项插入符号 (^)
- 选择 所有设置 > 原始数据导出 > 实时回传
- 选择添加全局回传
- 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符)
- 选择更新
太棒了!现在您可以接收 Adjust 跟踪的每个事件的原始用户数据了。
注意: 多触点活动仅在单个事件回传(而非全局回传)中可用。
设置单个事件回传
单个事件回传是针对一个特定活动(例如点击)的回传。如果您只需要某些特定事件的数据,或您不具备接收全局回传数据的能力时,单个事件回传便是理想选项。
要设置单个事件回传,请按以下步骤操作。
- 查找应用并选择应用选项插入符号 (^)
- 选择 所有设置 > 原始数据导出 > 实时回传
- 找到您希望接收回传的事件,然后选择编辑(铅笔图标)
- 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符)
- 选择更新
完成!现在您可以接收该事件的原始用户数据了。
注意: 如果您同时设置了全局回传和单个事件回传,则您会收到该事件的两个回传,每个终端各收到一个。
为同一个事件设置多个回传
Adjust 可以将单个事件回传发送到您希望的任意数量的终端,只需使用一个空格分隔每个 URL 即可。
要针对同一事件设置多个回传,请按以下步骤操作。
- 查找应用并选择应用选项插入符号 (^)
- 选择所有设置 > 原始数据导出 > 实时回传
- 找到您希望接收回传的事件,然后选择编辑(铅笔图标)
- 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符)
- 使用键盘上的空格键创建空格
- 输入您的第二个回传 URL
- 重复此步骤输入所有回传 URL
- 选择更新
设置完成!现在您的所有终端都可以接收同一个事件回传了。
高级设置
在回传中接收自定义数据
自定义安装、会话和再归因数据
会话回传参数支持您在接收安装、会话和再归因回传的同时接收自定义用户信息,如用户名、产品 ID 和交易数量。由于 Adjust 在会话期间跟踪所有应用程序事件,这些自定义数据也会出现在您的事件回传中。
首先,使用我们的开发者指南将会话回传参数添加至 Adjust SDK。
注意: 如果事件和会话使用了同一个参数名(键名),则事件值优先于会话值。例如,如果事件值为 foo=25
,会话值为 foo=10
,则您的事件回传将包括 foo=25
。
自定义事件数据
事件回传参数使您可以接收来自 Adjust 的自定义事件数据。要开始使用,请按以下说明设置事件跟踪。
使用 Adjust SDK
使用我们的开发者指南将事件回传参数添加至 Adjust SDK。Adjust 会在跟踪事件时自动将这些自定义值写入到您的回传 URL 上,因此您无需在控制面板上在回传 URL 中加入事件回传参数。
从服务器到服务器 (S2S)
通过 callback_params
参数将回传参数作为 JSON 对象(适当转义)进行传递。在如下示例中,附加了包含两个自定义参数 ({{"f0o":"bar","bar":"baz"}}
) 的 JSON 对象:
https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D
JSON 对象只应包含字符串,不得进行嵌套。如果该参数的格式不正确,您将收到 Adjust 的报错。
过滤回传
只想在特定情况下接收回传?您可以使用条件回传根据设备类型、Adjust SDK 环境设置及其他条件来过滤回传。
首先,使用前缀定义您的条件:
equal
(仅发送带有这些值的回传)notequal
( 不 发送带有此值的回传)contained
(只发送带有这些值中的一个或多个的回传)notcontained
(不 发送带有这些值的回传)
下一步,使用以下格式构建条件:前缀,{占位符}*,值,回传 URL
。您可以将任意数量的占位符设置为条件。
*请参阅 Adjust 占位符完整列表
实用信息
notequal
仅针对一个值。如果要排除多个值,请使用notcontained
。- 对于包含多个单词的值,请使用
+
而非空格(如my campaign
应变成my+campaign
) - 要筛选出与多个跟踪链接有关的事件,请使用
contained
(或使用notcontained
来从多个来源排除活动)
条件示例 | 结果 |
equal,{environment},sandbox,http://test.your-server.com?source={tracker_name} | 将在 Sandbox 环境下跟踪的活动发送至测试服务器 |
equal,{environment}{device_type},sandboxtablet,http://test.your-server.com?source={tracker_name} | 将在 Sandbox 环境下在平板电脑上跟踪的活动发送至测试服务器 |
contained,{event},abc123;xyz456,http://production.your-server.com?source={tracker_name} | 将以识别码 abc123 或 xyz456 跟踪的事件发送至生产服务器 |
notcontained,{network_name},Organic;Facebook+Installs,http://production.your-server.com?source={tracker_name} | 将未包含渠道名称 Facebook Installs 或 Organic (自然量) 的跟踪事件发送至生产服务器 |
回传常见问题
回传字符串是什么?
回传字符串是一个包含以下内容的 URL:
- 服务器终端(域名和路径)
- 附加参数(密钥)
- Adjust 占位符(值)
Adjust 占位符是一种宏,其支持 Adjust 将用户或交互数据动态添加到回传字符串中。例如,Adjust 的 network
占位符可让您在回传中接收渠道信息。
您可以根据需要将任意数量的参数和占位符添加至您的回传字符串,每组键值对之间使用&
符号分隔即可。我们建议在文本编辑器(如 TextEdit、Sublime)中编辑回传 URL,然后将最终字符串粘贴到 Adjust 控制面板中。
回传字符串示例:
https://mydatawarehouse.com/adjust/info?client_name={app_name}&iOS_device={idfa}&source={network_name}&campaign={campaign_name}
什么是更新的归因回传或再归因回传?
有时,Adjust 会在已经归因了某个用户 之后 获得新的归因数据。(这很少见,但接收安装数据并认领自身安装的自归因渠道有时会出现这种情况。)这种情况下,我们会在您的控制面板中更新用户归因信息。我们也可以另外发送带有已更新归因或再归因数据的回传。
若要接收更新的归因信息,请将这些 Adjust 占位符添加至回传字符串:
{outdated_tracker}
:用户最初归因的跟踪码{outdated_tracker_name}
:用户最初归因的跟踪链接名称{attribution_updated_at}
:修订后的归因时间戳{activity_kind}
:install_update
或reattribution_update
注意: Adjust 自 2017 年 3 月起提供更新的归因信息和再归因信息。
Adjust 回传失败时会发生什么?
如果您的服务器终端不可用或返回了代码 500 的响应信息,我们会尝试在未来 24 小时内重新发送回传,最多发送六次。如果我们接收到代码 400 响应,我们会立即通知您并不再重试回传。
为了保护数据安全性,我们的回传服务器会记录您终端的 HTTP 响应,并且不会跟踪任何重定向。如果您的服务器出现故障,而您又需要历史用户数据,我们将始终尽最大努力回溯这些数据。
安装回传与被拒安装回传之间有什么区别?
Adjust 会在用户首次会话后发送安装回传。如果我们的防作弊套件拒绝了某一安装,我们会发送被拒安装回传。