Page tree

Bulk Uploading Sites, Ad Tags and Domains

Page Tree

The Publisher UI provides the ability to upload sites, tags, and add allowlist domains in bulk. This can save time when setting up the details of an account in PubMatic.

Default sites and ad tags are not available in the Download Sites and Download Ad Tags templates.

To complete the setup process:

  1. Add sites to your account.
  2. Add domains to allowlist.
  3. Create ad tags.

Sites and Tags 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.

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 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:

    FieldDescription
    Site/App DomainThe URL must start with https:// or https:// and contain .com or the equivalent at the end.
    Site/App IdentifierThis will appear in reporting.
    PlatformWeb, mobile web, or CTV
    Primary Vertical or CategoryEnter the IAB Category.
    Secondary Vertical or CategoryOptional
    Monthly Ad ImpressionsExpected monthly ad impressions.
    Privacy PolicyURL of privacy policy - optional.
    Is Default SiteRefer to Default Sites & Ad Tags for more information.
    API Setting Enabled (Y/N)Always set to Yes (Y)
    COPPA CompliantEnter Y if the site is child-directed.
    CTV AppStore (Roku/Other)Enter Roku or Other in this column.
    Availability on App Store (Y/N) Enter Y, since we don't support Roku apps that don't exist in the Roku app store. If you do want to add an app that doesn't exist in the Roku app store, then you should enter Other in the CTV AppStore (Roku/Other) column and N in this column.
    AppStore URL/Android Bundle ID/iOS App ID

    For Roku apps, enter the Roku app store URL or the Roku channel ID.

    For Other apps, enter the app store URL. You need to also enter either the CTV Bundle ID or the CTV App ID.

    CTV Bundle IDFor Other apps, enter the bundle ID. If you don't have the bundle ID, enter the app ID in the CTV App ID column.
    CTV App IDFor Other apps, enter the app ID. If you don't have the app ID, enter the bundle ID in the CTV Bundle ID column.
    Is Secure SiteEnter Y if site is compatible with the HTTPS protocol.
  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.
  9. Continue to upload allowlisted domains using the instructions below for Bulk Upload Domains.

Bulk Upload Domains 

Domains for allowlisting can be added at any time, but at least one domain must be allowlisted for a site.

  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 allowlist. 
  4. Return to the Publisher UI Upload Domains window and click Choose File to locate the file.
  5. Click Upload.

After allowlisted 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 allowlisted for a site. A minimum of "1" should be listed for active sites.

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.

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


  3. To add ad tags, click Download Template.
    To update ad tags, click Download Ad Tags.
  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

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

Table of Contents