Blocklist API

Important:
"Blacklist" and "whitelist" have been renamed to "blocklist" and "allowlist". Currently this change applies to our UI and documentation. While we work towards updating our codebase, you'll still see the term "blacklist" in our API endpoints.

Use the Adjust Blocklist API to block traffic from fraudulent or outdated link URLs. Blocklisted links display a BLOCKLISTED label in the dashboard.

You can blocklist link URLs for Dynamic and Module partners. You cannot blocklist SAN partner link URLs. If you want to block traffic from a SAN partner URL, you need to delete the SAN partner. See Self-attributing networks for a list of SAN partners.

1. Authenticate your calls

To use the Adjust Blocklist API, you first need to get your Adjust API token. Follow the instructions in the Authentication article to find out how to use this token with the API.

2. Blocklist a link

Blocklist a link to block the following information:

  • Engagements
    • Clicks
    • Impressions
  • Callbacks to partners and networks
    • Module callbacks
    • Dynamic callbacks

Any existing attributions associated with the link remain associated. Data from attributed users associates to the link until the user is reattributed to a different link.

3. Unblocklist a link

If you want to reactivate a link URL, you can unblocklist it. Once you unblocklist the link, Adjust resumes recording engagement and callbacks.

Note:
Unblocklisting a link enables it immediately. Attribution data associated to the link while it was blocklisted is not considered. Only engagements received when the link is enabled are considered in your attribution funnel.

4. View link status

You can check which links are blocklisted in Campaign Lab. To do this:

Ad networks

  1. Under Campaign Lab, select Partners.
  2. Select an ad network that you've set up to view the network-level details of the link.

Links on the blocklist display as BLOCKLISTED.

Custom links

  1. Under Campaign Lab, select Custom links.
  2. Select a custom link that you've set up to view the channel-level details of the link.

Links on the blocklist display as BLOCKLISTED.

You cannot EDIT blocklisted links. The only option you have is to hide the link. When you hide a link, you hide it from your list of active link URLs. You can hide or unhide a blocklisted link at any time. For more information on hiding links, see hide ad network links | hide custom links.