On this page:
Allowlist and Blocklist overview
Allowlists and Blocklists are the rules you establish to determine which ad impressions a campaign is eligible to bid on. These rules relate to various campaign elements (such as Locations, Device IDs, Audiences, and more. For example, you can choose which relevant audiences you’d like to show your ad to, and which ones you’d like to prevent from seeing the ad, by adding those audiences to an Allowlist or Blocklist. Note that you may see Allowlists referred to as “white lists” or “target lists” and Blocklists referred to as “black lists” in other DSPs.
While customizing a campaign with Allowlists and Blocklists is essential for tailoring a campaign, these elements should be reserved for only the non-negotiable rules you’d like to apply to the campaign. Refer to Impact on reach and impressions for more information on scale considerations.
Allowlists
You’ll apply targeting criteria to a campaign when you want to define who you're willing to serve the ad to based on a specific set of criteria. For example, you can choose to only advertise to users who are browsing on a particular device, located in a particular geographic region, and belonging to a particular audience.
Your targeting settings get added to an “Allowlist” for each relevant dimension category.
Blocklists
You’ll apply blocking criteria to a campaign when you want to avoid showing your ads to users based on a specific set of criteria. For example, if you’re building an awareness campaign, you might want to prevent users who previously converted on your website from seeing the ad by adding a Retargeting audience to a Blocklist. You can also choose which sites or apps you’d like to avoid in order to maintain the brand’s image or exclude irrelevant inventory.
Your blocking settings get added to a “Blocklist” for each relevant dimension category.
AND/OR relationships
Note that a campaign’s Allowlists and Blocklists are assigned an “OR” relationship, meaning that they work independently for each dimension. Allowlists and Blocklists are specific to each campaign element such as Audience, Location, Inventory, and more. This means that you can, for example, exclude a certain audience and include a certain site domain.
With an “OR” relationship, a campaign won’t bid on an impression if it matches any one of the exclusion criteria included in a Blocklist. For example, you can’t block one user who is located in New York “AND” browsing a particular site domain. The campaign will block any user who is either located in New York “OR” browsing a particular site domain.
Example Blocklist:
New York
Site Domain A
Impression details | Bid decision (Y/N) |
Texas, Site Domain A | N - The impression matches a blocked Site Domain dimension. |
New York, Site Domain C | N- The impression matches a blocked Location dimension. |
California, Site Domain A | N - The impression matches a blocked Site Domain dimension. |
California, Site Domain B | Y - The impression doesn’t match any blocked dimensions. |
Allowlists follow a similar logic, but will include rather than exclude the items you’ve specified. Using the same example, you can’t target one user who is located in New York “AND” browsing a particular site domain. The campaign will bid on an impression if it matches either one of these inclusion criteria.
Allowlist rules differ slightly from Blocklist rules. If you target certain campaign dimensions, then all other dimensions in the same dimension category are excluded. For example, if your campaign targets New York and California, it’ll only bid on New York impressions or California impressions. This means that all other Locations are effectively blocked from the campaign.
Example Allowlist:
New York
California
Site Domain A
Impression details | Bid decision (Y/N) |
New York, Site Domain B | N - If only Site Domain A is targeted, the campaign won’t serve ads on other site domains. |
Texas, Site Domain A | N - If only New York and California are targeted, the campaign won’t serve ads to users in other locations. |
California, Site Domain A | Y - The impression matches all Allowlist rules. |
Impressions that match targeted and blocked dimensions: There may be instances when an available impression matches one targeted dimension and another blocked dimension. For example, the campaign is blocking the site domain and targeting the mobile operating system (OS). The campaign will only bid on impressions that meet every targeting requirement that you’ve defined. In the same way, it will never bid on an impression that matches any of your campaign’s blocked dimensions. |
Campaign elements to allow or block
You can create an Allowlist or Blocklist for each dimension category, or element, listed below.
Element | Description |
Location | In the Campaigns app, choose which states, DMAs, counties, cities, or ZIP codes; or congressional districts, state senates, or state houses to include or exclude. |
Audience | In the Campaigns app, choose which audiences to include or exclude based on your own user data, or segments from IQM or any of our data providers. These audiences are made up of groups of users who share common characteristics like age, gender, or home ownership status, for example. |
Device | In the Campaigns app, choose which device IDs to include or exclude.
In the Bid Model app, choose which device elements to include or exclude after they appear in the ad-serving data. These may include individual devices (TV, tablet, desktop, or mobile) or channels (app, web, connected TV [CTV], or over the top [OTT]). |
Inventory* | In the Campaigns app, choose which Android packages, iOS Apple IDs, and/or site domains to include or exclude.
In the Inventory app, assign inventory to a Global Blocklist to ensure that your ads are only displayed on high-quality websites that align with the brand image and target audience. The platform will immediately stop serving ads across any of the inventory you blocked.
In the Bid Model app, choose which deal ID(s), Open Exchange inventory, and/or publisher categories that you want the campaign to include or exclude. |
Advanced | In the Campaigns app, indicate which device ID(s) and/or internet protocol (IP) addresses that you want the campaign to include or exclude. |
* Refer to What are Blocklisted Inventories? for more information on inventory Blocklists.
Impact on reach and impressions
Allowlists and Blocklists help ensure that every marketing dollar goes toward the strategies that are the most likely to reach your target audience—but they also limit the number of impressions that you can bid on. This can put your campaigns at risk of spending in full.
Forecasting and reporting metrics provide a sense of scale to help you determine whether you can spend your campaign budget in full and achieve campaign objectives. Leverage your preferred tools in the Campaigns, Planner, Reports, and Insights apps to help right-size your campaigns’ Allowlist and Blocklist strategies:
Campaigns app: Refer to Estimate reach, impression and audience size for a campaign for more information on generating campaign forecasts in the Campaigns app.
Planner app: Refer to Create or manage a Planner proposal to learn how to add your targeting criteria to a new media plan.
Reports app: Refer to Generate, manage, or send a report to get started with Performance reporting metrics in custom reports.
Insights app: Refer to Generate and interpret a Campaign Bidding Insights report to pinpoint the campaign elements that are causing the biggest drop off in available bid requests.
Apply a Bid Model: Because Allowlists and Blocklists limit a campaign’s scale, it’s important to reserve them for when you only want to bid on certain dimensions, or never want to bid on certain dimensions. If your campaign’s targeting parameters are flexible, consider applying Bid Model components to apply optimizations throughout the campaign. You can stop bidding on the campaign dimensions that aren’t performing well, bid more precisely based on how valuable an impression is to the campaign, and choose which dimensions the campaign should prioritize over others. Refer to Customize your Bid Model for more details. |
Locate additional Allowlist and Blocklist resources