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 了解详细信息