You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Bulk Uploading Sites, Ad Tags and Domains

The Publisher UI provides the ability to upload sites, tags, and add whitelisted domains in bulk.

Sites, Tags and Domains can also be added individually in the Publisher UI. For more information about setting up sites and tags individually in the Publisher UI, refer to the Account Setup Guide. Instructions for whitelisting can be found in the Whitelist Manager documentation.

Bulk Upload Sites

Sites are often created for different areas of a website. For example, the home page and subpages for sports, news, entertainment, and more. A publisher will often want to have a unique ad tag for each slot on a page. If you have multiple properties, you may want to set a different site for each. 

Sites can be added in bulk or individually. Sites must be added to the PubMatic platform before creating associated ad tags.


  1. Select Inventory > Sites & Tags from the main navigation.
  2. Select Bulk Uploads > Upload Sites.


  3. Click Download Template.


  4. Open the downloaded file and complete the fields for each site:

     Click here to expand field definitions

    Site/App Domain (The URL must start with https:// or https:// and contain .com or the equivalent at the end)
    Site/App Identifier 
    (This will appear in reporting)
    Platform
     (i.e., Web or Mobile web for sites)
    Primary Vertical or Category 
    (i.e., IAB Category)
    Secondary Vertical or Category 
    (optional)
    Monthly Ad Impressions
    Privacy Policy 
    (URL of privacy policy - optional)
    Is Default Site 
    (Y/N) (Refer to Default Sites & Ad Tags for more information)
    API Setting Enabled 
    (See important note below for integration-specific selections)
    COPPA Compliant 
    (Y if the site is child-directed)
    Is Secure Site 
    (Y if site is compatible with the HTTPS protocol)
    Decision Manager Type 
    (See important note below for integration-specific selections)

  5. Save the file.
  6. Return to the Publisher UI Upload Sites window and click Choose File to locate the file.
  7. Click Upload.
  8. Click Refresh. The message  File updated successfully will appear in the upper-left corner. 
    If not successful, Failed Entries will appear. Click the Failed Entries button to view errors. If you continue to have entries that fail after fixing errors, please contact your Customer Success Manager for assistance.

Important note for integration-specific settings

Set Decision Manager Type and API Settings for the appropriate integration type: 

Exchange Bidding (EB):

    • Decision Manager Type: Select None
    • API Settings: Select the checkbox

Index Integrations:

    • Decision Manager Type: Select  Standard
    • API Settings: Select the checkbox

Prebid Integrations:

    • Decision Manager Type: Select Standard  
    • API Settings: Should then be automatically selected

Server-to Server:

    • Decision Manager Type: Select None
    • API Settings: Select the checkbox

Transparent Ad Marketplace (TAM):

    • Decision Manager Type: Select None
    • API Settings: Select the checkbox

Bulk Upload Domains to Whitelist

Domains for whitelisting can be added at any time, but at least one domain must be added to a site for it to be monetized.

  1. Select Inventory > Sites & Tags from the main navigation.

  2. Select Bulk Uploads > Upload Domains.

  3. Download the template and enter the Site URL (which is the Site Identifier indicated in the Publisher UI) and the Domain URL for each you want to whitelist. 
  4. Return to the Publisher UI Upload Domains window and click Choose File to locate the file.
  5. Click Upload.

After whitelisted domains are added, the Domains column will indicate the number of domains added for each site. "0" in the Domains column indicates that no domains have been whitelisted for a site. 

Bulk Upload Ad Tags

Ad tags are associated with sites that have been added to the PubMatic platform. Typically, publishers create a separate ad tag for each as that will be displayed on a site.

  1. Select Inventory > Sites & Tags from the main navigation.
  2. Select Bulk Uploads > Upload Tags.


  3. Click Download Template.
  4. Open the downloaded file and complete the fields for each site. To view the options for each field, click  to download a file with all options.

  5. Return to the Publisher UI Upload Ad Tags window and click Choose File to locate the file.
  6. Click Upload.
  7. Click Refresh. The message  File updated successfully will appear in the upper-left corner. 
    If not successful, Failed Entries will appear. Click the Failed Entries button to view errors. If you continue to have entries that fail after fixing errors, please contact your Customer Success Manager for assistance.



⇧ Top



⇧ Top

Do you have feedback on this document? Let us know: email us.

Table of Contents