adjust-icon

服务器到服务器 (S2S) 事件

服务器到服务器 (S2S) 事件 API 通过 HTTP 请求向 Adjust 发送事件数据。使用 Adjust SDK 记录安装、会话和再归因，只使用 S2S API 发送 自定义 事件。

如果您正在为 Adjust iOS 14+ 应用设置 S2S 事件，Adjust 会将转化值作为 S2S 响应发送至您的服务器。随后，您的服务器需要在应用内更新转化值。要进一步了解相关信息，请查看iOS 14+ S2S 事件支持。

在本文中，您将了解如何设置 S2S 事件记录并对其进行故障排除。

终端
https://s2s.adjust.com/event

发送 S2S 事件

/event终端接受以下 S2S 事件请求：

  • 含 URL 参数的 GET。
  • 含 URL 参数的 POST。
  • 带有正文参数的 POST。Content-Type必须设置为application/x-www-form-urlencoded 。

设置 S2S 安全

设置 S2S 安全，可保护 S2S 事件的安全，抵御欺诈请求的侵害。设置认证后，每个传入的请求都必须带有您在 Adjust 控制面板中生成的识别码。缺失识别码或识别码不正确的请求会被 Adjust 服务器拒绝。

要开始设置，请按S2S 安全文档中的步骤操作。

必要参数

/event终端要求在每个请求中使用以下参数：

  1. 广告标识符，例如 iOS 的idfa或安卓的gps_adid。
  2. 事件识别码。
  3. 应用识别码。
  4. 一个硬编码的s2s=1参数，用于通知终端此请求来自 S2S。

要进行准确的事件归因，请将下列参数包含在您的事件中。

事件时间戳

事件时间戳可以通过created_at_unix参数或created_at参数指定。

  • created_at_unix：事件发送时的 UNIX 时间戳。例如：1484085154。
  • created_at：采用ISO 8601 格式的 URL 编码时间戳。例如： 2023-01-02T15%3A04%3A05.000%2B0000

请务必检查下列内容：

  • 必须根据请求中的时间戳按时间顺序针对每个设备和事件识别码提交事件。如果 Adjust 收到的事件时间戳早于之前收到的时间戳和事件，那么 Adjust 就会拒绝该事件。
  • 所有事件必须在 58 天内提交。时间戳早于 58 天前的任何事件都会被拒绝。

共享自定义数据

使用回传和合作伙伴参数将自定义事件数据发送至 Adjust。您可以在原始数据导出中使用会传参数，合作伙伴参数会与您的渠道合作伙伴共享。

使用以下参数向请求添加参数：

  • callback_params：包含 字符串 键值对的 URL 编码 JSON 对象。
  • partner_params：包含 字符串 键值对的 URL 编码 JSON 对象。
未编码示例
{
   "f0o": "bar",
   "bar": "baz"
}
编码示例
%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

要在原始数据导出中接收回传参数，请在 S2S 调用的callback_params参数中添加数据。

回传参数
curl --location 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

如需向渠道合作伙伴发送事件信息，请在 S2S 调用的partner_params参数中添加数据。

合作伙伴参数
curl --location https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

记录收入事件

将以下收入参数添加到事件提交，以记录服务器到服务器的收入事件：

示例