Blacklist Tracker API

The Adjust Blacklist Tracker API is used to block traffic from fraudulent or outdated tracker URLs.

Availability

Business Pro pricing plan or higher

About blacklisting

When you blacklist a tracker, Adjust blocks the following:

Engagements
- Clicks
- Impressions
Callbacks to partners and networks, including:
- module callbacks
- dynamic callbacks

Blacklisted trackers retain their existing attributions; this means that a user’s in-app sessions and events will remain associated with the blacklisted tracker URL until they are reattributed to one of your other, active trackers.

Note:

Any clicks or impressions recorded before the tracker was blacklisted are still eligible for conversion within the attribution window.

For example, if there is a seven-day attribution window and the tracker is blacklisted on day 2, it is still possible to attribute installs later in the week to clicks recorded on day 1.

Unblacklisting

You can also unblacklist trackers using the Adjust Blacklist Tracker API. Once a tracker is unblacklisted, Adjust will resume tracking engagements from the tracker and sending callbacks. You will be able to edit the tracker settings in the Adjust Campaign Wizard.

Note:

Unblacklisting a tracker takes immediate effect, but it does not retroactively apply to your attribution data. Only the tracker engagements made after the time of unblacklisting will be considered within your attribution funnel.

View blacklisted trackers

To view your blacklisted trackers in the Adjust Dashboard, follow these steps:

Find your app and select your app options caret (^)
Select Tracker URLs
Select Settings (gear icon) next to your blacklisted tracker

The tracker will display as BLACKLISTED.

If you select EDIT for a blacklisted tracker, the only available option is to hide the tracker. When you hide a tracker, you hide it from your list of active tracker URLs. You can hide or unhide a blacklisted tracker at any time. For more on hiding trackers, see Tracker maintenance.

Blacklist tracker

To block engagement measurement, attribution and callbacks to a tracker and any related subtrackers, use these Blacklist Tracker API endpoint specifications.

Endpoint:

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

Requirements:

Parameter	Definition
`{tracker}` Required	Alphanumeric Adjust tracker token

Sample request example (using curl):

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

Sample response

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

Unblacklist tracker

Use the unblacklist tracker endpoint to renew engagement measurement, attribution, and callbacks to a tracker and any related subtrackers.

Endpoint:

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

Requirements:

Parameter	Definition
`{tracker}` Required	Alphanumeric Adjust tracker token (at least 6 characters long)

Sample request (using curl):

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

Sample response:

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