Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

Warning
This feature is applicable only if it has been enabled for your account. If enabled, Allowlist will appear as an option under the Ad Quality menu of the PubMatic Publisher platformUI. If this feature is disabled for your account and you would like to enable it, please contact your PubMatic Account Manager.

The Allowlist Manager lets publishers allow 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 the PubMatic interface.

Using the Allowlist Manager, Publishers publishers can:

  • Allowlist a domain URL (including subdomains) for an advertiser or advertiser category for all sites or a specific site.
  • View available domain URLs for allowlisting and enable/disable the allowlist as needed. 

    Warning
    If you disable an allowlist for a site, it will be " blocklisted, " meaning that it is will be removed from the allowlist.


  • View, schedule, download, and email allowlisted advertiser categories, advertisers, and domain URLs for all sites or specific sites.

    Warning
    If you disable an allowlisted advertiser for a site, any earlier configured blocklist will be applicable for your inventory.


  • Search for allowlisted advertisers, advertiser categories, and domain URLs.
Tip
titleTIP

When reviewing the allowlisted items for a particular site, ensure that you have the correct site selected and that All Sites is not selected.

Editing an allowlist 

  1. Select Ad Quality > Allowlist from the main navigation.
     Image Modified

    Info
    titleNote
    Image Modified  = Full entity selected (e.g., all advertisers and domains within the category)
    Image Modified  = Partial entity selected (e.g., only some advertisers or domains within a category)


  2. Select whether you want the allowlist changes to apply to all sites or a particular site by clicking the Apply Allowlist To dropdown menu, and select  All Sites  or a  specific  site. To locate a site, browse the list to make a selection or begin typing part of the URL and press  Enter  to begin the search. Continue typing more of the site name and press  Enter  to narrow the search results. The subsequent allowlisting will apply to this selection.
    Image Removed
  3. Select whether you want to view by CategoryAdvertiser  or  Domain  by selecting the  , or Domain from the View By  drop-down menu and selecting an option.
    Image Removed 
  4. Enter the search criteria in the search box or browse through the list.
     
  5. For either  Category  Category or  Advertiser Advertiser, use the arrows  next to the entity you want to expand. Continue to use the arrows  for each sub-level you want to expand. (Domains Domains are displayed in a single list, so there is no need to navigate to another level.)
  6. Select the   checkbox for each item you want to block allowlist or select the checkbox in a column heading to select all of the items in that column.  
     

    Info

    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).


  7. Click Save Changes, then Yes, to  to confirm your allowlist changes.

    Info

    Allowlisting changes can take up to 5-10 minutes to sync and be visible. 


How PubMatic manages subdomains and top-level domains 

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. 

...

Info

Bulk upload an allowlist

When you have many categories, advertisers or domains to allowlist for sites, use the Bulk Upload option.

...

Info
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.

Managing sites for brand control

You can manage sites for allowlisting by clicking Manage Sites for Brand Control at the top of Allowlist Manager.
 

...

When adding to the allowlist, configure as needed and click Save Changes.

Download an allowlist report

The Allowlist Report can be downloaded using one of the download options. Downloads will reflect the current allowlist view.

...