English

Blacklist Tracker API

The Adjust Blacklist Tracker API endpoint is used to block traffic from fraudulent or outdated tracker URLs created for Dynamic and Module partners. A blacklisted tracker URL will display as BLACKLISTED in the dashboard.

Note:
It is not possible to blacklist SAN partner tracker URLs. Using the endpoint to blacklist a SAN partner tracker URL will return a positive result and display as BLACKLISTED in the dashboard. But the tracker URL is not blacklisted, and it will still track attributions. To block traffic from a SAN partner tracker URL, delete the SAN partner in the Partner Setup window from the Adjust Dashboard.

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:

  1. Find your app and select your app options caret (^)
  2. Select Tracker URLs
  3. 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:

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, attribution, and callbacks 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"
  }
}