通过 Adjust 的 server-to-server API,您可以在不改变应用代码的情况下将应用连接到 Adjust。
认证
S2S API 使用 Bearer 识别码进行认证。 向禁止名单 API 发出的每个请求的 Authorization
标头中必须包含 Adjust API 识别码。
如果您的组织启用了单点登录 (SSO),请联系您的 Adjust 代表,或发送电子邮件至 support@adjust.com,我们将帮您查找 API 识别码。
非单点登录账户的 API 识别码位于用户 个人档案 中。要找到该识别码,请按照下列步骤操作。
- 选择账户 (用户) 图标。
- 选择 账户设置 。
- 选择 个人档案 标签页。
- 您的 API 识别码 会显示在 用户详细信息 中。选择复制按钮来将识别码复制到您的系统剪贴板。
重置 Adjust API 识别码
您可以随时重置 Adjust API 识别码。重置后,旧的识别码将失效。如果您重置了 Adjust API 识别码,请务必在所有使用识别码的位置进行替换。使用无效识别码发送的请求会被 Adjust 拒绝。
重置 Adjust API 识别码:
- 选择账户 (用户) 图标。
- 选择 账户设置 。
- 选择 个人档案 标签页。
- 您的 API 识别码 会显示在 用户详情 中。
- 选择 重置 API 识别码 。
- 在窗口中输入账户密码并选择 重置 来重置您的 API 识别码。屏幕右上角会显示确认信息。
- 选择 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 广告 ID | gps_adid |
原始 Amazon Fire 广告 ID | fire_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 寻求帮助。
错误代码 | 错误消息 | 原因 |
---|---|---|
400 | Bad event state | 在请求详情不符合预期时出现。例如:created at 时间早于installed_at 时间。 |
400 | Invalid app token | 应用识别码设置错误 |
400 | Ignoring event, earlier unique event tracked | 已记录唯一事件,重复触发事件不再作记录。 |
400 | Invalid callback parameters | 无法提取回传参数。 |
400 | Invalid event token | 事件识别码不存在、设置错误或与应用识别码不匹配。 |
400 | Invalid revenue | 金额设置错误或值太高(上限 = 100,000,000,000) |
401 | Failed to authorize request | 授权识别码缺失或不匹配 |
403 | App is inactive | 应用已在控制面板中设为非活跃状态 |
403 | Tracking disabled | 未启用对该平台的监测 |
403 | Event token blocklisted | Event token blocklisted |
404 | App token not found | App token not found |
404 | Device not found | 未找到设备安装数据 |
413 | Request size too large | 您的请求超过了 1 MB 的上限 |
451 | Device is opted out | Device is opted out |
500 | Internal error, contact support@adjust.com | 内部错误,请联系 support@adjust.com 了解详细信息 |