Languages 
  • English
  • 中文
  • 日本語

实时回传

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

Adjust 支持回传以下数据: 

  • 展示
  • 点击
  • 安装
  • 会话
  • 应用事件
  • 再归因
  • 归因更新
  • 广告支出 (Business Pro 及更高级别的套餐计划)
  • 广告收入(广告收入套餐)
  • 卸载重装再归因重装(卸载和重装跟踪)

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

 

操作前须知

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

要求

  • 您必须有接收 GET 请求的商业智能解决方案或数据仓库。(确认您的服务器能够接收您的所有参数并存储所有传入数据 — 服务器的速度要求与您的应用用户数量有关。如果您要跟踪注册等一次性事件,则您会针对每个转化用户收到一次回传。转化事件回传通常不会对服务器带宽产生重大影响。)

实用信息

  • 为确保您只从 Adjust 接收数据,请将我们的服务器 IP 加入白名单
  • 某些合作伙伴仅通过 HTTPS 共享推广活动信息。我们建议所有回传 URL 均使用 https:// 。
  • 有关如何构建回传 URL 的说明,请参阅我们的回传最佳实践
  • 我们最多可以转发 1MB 的回传

基本设置

设置全局回传

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

要设置全局回传,请按以下步骤操作。

  1. 查找应用并选择应用选项插入符号 (^)
  2. 选择 所有设置 > 原始数据导出 > 实时回传
  3. 选择添加全局回传
  4. 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符) 
  5. 选择更新

太棒了!现在您可以接收 Adjust 跟踪的每个事件的原始用户数据了。

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

1/7

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

设置单个事件回传

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

要设置单个事件回传,请按以下步骤操作。

  1. 查找应用并选择应用选项插入符号 (^)
  2. 选择 所有设置 > 原始数据导出 > 实时回传
  3. 找到您希望接收回传的事件,然后选择编辑(铅笔图标)
  4. 输入您的回传 URL(请参阅回传 URL 模板和推荐占位符
  5. 选择更新

完成!现在您可以接收该事件的原始用户数据了。

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

1/7

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

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

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

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

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

设置完成!现在您的所有终端都可以接收同一个事件回传了。

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

1/10

高级设置

在回传中接收自定义数据

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

会话回传参数支持您在接收安装、会话和再归因回传的同时接收自定义用户信息,如用户名、产品 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 会在用户首次会话后发送安装回传。如果我们的防作弊套件拒绝了某一安装,我们会发送被拒安装回传。