服务器到服务器的事件跟踪

我们的服务器到服务器事件 API 让 Adjust 可以通过 HTTP 请求跟踪您的事件。

我们接受以下类型的 S2S 事件请求:
  • 含 URL 参数的 GET
  • 含 URL 参数的 POST(无正文)
  • 含作为 Content-Type 的正文参数的 POST application/x-www-form-urlencoded

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

操作前须知

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

要求

  • 用于跟踪事件并将调用发送至 Adjust 的服务器

实用信息

  • 系统会利用 SDK 自动记录安装、再归因和会话,无法将其发送至 Adjust 服务器到服务器。若要阻止接收大量重复数据,请避免使用 S2S 发送类似活动(例如“打开应用”)。

将事件发送至 Adjust

如需发送事件到 Adjust,请始终传递以下参数到 https://s2s.adjust.com/event

参数描述示例
idfa; gps_adid; etc.取决于平台的广告 ID(请参阅完整列表

idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E

gps_adid=660e1d86-6796-463a-be86-897993136018

event_token控制面板上的 Adjust 事件识别码event_token=f0ob4r
app_token控制面板上的 Adjust 应用识别码app_token=4w565xzmb54d
created_atISO 8601 格式的事件触发时间戳(请参阅参数条件

2017-01-02T15:04:05Z

2017-01-02T15:04:05+0000

s2s (服务器端到服务器端)s2s 参数设置为 11


对每个 Adjust 事件识别码按时间顺序发送 S2S 事件。例如,对同一识别码在第 7 天事件之前发送第 3 天的事件(否则将被拒绝)。请确保在 28 天内提交事件,因为更早的活动将被拒绝。

created_at 参数的设置条件

created_at 参数是最精准的时间戳,它将告诉您事件发生的确切时间。这有助于 Adjust 准确报告您的事件。 

  • 如果您的服务器端事件调用不包含 created_at 参数,或者格式不正确(如没有时区),Adjust 会将 created_at 时间设置为我们的 ReceivedAt 时间戳。
  • created_at 值进行编码。例如,2017-01-02T15:04:05+0000 将变成 2017-01-02T15%3A04%3A05%2B0000
  • 针对 Unix 时间戳,请使用 created_at_unix 参数,例如 created_at_unix=1484085154
    • Adjust 执行 Unix 时间戳时不支持任何浮点值或非数字字符,包括小数点 (.)。所有带非数字字符的时间戳将被拒绝。

其他事件提交参数的建议

为了保证准确的事件归因,我们建议将以下参数包含在您的事件中。

ID类型参数用于
Adjust IDadid识别 iOS 上无 idfa 信息的 LAT 用户
IP 地址ip_address=回传中链接至第三方(例如 Google)并包括位置相关信息(例如城市、postal_code)的事件

可用的设备 ID

以下是针对 S2S 事件接受的所有设备标识符:

原始 Amazon Fire 广告 IDfire_adid
原始 Google 广告 IDgps_adid
哈希 Google 广告 IDgps_adid_lower_sha1
哈希 Google 广告 IDgps_adid_upper_md5
哈希 Google 广告 IDgps_adid_upper_sha1
原始 IDFAIDFA
经哈希处理的 IDFAidfa_lower_md5
经哈希处理的 IDFAidfa_lower_sha1
经哈希处理的 IDFAidfa_upper_md5
经哈希处理的 IDFAidfa_upper_sha1
原始 IDFVidfv
imeiimei
经哈希处理的 IMEIimei_lower_md5
meidmeid
OAIDoaid
原始 Windows 广告 IDwin_adid
wp_udidwp_udid
ws_hwidws_hwid
ws_naidws_naid

共享自定义数据

使用回传和合作伙伴参数通过 S2S 事件将自定义事件数据传送给 Adjust。回传参数通过原始数据导出返回,而合作伙伴参数则与您的渠道合作伙伴共享。如需为 S2S 事件设置合作伙伴参数,请遵照此步骤。 

跟踪收入事件

如需跟踪服务器到服务器的收入事件,请将以下收入参数添加到事件提交:

参数描述
revenue以完整货币单位表示的收入事件值(149.99 = $ 149.99)。此参数可接受的最小值是 0.001。
货币收入事件货币代码
environment数据传送至的环境(环境 = Sandbox 测试环境 = production 生产)。如果未包含此参数,则事件会被推送至生产环境。

设置完成

含 URL 参数的 S2S GET 请求/含 URL 参数且无正文的 POST 请求示例:

https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E&created_at=2017-01-02T15%3A04%3A05Z%2B0200&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

S2S POST 请求,主体包含参数:

请求 URL:
https://s2s.adjust.com/event
主体:
s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E&created_at=2017-01-02T15%3A04%3A05Z%2B0200&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

事件请求响应代码

所有成功跟踪的事件将返回 OK 响应。

失败的事件将返回 HTTP 错误信息和 JSON 信息,例如:{"error": "Event request failed ( {error message})"}

错误信息将定义请求问题。请参阅以下错误信息定义,然后检查您的设置,或发送电子邮件至 support@adjust.com 寻求帮助。

错误代码错误消息原因
400Bad event state请联系 support@adjust.com 了解详细信息
400Invalid app token错误的应用识别码
400Ignoring event, earlier unique event tracked在控制面板上已设定成唯一事件,重覆触发事件不再作记录
400Invalid callback parameters无法提取回传参数
400Invalid event token事件识别码不存在、设置错误或与应用识别码不匹配
400Invalid revenue金额设置错误或价值太高(上限 = 100,000,000,000) 
401Failed to authorize request授权识别码缺失或不匹配
403App is inactive应用已在控制面板中设为非活跃状态
403Event token blacklistedEvent token blacklisted
404App token not foundApp token not found
404Device not found未找到设备安装数据
413Request size too large您的请求超过了我们的 1 MB 上限
451Device is opted outDevice is opted out 
500Internal error, contact support@adjust.com内部错误,请联系 support@adjust.com 了解详细信息