adjust-icon

服务器到服务器 (S2S) API

通过 Adjust 的 server-to-server API,您可以在不改变应用代码的情况下将应用连接到 Adjust。

认证

S2S API 使用 Bearer 识别码进行认证。 向禁止名单 API 发出的每个请求的 Authorization 标头中必须包含 Adjust API 识别码。

如果您的组织启用了单点登录 (SSO),请联系您的 Adjust 代表,或发送电子邮件至 support@adjust.com,我们将帮您查找 API 识别码。

非单点登录账户的 API 识别码位于用户 个人档案 中。要找到该识别码,请按照下列步骤操作。

  1. 选择账户 (用户) 图标。
  2. 选择 账户设置 。
  3. 选择 个人档案 标签页。
  4. 您的 API 识别码 会显示在 用户详细信息 中。选择复制按钮来将识别码复制到您的系统剪贴板。

重置 Adjust API 识别码

您可以随时重置 Adjust API 识别码。重置后,旧的识别码将失效。如果您重置了 Adjust API 识别码,请务必在所有使用识别码的位置进行替换。使用无效识别码发送的请求会被 Adjust 拒绝。

重置 Adjust API 识别码:

  1. 选择账户 (用户) 图标。
  2. 选择 账户设置 。
  3. 选择 个人档案 标签页。
  4. 您的 API 识别码 会显示在 用户详情 中。
  5. 选择 重置 API 识别码 。
  6. 在窗口中输入账户密码并选择 重置 来重置您的 API 识别码。屏幕右上角会显示确认信息。
  7. 选择 API 识别码 旁的复制按钮来将识别码复制到您的系统剪贴板。

S2S 终端

终端功能
https://s2s.adjust.com/event向 Adjust 报告应用内事件
https://s2s.adjust.com/ad_revenue向 Adjust 报告广告收入数据
https://s2s.adjust.com/session向 Adjust 报告会话数据

设备标识符

S2S 事件接受下列设备标识符:

首选标识符

名称值
原始 IDFA (仅限 iOS)idfa
原始 Google 广告 IDgps_adid
原始 Amazon Fire 广告 IDfire_adid
公共广告 ID (OAID,仅限华为)oaid
Web ID (由 Adjust Web SDK 生成)web_uuid

备用标识符

名称值
原始 IDFV (仅限 iOS)idfv
安卓 ID(仅限安卓设备)android_id

事件提交响应

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

失败事件会返回一个 HTTP 错误代码和 JSON 信息。

错误响应
{ "error": "Event request failed (${error_message})" }

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

错误代码错误消息原因
400Bad event state在请求详情不符合预期时出现。例如:created at时间早于installed_at时间。
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应用已在控制面板中设为非活跃状态
403Tracking disabled未启用对该平台的监测
403Event token blocklistedEvent token blocklisted
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 了解详细信息