This document provides high-level steps and tips to follow to set up sites and tags individually, and uploading domains to whitelist for an account.
To set up important elements of your account, complete the following steps using the instructions below:
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 through bulk upload or individually. Sites must be added to the PubMatic platform before creating associated ad tags.
- Select Inventory > Sites & Tags.
- Click Add a Site/App.
- Select Web or Mobile Web from the Platform drop-down menu.
Enter the fully-qualified domain for the site.The URL must start with https:// or https:// and contain .com or the equivalent at the end.
Enter a name for the Site Identifier.
- Select Secure if the site is compatible with the HTTPS protocol.
Select a Primary IAB Category from the drop-down menu and Secondary IAB Category, if applicable.
Complete remaining details in the Configuration Preferences section, including:
- Select Monthly Ad Impressions for the site.
Select COPPA Compliant if the app is child-directed.
Check the API Settings box according to the integration type:
Integration type Check the API Settings box? Exchange Bidding (EB) Yes Index integrations Yes Server-to-server Yes Transparent Ad Marketplace (TAM) Yes Prebid integrations Automatically checked
Select Save or Save and Add Another Site.
Upload Domains to Whitelist
Domains for whitelisting can be added at any time, but at least one domain must be whitelisted for a site.
Select Inventory > Sites & Tags from the main navigation.
Select Bulk Uploads > Upload Domains.
- 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.
- Return to the Publisher UI Upload Domains window and click Choose File to locate the file.
- 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. A minimum of "1" should be listed for active sites.
To learn more about managing a whitelist, refer to Whitelist Manager documentation.
Create 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. Ad tags can be added individually using the instructions below or in bulk upload.
- Select Create Ad Tag.
- Select the site or app for which the ad tag will be applied.
Enter the Format Type and Response Code.
- Complete Ad Slot Preferences:
- Ad Placement: Select the placement of the ad relative to the page (Top, Bottom, Middle, Left or Right of Page).
- Fold Placement: Select the placement of the ad relative to the fold (Above the Fold (ATF), Below the Fold (BTF), or Partially above the Fold).
- Expansion: Select the direction the ad will expand (Up, Down, Left or Right).
Add a passback by either using Select Existing Placement and selecting from the list or to add a new passback, choose Provide Passback Script. The PubMatic system will automatically recommend an ad tag name, however, this can be customized as needed.
Note for Exchange Bidding (EB) Ad Tags
When creating EB ad tags, select Provide Passback Script, and add USD 0.0 for eCPM and for the script, simply add <!>.