Whitelist Manager

Document created by catherine.racette on Feb 8, 2017Last modified by catherine.racette on Apr 11, 2017
Version 4Show Document
  • View in full screen mode

About Whitelisting

This feature is applicable only if it has been enabled for your account. If enabled, the Whitelist Manager option is displayed under the Ad Quality menu of the PubMatic platform. If this feature is disabled for your account and you want to enable it, contact your PubMatic Account Manager.

The Whitelist Manager enables publishers to allow creatives specifically from one or more advertisers for specific sites (or all sites) by whitelisting URLs for advertisers or advertisers categories. When you whitelist advertisers for a site, all other advertisers are essentially blocklisted. This process facilitates safe and time-saving whitelisting within the PubMatic interface.

Using Whitelist Manager, Publishers can:

  • Whitelist a domain URL for an advertiser or advertiser category for all sites or a specific site.
  • View available domain URLs for whitelisting and can enable/disable the whitelist as needed. 

    If you disable the whitelist for a site, it will be "blacklisted," meaning that it is removed from the whitelist.

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

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

The Whitelist Manager enables publishers to search for and whitelist advertisers, advertisers' categories and domain URLs.

This feature is applicable only if it has been enabled for your account. If enabled, the Whitelist Manager option is displayed under the Ad Quality menu of the PubMatic platform. If this feature is disabled for your account and you want to enable it, contact your PubMatic Account Manager.

Whitelist by Domain URL

  1. Select Ad Quality | Whitelist Manager from the main navigation.
  2. Select a specific site from the Whitelisted Site drop-down (or leave the All Sites selection in place). The subsequent whitelisting will apply to this selection.
  3. Select Domain from the View By drop-down list.
  4. Select the checkbox for each Domain URL within the advertiser you want to whitelist. It will be moved to the User Actions List.
  5. Click Save.

Whitelist by Advertiser 

  1. Select Ad Quality | Whitelist Manager from the main navigation.
  2. Select a specific site from the Whitelisted Site drop-down (or leave All Sites selected in place).
  3. Select Advertiser from the View By drop-down list.
  4. From the list, click the  to expand the advertiser you want to whitelist.
  5. Select the checkbox for each domain URL within the advertiser you want to whitelist.
  6. Select the checkbox for each domain URL within the advertiser you want to whitelist. It will be moved to the User Actions List.
  7. Click Save.

Whitelist by Category

  1. Select Ad Quality | Whitelist Manager from the main navigation.
  2. Select a specific site from the Whitelisted Site drop down (or leave the All Sites selection in place). The subsequent whitelisting will apply to this selection.
  3. Select Category from the View By drop-down list.
  4. From the list, either select the checkbox for the category to whitelist all advertiser domains in that category or click the  to expand the categories and subcategories you want to whitelist.
  5. Select the checkbox for each Domain URL within the advertiser you want to whitelist. It will be moved to the User Actions List.
  6. Click Save.

Removing URLs from a Whitelist

  1. Select Ad Quality | Whitelist Manager from the main navigation menu.
  2. From the Whitelisted Site drop-down list, select the site from which you want to remove URLs (or leave at All Sites, if applicable).
  3. Select Category or Advertiser from the View By drop-down list and expand the list to the Category or Domain level and deselect the Whitelisted checkbox to remove it from the Whitelist. The status 'Blacklist' will display next to the domain in the User Actions List.
    OR
  4. Select Domain from the View By list and deselect the Whitelisted checkboxes as needed for each.
  5. Click Save.

Bulk Upload a Whitelist

When you have many Advertiser URLs to whitelist for sites, use the Bulk Upload option.

  1. Select Ad Quality | Whitelist Manager from the main navigation menu.
  2. Click the Bulk Upload button.
  3. Download the CSV template and complete it by adding Site (Publisher) URLs and Whitelisted (Advertiser) domains. Save the file and return to the Bulk Upload.
  4. Click Choose File, locate and select the CSV file you modified and click Upload.

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 & Rules |Sites & Tags to add a new one.

Attachments

    Outcomes