adjust-icon

设备 API

使用设备 API 查看设备信息，并从 Adjust 中清除设备历史记录以进行测试。

要求

清除设备属于 破坏性 的操作。您的账户必须拥有以下用户权限 之一 ， 才能使用清除设备终端。

  • 管理员 。
  • 编辑员 。
  • 拥有目标应用访问权限的 自定义编辑员

认证

设备 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 识别码 旁的复制按钮来将识别码复制到您的系统剪贴板。

查询设备

使用查询设备终端，调取与应用相关的设备和链接信息。

参数

以下参数必须作为 查询参数 添加。

app_token (String)

用于标识应用的字母数字识别码。长度必须为 12 个字符。

advertising_id (String)

与您的设备关联的唯一广告 ID。

可用的广告 ID 如下：

  • idfa: 广告主 ID。仅适用于 iOS 设备。
  • gps_adid: Google 广告 ID。仅适用于使用 Google Play 商店的 Android 设备。
  • android_id: Android 设备 ID。仅适用于 Android 设备。
  • fire_adid: Amazon Fire 广告 ID。仅适用于使用 Amazon Fire 商店的 Android 设备。
  • win_adid: Windows 广告 ID仅适用于 Windows 设备。

响应格式

示例

清除设备

终端
POST https://api.adjust.com/device_service/api/v1/forget_device

使用清除设备终端，从 Adjust 服务器中清除设备信息。借此，您可以在同一台设备上多次测试安装。

参数

以下参数必须作为 请求数据 添加。

app_token (String)

用于标识应用的字母数字识别码。长度必须为 12 个字符。

adid (String)

设备的唯一 Adjust 标识符。使用检查设备终端查找您设备的 ADID。

示例

cURL
$ curl \
--header "Authorization: Token token=ask43jskdp2tg2hg87" \
--location --request POST "https://api.adjust.com/device_service/api/v1/forget_device" \
--data "adid=acf8534f2f052395e617a38730682ccc&app_token=gwzpeepw8uf8"
成功响应
200: Forgot device