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