Automated Inventory Quality Scanning & Domain Whitelisting FAQ

Document created by catherine.racette on Mar 14, 2018Last modified by catherine.racette on Jul 16, 2018
Version 11Show Document
  • View in full screen mode

What is Automated Inventory Quality Scanning & Domain Whitelisting?

This feature automates the process by which Channel Partners submit domains for monetization. A list of domains is uploaded to the Publisher UI for scanning by Integral Ad Science (IAS) for inventory quality. Approved domains are automatically onboarded to PubMatic for monetization. A downloadable report is generated with results of approved, rejected, and flagged domains.

The automated process streamlines what was once a manual process involving multiple PubMatic team members and significantly decreases scan time. Additionally, the faster results allow Channel Partners to take corrective actions on rejected sites sooner and rescan them for monetization. This increases workflow efficiency and reduces time-to-monetization for Channel Partners.


How Does it Work?

  1. A Channel Partner logs into the PubMatic platform and uploads a list of domains to be added to existing sites in their PubMatic account using a CSV file. (Navigate to Inventory & Rules | Sites & Tags and select Upload Domains from the Bulk Uploads drop-down list.)
  2. PubMatic processes the domain list file via Integral Ad Science (IAS).
  3. Approved domains are added to the Channel Partner's account in the specified sites.
  4. A downloadable report is generated in the Upload Domains screen with details of all submitted domains; for failed domains, failure reasons are indicated in the report. Failed domains are manually scanned by our Inventory Quality (IQ) Operations team, which if approved, are whitelisted in two business days.
  5. Additionally, users can view and download the details of domains uploaded under individual sites on the Domain Listing page.

How Do I Upload a List of Domains for IAS Scanning?

  1. Select Inventory > Sites & Tags from the main navigation.
  2. Select Bulk Uploads to expand the drop-down list, then choose Upload Domains.
  3. Select Download Template.
  4. Open the downloaded template (CSV file) and update the Site URL, which is the Site Identifier in PubMatic and the Domain/App Store URL, which is the domain to be whitelisted.

    Site URL = Identifier
  5. After saving updates to the template CSV file, return to the Upload Domains page in PubMatic and select Choose File.
  6. Locate the template CSV file and choose Upload
  7. Select the Refresh Button. The message File updated successfully appears in the upper-left corner. 
  8. To check the results of the Inventory Quality check, choose the number of Processed Entries, which downloads a CSV file with the results.

    Downloaded File Sample:

    Additionally, you can check the number of domains whitelisted or view the whitelisted domains for a site on the Sites & Tags page by using View Domains.          

What Fields are Available in the Upload Template?

Field HeadersMandatoryDescriptionExample
Site URLYesSite Identifier added to a given domain.
Domain/App Store URLYesURL of the domain or mobile app store URL you want to the Site (Web) (iOS mobile app)
App DomainNoDomain URL of the mobile app.
Primary CategoryNoID of the domain's or app's primary IAB category. Please refer the table below for the complete list of values.IAB1 (for Arts & Entertainment primary category)

Secondary Categories

(Only if Publisher is IAB enabled)

NoID of the domain's or app's primary IAB category. Please refer to table below for the complete list of values.IAB-1 (for Books & Literature secondary category)
Platform (Web/Mobile Web/Mobile App iOS/Mobile App Android)NoPlatform type of the site under which the given domain needs to be mapped.Mobile App iOS
Site Code (optional)NoThis field is not currently in use and should be ignored.
App NameNoName of the mobile app on the app/play store. This value will be auto-populated by the system later using the app store URL.PubMatic MyReports
App IDNoApp ID of the mobile app on the app/play store. This value will be auto-populated by the system later using the app store URL.577809796
Bundle IDNoBundle ID of the mobile app on the app/play store. This value will be auto-populated by the system later using the app store
App IAB CategoryNoIAB category of the mobile app on the app/play store. This value will be auto-populated by the system later using the app store URL.Business


What are the IAB Primary and Secondary Category IDs for an IAB-enabled publishers?

A complete list of IAB categories is available on the IAB website (in the 5.1 Content Categories section).


What are the PubMatic Primary and Secondary Categories for a Non-IAB publisher? 

  • Automotive
  • Business and Finance
  • Education
  • Employment and Career
  • Entertainment and Leisure
  • Gaming
  • Health and Fitness
  • Home and Garden
  • Men's Interest
  • Music
  • News
  • Parenting and Family
  • Real Estate
  • Reference
  • Food and Dining
  • Shopping
  • Social Networking
  • Sports
  • Technology
  • Travel
  • Women's Interest

How do I View the Status of the Uploaded Domains Under Each Site?

  1. On the Sites & Tags page, choose View Domains.
  2. Use the Domain Status filter drop-down menu to filter the list by status. 
  3. Use the ⓘ icon to view more about the reason for the status. To download a filtered list, use the Download Filtered Domains button.


⇧ Top