利用Adjust API轻松访问您的数据。我们的API可以帮助您更快速有效的使用Adjust控制面板数据,以满足您的业务需求。

所有Adjust API向Business Pro及以上套餐客户开放。

1REST API验证

为了调用REST API,您必须使用请求标头(Request Header),其中包括验证标头(Authorization Header)和您的Adjust API识别码。

请求标头 说明
Authorization
必填
当您调用Adjust API,发送包含验证类型为Bearer的API识别码。例如: Authorization: Bearer API_Token

2如何找到Adjust API识别码

您可以在Adjust控制面板中找到API识别码。

操作说明

  1. 账号设置 > 用户
  2. 选择用户名并点击对应窗口底部灰色插入符号
  3. 选择 User details
  4. 您将在侧边最后一栏找到API识别码

Adjust API识别码是按用户分配的,适用于任何Adjust已集成的应用,和任何Adjust控制面板的账户。您的Adjust用户名对应的API识别码是唯一的,请不要对其他用户公开。

3设备API

使用设备API来查看设备信息,和从Adjust中删除用于测试目的的设备记录。

3.1查询设备

您可使用Adjust设备端点查询设备活动。

端点:

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

当前版本: v1

要求:

请求标头 定义
app_token
必填
Adjust分配给您应用的ID,由10位字母数字组成。
advertising_id
必填
分配给您设备的唯一广告ID。Adjust支持如下ID类型:IDFA (iOS)、Google Advertising ID (Android)、Android ID (Android)、Windows Advertising ID (Windows)、Fire Advertising ID (Kindle)。

请求示例(使用curl):

curl -H "Authorization: Bearer ask43jskdp2tg2hg87" https://api.adjust.com/device_service/api/v1/inspect_device\?advertising_id\=1234-5678-9012-3456\&app_token\=tei4k374ke

响应示例:

{
    "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"
}

响应定义:

属性 类型 定义
Adid 字符串 分配给每个被Adjust跟踪设备的内部ID。
AdvertisingID 字符串 用于原始查询的唯一设备ID。
Tracker 字符串 设备当前归因来源的跟踪码。
TrackerName 字符串 设备当前归因来源的跟踪码名称。
ClickTime 字符串 记录的任意设备点击时间戳。被归因为自然流量的设备点击时间戳是"0001-01-01T00:00:00Z"
InstallTime 字符串 记录的任意设备安装时间戳。
LastSessionTime 字符串 记录的最近会话时间戳。
LastEventTimes 字符串 若有,最近触发事件的时间戳。
State 字符串 设备当前归因状态。可能值: installed(已安装)、reattributed(已再归因)。

3.2清除设备

您还可使用Adjust清除设备端点从Adjust中清除设备历史记录,并在同一个设备上测试多个安装。

端点:

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

当前版本: v1

要求:

请求标头 定义
app_token
必填
Adjust分配给您应用的ID,由10位字母数字组成。
adid
必填
分配给每个被Adjust跟踪设备的内部ID。

请求示例(使用curl):

curl -H "Authorization: Bearer ask43jskdp2tg2hg87" https://api.adjust.com/device_service/api/v1/forget_device\?adid\=acf8534f2f052395e617a38730682ccc\&app_token\=tei4k374ke

响应示例:

Forgot device

4黑名单跟踪API

您可以通过黑名单跟踪API阻止来自作弊渠道或过期跟踪链接的流量。当一个跟踪链接被纳入黑名单后,Adjust将不再统计来自该跟踪链接和其子链接的点击或展示。源自黑名单渠道的活动将不会被归因。此外,您还可以使用移出黑名单跟踪API端点从黑名单中移除指定跟踪链接。

4.1黑名单跟踪链接

使用黑名单跟踪端点来阻止对指定跟踪链接和其所有相关子链接的交互监测和归因。

端点:

https://api.adjust.com/dashboard/api/trackers/{tracker}/blacklist

条件:

参数 定义
{tracker}
必填
由字母数字组成的Adjust跟踪码

请求示例(使用curl):

curl -H "Authorization: Token token={api_token}" -X POST "https://api.adjust.com/dashboard/api/trackers/abc123/blacklist"

响应示例:

{
  "label": "Twitter installs",
  "token": "abc123",
  "name": "Twitter installs",
  "url": "https://app.adjust.com/abc123",
  "path": "",
  "has_subtrackers": true,
  "archived": false,
  "visible": true,
  "attribution_partner": false,
  "creative_token": null,
  "adgroup_token": null,
  "campaign_token": null,
  "network_token": "abc123",
  "click_url": "https://app.adjust.com/abc123",
  "impression_url": "https://view.adjust.com/impression/abc123",
  "allow_partner_linking": true,
  "settings": {
    "partner_id": null,
    "partner_display_name": null,
    "tracking_parameters": null,
    "cost_data_parameters": null,
    "cost_data": false,
    "partner_cost_data_parameters": null,
    "campaign_structure": null,
    "additional_parameters": null,
    "attribution_settings": null,
    "blacklisted": true
  },
  "urls": {
    "descendants": "/api/trackers/abc123/descendants.json",
    "ancestors": "/api/trackers/abc123/ancestors.json",
    "update": "/api/trackers/abc123.json",
    "show": "/api/trackers/abc123.json",
    "archive": "/api/trackers/abc123/archive.json",
    "unarchive": "/api/trackers/abc123/unarchive.json"
  }
}

4.2移出黑名单跟踪链接

使用移出黑名单跟踪端点重新开始对指定跟踪链接和其所有相关子链接的交互监测和归因。

端点:

https://api.adjust.com/dashboard/api/trackers/{tracker}/unblacklist

条件:

参数 定义
{tracker}
必填
由字母数字组成的Adjust跟踪码(至少包含6个字符)

请求示例(使用curl):

curl -H "Authorization: Token token={api_token}" -X POST "https://api.adjust.com/dashboard/api/trackers/abc123/unblacklist"

响应示例:

{
  "label": "Twitter installs",
  "token": "abc123",
  "name": "Twitter installs",
  "url": "https://app.adjust.com/abc123",
  "path": "",
  "has_subtrackers": true,
  "archived": false,
  "visible": true,
  "attribution_partner": false,
  "creative_token": null,
  "adgroup_token": null,
  "campaign_token": null,
  "network_token": "abc123",
  "click_url": "https://app.adjust.com/abc123",
  "impression_url": "https://view.adjust.com/impression/abc123",
  "allow_partner_linking": true,
  "settings": {
    "partner_id": null,
    "partner_display_name": null,
    "tracking_parameters": null,
    "cost_data_parameters": null,
    "cost_data": false,
    "partner_cost_data_parameters": null,
    "campaign_structure": null,
    "additional_parameters": null,
    "attribution_settings": null,
    "blacklisted": false
  },
  "urls": {
    "descendants": "/api/trackers/abc123/descendants.json",
    "ancestors": "/api/trackers/abc123/ancestors.json",
    "update": "/api/trackers/abc123.json",
    "show": "/api/trackers/abc123.json",
    "archive": "/api/trackers/abc123/archive.json",
    "unarchive": "/api/trackers/abc123/unarchive.json"
  }
}