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

All Adjust APIs are available to clients in or above a Business Pro package.

Blacklist tracker

When a tracker is blacklisted, Adjust no longer attributes engagements (i.e., clicks and impressions) to that tracker. Blacklisted trackers retain their existing attributions; this means that a user’s in-app sessions and events will remain affiliated with the blacklisted tracker URL until they are reattributed to one of your other, active trackers. It is also important to note that 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.

If you select the settings (gear) icon beside a blacklisted tracker in the Campaign Wizard, the tracker will display as BLACKLISTED. If you select EDIT for a blacklisted tracker, the only available option is to archive the tracker. When you archive a tracker, you hide it from your list of active tracker URLs. You can archive or unarchive a blacklisted tracker at any time.

It is also possible to unblacklist trackers using the Adjust blacklist tracker API. Once a tracker is unblacklisted, Adjust will resume tracking engagements from the tracker and you will be able to edit the tracker settings in the Adjust Campaign Wizard. While unblacklisting a tracker takes immediate effect, 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.

To block engagement measurement and attribution to a tracker and any related subtrackers, use these blacklist tracker endpoint specifications.

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

Requirements:
 
ParameterDefinition
{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 and attribution to a tracker and any related subtrackers.

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

Requirements: 
ParameterDefinition
{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"
  }
}

On this topic