实时回传

回传(也称回调)是在一个服务器与另一服务器终端之间执行的 ping 命令。Adjust 使用实时回传将广告 ID、归因详情乃至应用内数据直接发送到您的服务器。Adjust 可以为 Adjust 跟踪的以下任何事件发送回传: 

  • impressions
  • clicks
  • installs
  • sessions
  • 自定义应用内事件
  • reattributions
  • 卸载*
  • 重装*
  • 再归因重装*
  • 归因更新
  • 广告支出**

*只有当您购买了我们的卸载与重装跟踪套餐后,才提供此项服务。请发送电子邮件至 sales@adjust.com,了解更多信息。
**仅 Business Pro 及以上套餐计划才提供此项服务。

在 Adjust 中,您可以在每个事件级别设置回传。这方便您区分出特定的应用内事件,并为每个事件分别定义单独的数据集。使用我们的基本设置说明为指定数量的 Adjust 跟踪事件设置回传或为 Adjust 跟踪的每个事件接收相同的数据集。完成后,请转到高级设置说明,以接收自定义数据并筛选回传。

操作前须知

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

要求

  • 您需要可接收 GET 请求的有效终端(如商业智能解决方案或数据仓库) , 否则,我们建议考虑将 Adjust 与 Amazon S3 集成
  • 您必须在创建回传字符串前将 Adjust 服务器 IP 加入白名单,以确保只有 Adjust 数据到达您的服务器
实用信息
  • 以下操作说明介绍了如何在控制面板中设置回传。有关如何构建回传 URL 的说明,请参阅我们的回传最佳实践
  • Adjust 无法转发大于 1 MB 的回传

基本设置

设置单个事件回传

在 Adjust 控制面板中
  1. 导航到应用,点击您应用选项上的 ^ 符号
  2. 选择所有设置>(数据管理)原始数据导出 > 实时回传
  3. 此时,您会看到 Adjust 中跟踪的所有事件列表,表格中包含所有自动跟踪的事件以及您的自定义应用内事件。
  4. 选定要回传的事件,然后选择编辑(铅笔)图标
  5. 将您的回传 URL 插入回传 URL字段(查看回传 URL 模板和推荐的占位符) 
  6. 配置好回传后,便可选择 更新
完成后,Adjust 将实时向您的服务器终端传送用户数据。

设置全局回传

全局回传 (global callbacks) 是主回传 (master callback) 的一种,可针对 Adjust 跟踪的每个事件进行设置。使用全局回传,您可确保 Adjust 跟踪的每个事件都接收到相同的数据点。除了您指定的任何其他回传外,系统还可触发全局回传。因此,如果您在事件级别的回传之外,还设置了全局回传,则 Adjust 会触发两个回传:一个包含全局回传中请求的数据,一个包含事件级别回传请求的数据。

在 Adjust 控制面板中
  1. 导航到应用,点击您应用选项上的 ^ 符号
  2. 选择所有设置>(数据管理)原始数据导出 > 实时回传
  3. 此时,您会看到 Adjust 中跟踪的所有事件列表,表格中包含所有自动跟踪的事件以及您的自定义应用内事件。
  4. 选择添加全局回传
  5. 将您的回传 URL 插入回传 URL 字段(查看回传 URL 模板和推荐的占位符) 
  6. 配置好回传后,便可选择 更新
如果使用的是全局回传,我们建议您将以下 Adjust 占位符纳入您的回传字符串:
  • {activity_kind}——此占位符方便您决定事件类别:展示、点击、安装、被拒安装(仅适用于防作弊套件)、会话、再归因、卸载、重装、再归因重装、归因更新、应用内事件或广告支出 (cost_updated)
  • {event}——此占位符方便您在事件识别码级别,辨别不同的应用内事件
  • {event_name} 此占位符帮助您根据写入 Adjust 控制面板中的事件名称,辨別不同的应用内事件*
*注意:由于您可在 Adjust 控制面板中修改事件名称,{event_name} 占位符只应作为名称展示之用。相反的是,事件识别码却具有永久性,始终可以在报告中作为常数标识符来引用。

高级设置

为安装、会话以及再归因接收自定义数据

通过设置回传参数,我们可以利用事件回传或会话回传,将自定义用户信息发送至您的服务器——包括安装和再归因。您可以通过这些回传获得高度客制化的信息,利用它们提取个别特定应用内活动的详细信息,例如用户名、产品 ID 或交易号。

会话回传参数属于自定义数据点,其特定于个别应用,并且会随每个安装(首次会话)、应用内会话以及再归因的回传字符串发送。会话回传参数可用于从您的应用中提取用户 ID、电子邮件地址或生日等独特用户信息。

所有会话回传参数都必须编码到 Adjust SDK 中(请参阅我们的开发者说明)。

待会话回传参数集成到 Adjust SDK 中后,Adjust 会自动传输您安装、会话或再归因回传字符串中的会话回传数据。

请注意:由于所有应用内事件都是在应用内会话期间进行跟踪,Adjust 也会通过应用内事件回传,来自动发送会话回传信息。如果事件和会话使用了相同的参数名称(键名),则事件值将始终取代会话值。示例如下:
  • 会话:foo=10
  • 事件:foo=25
事件回传将包含 foo=25

为应用内事件接收自定义数据点

我们能使用 Adjust SDK 或通过服务器到服务器 (S2S) 集成,来为您跟踪应用内事件。请按照当前 Adjust 集成对应的说明进行操作。
使用 Adjust SDK 跟踪的应用内事件

如果使用 Adjust SDK 跟踪应用内事件,则所有事件回传参数都必须编码到 Adjust SDK 中(请参阅我们的开发者说明)。待事件回传参数集成到 Adjust SDK 中后,在跟踪事件时,我们的后端会自动将这些自定义值写入您的回传 URL。您无需在控制面板中,将事件回传参数纳入您的回传 URL 字符串內。

请注意,我们不会存储自定义事件数据。因此,如果不使用回传 URL,自定义数据便不会保存到或提交给您的服务器。

通过服务器到服务器 (S2S) 跟踪的应用内事件

如果使用服务器到服务器 (S2S) 集成跟踪事件,Adjust 仍然可以利用应用内事件来报告自定义数据点。

待 Adjust 收到您的事件信息后,在跟踪事件时,我们的后端会自动将这些自定义值写入您的回传 URL。您无需将事件回传参数纳入您的回传 URL 字符串內。

请注意,我们不会存储自定义事件数据。因此,如果不使用回传 URL,自定义数据便不会保存到或提交给您的服务器。

为同一个应用内事件设置多个回传

您可以为单个事件设置任意数量的回传,只需用一个空格分隔每个 URL 即可。说明如下:

  1. 导航到应用,点击您应用选项上的 ^ 符号
  2. 选择所有设置>(数据管理)原始数据导出 > 实时回传
  3. 此时,您会看到 Adjust 中跟踪的所有事件列表,表格中包含所有自动跟踪的事件以及您的自定义应用内事件。
  4. 选定要回传的事件,然后选择最右侧的编辑(铅笔)图标
  5. 将您的回传 URL 插入回传 URL 字段(查看回传 URL 模板和推荐的占位符) 
  6. 使用键盘上的空格键创建空格
  7. 将您的第二个回传 URL 插入回传 URL 字段中
  8. 根据需要重复此过程
  9. 完成设置后,选择更新

利用条件回传筛选要导出的数据

条件回传是指根据特定条件发送的任何回传,这表示只有在满足特定条件时才会触发回传。回传可以根据 Adjust SDK 的环境设置、设备类型等条件进行过滤。

决定要用于定义条件的前缀:
  • equal 决定回传将仅根据您所设置的条件触发
  • notequal 决定除了指定事件之外,将为所有事件触发回传
  • contained 决定如果满足一个或多个条件则会触发回传
  • notcontained 决定除了指定值之外,将为所有值触发回传
使用以下格式构建条件:前缀、{placeholder}*、值、回传 URL

*请参阅 Adjust 占位符完整列表

请注意
  • notequal 只能与一个值配合使用。如果要排除多个值,请使用 notcontained
  • 如果值包含多个词,则必须使用 + 进行转义:my campaign 应写为 my+campaign


equal 示例
​equal,{environment},sandbox,http://test.your-server.com?source={tracker_name}
此条件回传设置会将 Sandbox 环境下跟踪的活动发送到测试服务器。

您可以将任意数量的占位符设置为条件。

带字符串值的 equal 示例
equal,{environment}{device_type},sandboxtablet,http://test.your-server.com?source={tracker_name}
此条件回传设置会将 Sandbox 环境的平板电脑上跟踪的活动发送到测试服务器。

contained 可用于涵盖与多个特定跟踪链接有关的事件。

contained 示例:
contained,{event},abc123;xyz456,http://production.your-server.com?source={tracker_name}
此条件回传设置会将以识别码 abc123xyz456 跟踪的事件发送到生产服务器。

反之,notcontained 可用于从多个来源中排除活动。

notcontained 示例
notcontained,{network_name},Organic;Facebook+Installs,http://production.your-server.com?source={tracker_name}

此条件回传设置会将包含渠道名称 Facebook Installs 或 Organic 的所有跟踪活动发送到生产服务器。

回传常见问题

回传字符串是什么?

回传字符串是由服务器终端(域名和路径)、任何附加参数(密钥)和 Adjust 占位符(值)组成的 URL。Adjust 占位符是一种宏,其支持 Adjust 在回传字符串中动态提供 Adjust 跟踪的用户或交互数据。您可以在回传字符串中使用来自我们 Adjust 可用占位符完整列表中的任何占位符。回传字符串中的参数集完全可以进行自定义,并且其对指定服务器终端的规范具备唯一性。您可以根据需要添加任意数量的键值对,每组之间使用 符号分隔即可。​

示例:
https://mydatawarehouse.com/adjust/info?client_name={app_name}&iOS_device={idfa}&source={network}&campaign={campaign_name}

专业建议:在首选文本编辑器中定义回传 URL 的结构,然后将最终 URL 插入 Adjust 控制面板中

您还可以通过在 Adjust SDK 中设置回传参数,将自定义应用数据纳入 Adjust 回传。所有回传参数都会自动附加到您的回传中,并且不需要添加到您的控制面板回传 URL。(iOS安卓的 SDK 说明)​​

Adjust 的条件回传可让您判定特定回传的确切触发时间。通过结合使用条件前缀、Adjust 占位符和值,您可以配置回传的触发条件,例如:仅当设备为平板电脑或活动源自特定跟踪链接时触发回传。

什么是“实时”?

实时意味着,当 Adjust 系统中跟踪到某事件,我们会立即检查注册到该事件的任何回传。一旦确定了请求回传后,我们就会在几秒钟内将数据发送给相关终端。

什么是更新的归因回传或再归因回传?

更新归因回传或更新再归因回传,是指安装后或再归因回传后,仅在用户归因数据发生变化时才传输的回传。

有时候,在 Adjust 初步判定归因或再归因,会从自归因渠道收到归因信息。在极少数情况下,如果用户的归因数据发生了变化,Adjust 则会在 Adjust 控制面板中更新用户的归因信息。出现这种情况时,Adjust 可以针对更新的归因发送包含已更新归因信息的回传。

如果希望收到更新的归因信息,我们建议您在回传字符串中纳入以下 Adjust 占位符:
  • {outdated_tracker}:用户最初归因的跟踪码
  • {outdated_tracker_name}:用户最初归因的跟踪链接名称
  • {attribution_updated_at}:修订后的归因时间戳
  • {activity_kind}install_update 或 reattribution_update
注意:
  • Adjust 自 2017 年 3 月起提供更新的归因信息和再归因信息
  • 更新的归因回传和再归因回传中,只包含归因信息和 Adjust 占位符数据

Adjust 回传失败时会发生什么?

  • 如果您的服务器终端不可用或出现代码 500 的响应信息,Adjust 会按照以下频率重发回传:10 秒/1 分/10 分/1 小时/5 小时/24 小时
  • 如果 Adjust 收到代码 400 的响应信息,我们不会重发回传,但会立即提醒您
为了维护数据安全性,Adjust 回传服务器会记录您终端的 HTTP 响应,并且不会跟踪任何重定向。如果您的服务器出现故障,而您又需要历史用户数据,我们将始终尽最大努力恢复这些数据。

回传与回调有什么区别?

回传 (callback):在触发特定事件时,由 Adjust 服务器向客户服务器执行的预定义 ping 命令。

回调 (postback):在触发特定事件时,由 Adjust 服务器向第三方服务器执行的预定义 ping 命令。

归根结底,回传与回调为同义词:两者都是发送到指定服务器终端的 HTTP GET 请求。然而,Adjust 利用这些术语区分客户和第三方(即,广告渠道或数据分析提供商)发出的 GET 请求。

如何估算存储 Adjust 回传数据所需的服务器容量?

在评估服务器所需速度以及传输的数据量时,我们建议您从应用中的用户数量方面着手。如果只是跟踪一次性事件(例如注册),那么回传的数量将直接与您的营销活动相关:每个转化用户对应一个回传。一般情况下,转化事件的回传不会对服务器带宽产生很大影响。

安装回传与被拒安装回传之间有什么区别?

安装回传是在用户首次会话时传输的回传。Adjust SDK 会自动跟踪安装。

被拒安装回传,系指所有经 Adjust 防作弊套件过滤之安装所传输的回传。安装可能因以下原因而被拒:匿名 IP、点击欺诈 (click spamming)、分布模型排查。

有关此主题

有关此主题