|This feature is applicable only if it has been enabled for your account. If this feature is disabled for your account and you would like to enable it, please contact your PubMatic Account Manager.|
Publishers can allowlist creatives specifically from one or more advertisers for specific sites (or all sites) by allowlisting URLs for advertisers or advertiser categories. When you allowlist advertisers for a site, all other advertisers are essentially blocklisted. This process facilitates safe and time-saving allowlisting within PubMatic.
Using the Allowlist, publishers can:
View available domain URLs for allowlisting and enable/disable the allowlist as needed.
|If you disable an allowlist for a site, it will be blocklisted, meaning that it will be removed from the allowlist.|
View, schedule, download, and email allowlisted advertiser categories, advertisers, and domain URLs for all sites or specific sites.
|If you disable an allowlisted advertiser for a site, any earlier configured blocklist will be applicable for your inventory.|
When reviewing the allowlisted items for a particular site, ensure that you have the correct site selected and that All Sites is not selected.
Select Ad Quality > Allowlist from the main navigation.
| = Full entity selected (e.g., all advertisers and domains within the category)|
= Partial entity selected (e.g., only some advertisers or domains within a category)
Select the checkbox for each item you want to allowlist or select the checkbox in a column heading to select all of the items in that column.
To allowlist all domains within a category or advertiser, select the check-box at the highest level (i.e., the category or advertiser in the first column on the left).
Click Save Changes, then Yes to confirm your allowlist changes.
Allowlisting changes can take up to 5-10 minutes to sync and be visible.
When a request is received on the ad server, PubMatic identifies http:// or https:// in the URL and extracts the domain until "/" or "?" is found and then parses the domain from the URL. Once the domain is extracted, PubMatic applies allowlisting and searches for the domain in the allowlisted domains list, first at the subdomain level and then the top-level domain.
Example: Domain extraction for https://abc.xyz.com/mypage.html?a=4&b=5 would be abc.xyz.com. PubMatic then searches for abc.xyz.com first and then xyz.com so that both the subdomain and top-level domain are allowlisted.
If a top-level domain is allowlisted, its subdomains will also be allowlisted.
|Example: If google.com is added to the allowlist, mail.google.com, app.google.com, etc. will also be allowlisted.|
When you have many categories, advertisers or domains to allowlist for sites, use the Bulk Upload option.
When the File is successfully uploaded confirmation appears at the top of the page, click Refresh. Continue to click Refresh until the file has been processed. (You can also leave this window and return later.) If the file fails, click the Failed status in the Status column. The reason for the failure will be listed for the sites/domains that failed. Fix the issue and try again.
|If the Site URL does not match one in the system, it will return a "URL(s) failed to upload" message. To add a new site, select Inventory > Sites & Tags to add a new one.|
You can manage sites for allowlisting by clicking Manage Sites for Brand Control at the top of Allowlist Manager.
From this page, you can click Remove Allowlist and Apply Blocklist for those sites that are currently allowlisted, or click Configure and Apply Allowlist for those that are not currently allowlisted.
When removing from the allowlist, click Disable Allowlist to confirm.
When adding to the allowlist, configure as needed and click Save Changes.
The Allowlist Report can be downloaded using one of the download options. Downloads will reflect the current allowlist view.