实时回传

通过 Adjust 实时回传,您可以在 Adjust 跟踪事件后几秒钟后直接向您的服务器发送广告 ID、归因详情和应用程序数据。

Adjust 支持回传以下数据: 

  • 展示
  • 点击
  • 安装
  • 会话
  • 应用事件
  • 再归因
  • 归因更新
  • ad spend (Business Pro and higher pricing plans)
  • 广告收入(广告收入套餐)
  • 卸载重装再归因重装(卸载和重装跟踪)

我们可以在每个事件级别发送回传。使用我们的基本设置说明设置单个事件的回传,或接收 Adjust 跟踪的每个事件的相同数据点。完成后,请转到高级设置说明,以接收自定义数据并筛选回传。请使用此链接分享下方视频。 

 

操作前须知

以下是您在操作前需要了解的内容。

要求

  • 您必须有接收 GET 请求的商业智能解决方案或数据仓库。(确认您的服务器能够接收您的所有参数并存储所有传入数据 — 服务器的速度要求与您的应用用户数量有关。如果您要跟踪注册等一次性事件,则您会针对每个转化用户收到一次回传。转化事件回传通常不会对服务器带宽产生重大影响。)
实用信息
  • 为确保您只从 Adjust 接收数据,请将我们的服务器 IP 加入白名单
  • 某些合作伙伴仅通过 HTTPS 共享推广活动信息。我们建议所有回传 URL 均使用 https:// 。
  • 有关如何构建回传 URL 的说明,请参阅我们的回传最佳实践
  • 我们最多可以转发 1MB 的回传

基本设置

设置全局回传

全局回传是涵盖 Adjust 跟踪的每个活动(例如点击、安装、会话等)的主回传。这是获得 Adjust 所跟踪所有单个事件的相同数据点的最快速、最简单的方法。

要设置全局回传,请按以下步骤操作。
  1. 查找应用并选择应用选项插入符号 (^)
  2. 选择 所有设置 > 原始数据导出 > 实时回传
  3. 选择添加全局回传
  4. 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符) 
  5. 选择更新
太棒了!现在您可以接收 Adjust 跟踪的每个事件的原始用户数据了。
 
用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像

1. 查找应用并选择应用选项插入符号 (^)

2a. 选择所有设置

2b.选择原始数据导出

2c. 选择实时回传

3. 选择添加全局回传

4. 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符

5. 选择更新



注意:多触点活动仅在单个事件回传(而非全局回传)中可用。

设置单个事件回传

单个事件回传是针对一个特定活动(例如点击)的回传。如果您只需要某些特定事件的数据,或您不具备接收全局回传数据的能力时,单个事件回传便是理想选项。

要设置单个事件回传,请按以下步骤操作。
  1. 查找应用并选择应用选项插入符号 (^)
  2. 选择 所有设置 > 原始数据导出 > 实时回传
  3. 找到您希望接收回传的事件,然后选择编辑(铅笔图标)
  4. 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符
  5. 选择更新
完成!现在您可以接收该事件的原始用户数据了。

 
用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像

1. 查找应用并选择应用选项插入符号 (^)

2a. 选择所有设置

2b.选择原始数据导出

2c. 选择实时回传

3. 找到您希望接收回传的事件,然后选择编辑(铅笔图标)

4. 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符

5. 选择更新



注意:如果您同时设置了全局回传和单个事件回传,则您会收到该事件的两个回传,每个终端各收到一个。

为同一个事件设置多个回传

Adjust 可以将单个事件回传发送到您希望的任意数量的终端,只需使用一个空格分隔每个 URL 即可。

要针对同一事件设置多个回传,请按以下步骤操作。

  1. 查找应用并选择应用选项插入符号 (^)
  2. 选择所有设置 > 原始数据导出 > 实时回传
  3. 找到您希望接收回传的事件,然后选择编辑(铅笔图标)
  4. 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符) 
  5. 使用键盘上的空格键创建空格
  6. 输入您的第二个回传 URL
  7. 重复此步骤输入所有回传 URL
  8. 选择更新
设置完成!现在您的所有终端都可以接收同一个事件回传了。
用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像 用户添加的图像

1. 查找应用并选择应用选项插入符号 (^)

2a. 选择所有设置

2b.选择原始数据导出

2c. 选择实时回传

3a. 找到您希望接收回传的事件

3b. 选择编辑(铅笔图标)

4. 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符

5. 使用键盘上的空格键创建空格

6. 输入您的第二个回传 URL。重复此步骤输入所有回传 URL。

7. 选择更新

高级设置

在回传中接收自定义数据

自定义安装、会话和再归因数据

会话回传参数支持您在接收安装、会话和再归因回传的同时接收自定义用户信息,如用户名、产品 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(只发送带有这些值中的一个或多个的回传)
  • notequal发送带有这些值的回传)
下一步,使用以下格式构建条件:前缀、{占位符}*、值、回传 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 会在用户首次会话后发送安装回传。如果我们的防作弊套件拒绝了某一安装,我们会发送被拒安装回传。

有关此主题

有关此主题