设备 API

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

要求

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

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

认证

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

查询设备

GET https://api.adjust.com/device_service/api/v2/inspect_device

GET https://api.adjust.com/device_service/api/v1/inspect_device

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

参数

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

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 设备。

响应格式

1
{
2
   "Adid": "string",
3
   "AdvertisingId": "string",
4
   "Tracker": "string",
5
   "TrackerName": "string",
6
   "Environment": "string",
7
   "ClickTime": "date-time",
8
   "InstallTime": "date-time",
9
   "LastSessionTime": "date-time",
10
   "LastEventsInfo": {
11
      "{event_id}": {
12
         "name": "string",
13
         "time": "date-time"
14
      },
15
      "{event_id}": {
16
         "name": "string",
17
         "time": "date-time"
18
      },
19
      "{event_id}": {
20
         "name": "string",
21
         "time": "date-time"
22
      }
23
   },
24
   "LastSdkVersion": "ios4.37.2",
25
   "State": "string"
26
}

1
{
2
   "Adid": "string",
3
   "AdvertisingId": "string",
4
   "Tracker": "string",
5
   "TrackerName": "string",
6
   "ClickTime": "date-time",
7
   "InstallTime": "date-time",
8
   "LastSessionTime": "date-time",
9
   "LastEventTimes": {
10
      "string": "date-time",
11
      "string": "date-time",
12
      "string": "date-time",
13
      "string": "date-time"
14
   },
15
   "State": "string"
16
}

示例

$ curl \
--header "Authorization: Bearer ask43jskdp2tg2hg87" \
-L -X GET "https://api.adjust.com/device_service/api/v2/inspect_device?advertising_id=1234-5678-9012-3456&app_token=gwzpeepw8uf8"

{
   "Adid": "acf8534f2f052395e617a38730682ccc",
   "AdvertisingId": "1234-5678-9012-3456",
   "Tracker": "abc123",
   "TrackerName": "Organic",
   "FirstTracker": "zr5vueb",
   "FirstTrackerName": "Organic",
   "Environment": "sandbox",
   "ClickTime": "0001-01-01T00:00:00Z",
   "InstallTime": "2015-08-19T03:42:03Z",
   "LastSessionTime": "2017-07-29T17:29:17Z",
   "LastEventsInfo": {
      "kgfcul": {
         "name": "Copy IDFA",
         "time": "2024-07-18T10:01:16Z"
      },
      "wz9qqz": {
         "name": "Accept Terms",
         "time": "2024-07-01T14:13:47Z"
      },
      "z3f773": {
         "name": "Copy IDFV",
         "time": "2024-07-01T19:01:39Z"
      }
   },
   "LastSdkVersion": "ios4.37.2",
   "State": "installed"
}

$ curl \
--header "Authorization: Bearer ask43jskdp2tg2hg87" \
-L -X GET "https://api.adjust.com/device_service/api/v1/inspect_device?advertising_id=1234-5678-9012-3456&app_token=gwzpeepw8uf8"

{
   "Adid": "acf8534f2f052395e617a38730682ccc",
   "AdvertisingId": "1234-5678-9012-3456",
   "Tracker": "abc123",
   "TrackerName": "Organic",
   "ClickTime": "0001-01-01T00:00:00Z",
   "InstallTime": "2015-08-19T03:42:03Z",
   "LastSessionTime": "2017-07-29T17:29:17Z",
   "LastEventTimes": {
      "a1a1a1": "2017-07-29T17:29:55Z",
      "b2b2b2": "2017-07-29T17:29:21Z",
      "c3c3c3": "2017-07-29T17:29:38Z",
      "4d4d4d": "2017-07-29T17:29:58Z"
   },
   "State": "installed"
}

清除设备

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

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

参数

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

app_token (String): 用于标识应用的字母数字识别码。长度必须为 12 个字符。
adid (String): 设备的唯一 Adjust 标识符。使用检查设备终端查找您设备的 ADID。

示例

$ 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