Languages ▼
  • English
  • 中文
  • 日本語
More ▼

实时回传

通过 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 会在用户首次会话后发送安装回传。如果我们的防作弊套件拒绝了某一安装，我们会发送被拒安装回传。