屏蔽名单 API

使用 Adjust 禁止名单 API 来拦截来自欺诈或过期链接的流量。您可以将自定义链接和合作伙伴链接加入禁止名单，但无法将自归因渠道 (SAN) 合作伙伴链接加入禁止名单。要屏蔽来自 SAN 合作伙伴链接的流量，您必须删除该 SAN 合作伙伴。访问自归因渠道设置页面，查看完整 SAN 合作伙伴列表。

认证

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

将链接加入屏蔽名单

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

您可以将链接加入禁止名单，停止记录交互和回传。被列入禁止名单的链接会保留其现有归因，直到用户被再归因至其他链接。

在链接列入屏蔽名单之前已记录的点击和展示仍可进行归因。例如，如果您设置了一个时长为 7 天的归因窗口并在第 2 天将链接列入屏蔽名单，Adjust 仍会将第 1 天的交互纳入归因考量。

参数

以下参数必须被添加至查询路径：

link (String): 由字母数字组成的 Adjust 链接识别码。

响应格式

1
{
2
   "label": "string",
3
   "token": "string",
4
   "name": "string",
5
   "url": "string",
6
   "path": "string",
7
   "has_subtrackers": true,
8
   "archived": true,
9
   "visible": true,
10
   "attribution_partner": true,
11
   "creative_token": "string",
12
   "adgroup_token": "string",
13
   "campaign_token": "string",
14
   "network_token": "string",
15
   "click_url": "string",
16
   "impression_url": "string",
17
   "allow_partner_linking": true,
18
   "settings": {
19
      "partner_id": "string",
20
      "partner_display_name": "string",
21
      "tracking_parameters": "string",
22
      "cost_data_parameters": "string",
23
      "cost_data": true,
24
      "partner_cost_data_parameters": "string",
25
      "campaign_structure": "string",
26
      "additional_parameters": "string",
27
      "attribution_settings": "string",
28
      "blacklisted": true
29
   },
30
   "urls": {
31
      "descendants": "string",
32
      "ancestors": "string",
33
      "update": "string",
34
      "show": "string",
35
      "archive": "string",
36
      "unarchive": "string"
37
   }
38
}

示例

$ curl \
--header "Authorization: Token token={api_token}" \
-L -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"
   }
}

将链接移出屏蔽名单

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

您可以随时将链接移出禁止名单，重新激活该链接。一旦将链接移出屏蔽名单，Adjust 就会立即恢复交互跟踪和回传。

只有当链接被激活时接收到的交互才会被纳入您的归因漏斗。

参数

以下参数必须被添加至查询路径：

link (String): 由字母数字组成的 Adjust 链接识别码。

响应格式

1
{
2
   "label": "string",
3
   "token": "string",
4
   "name": "string",
5
   "url": "string",
6
   "path": "string",
7
   "has_subtrackers": true,
8
   "archived": true,
9
   "visible": true,
10
   "attribution_partner": true,
11
   "creative_token": "string",
12
   "adgroup_token": "string",
13
   "campaign_token": "string",
14
   "network_token": "string",
15
   "click_url": "string",
16
   "impression_url": "string",
17
   "allow_partner_linking": true,
18
   "settings": {
19
      "partner_id": "string",
20
      "partner_display_name": "string",
21
      "tracking_parameters": "string",
22
      "cost_data_parameters": "string",
23
      "cost_data": true,
24
      "partner_cost_data_parameters": "string",
25
      "campaign_structure": "string",
26
      "additional_parameters": "string",
27
      "attribution_settings": "string",
28
      "blacklisted": true
29
   },
30
   "urls": {
31
      "descendants": "string",
32
      "ancestors": "string",
33
      "update": "string",
34
      "show": "string",
35
      "archive": "string",
36
      "unarchive": "string"
37
   }
38
}

示例

$ curl \
--header "Authorization: Token token={api_token}" \
-L -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"
   }
}

查看链接状态

您可以在 Campaign Lab 中查看哪些链接被加入了屏蔽名单。为此请进行下列操作：

打开 Campaign Lab。
选择一个合作伙伴来显示关联链接列表。位于屏蔽名单中的链接将显示为 BLOCKLISTED (已列入屏蔽名单)。

您可以在 Campaign Lab 中隐藏列入禁止名单的链接。要参阅操作说明，请查看：Campaign Lab 中的隐藏链接