Page tree


Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
indent20px
stylenone

Creating a New Site

Sites are created in the system for reporting purposes. The ability to add different sites enables you to receive much more granular reports for your account.

 

Introduction

This guide provides instructions for activities related to setting up publisher accounts in PubMatic. 

Creating Sites, Apps & Ad Tags

Adding sites and apps in PubMatic greatly enhances the granularity of reporting for publishers. Apps are added for mobile applications and sites are often created for different areas of a website (e.g., the home page and subpages for news, entertainment, etc.) Ad tags contain the size, type, relative location and other parameters that define the inventory a publisher wants to display on the site or app.


Tip
Ad tags are associated with specific sites or apps, therefore, add your site or app prior to creating an associated ad tag. 

Creating a New Site

  1. Select Inventory > Sites & Tags.
  2. Select Add a Site/App.
      

    Enter details such as site domain, site identifier (custom name you can give to the site), vertical, estimated ad impressions, etc.

    Image Removed

    Info
    titleAbout COPPA Compliance


  3. Select a Web or Mobile Web from the Platform drop-down menu.
    Image Added

  4. Enter the fully-qualified domain for the site.

    Info

    The URL must start with https:// or https:// and contain .com or the equivalent at the end.


  5. Enter a name for the Site Identifier. This will appear in reporting, therefore, be as descriptive as possible. 

  6. Select Secure if the site is compatible with the HTTPS protocol.
  7. Select a Primary IAB Category from the drop-down menu and Secondary IAB Category, if applicable.

  8. Complete remaining details in the Configuration Preferences section, including:

    - Select Monthly Ad Impressions for the app.
    - Add URL of your privacy policy, if desired.
    - Select COPPA Compliant if the app is child-directed.

    Info

    The United States Federal Trade Commission has changed the compliance rules for the Children’s Online Privacy Protection Act (“COPPA”), effective July 1, 2013. The proposal effects websites and applications that have been identified as: (1) directed to users under 13 years of age; or (2) collecting information from users actually known to be under 13 (collectively “Children’s Sites”).

    For an impression meeting any one of the above-mentioned criteria, the COPPA field must be selected.

    The FTC has written a comprehensive FAQ on complying with COPPA at http://business.ftc.gov/documents/Complying-with-COPPA-Frequently-Asked-Questions.

    - Select API Settings if you are a publisher who integrates with PubMatic through a server-to-server integration.
    - Select RTB for Targeted Campaign Type if this is for a real-time bidding campaign. 

  9. Select Save Site or Save and Add Another Site

  10.  
  11. (to save this and open a new form to complete for another site).

    Image Modified


Creating an App

  1. Select Inventory > Sites & Tags.
  2. Select Add a Site/App.
    Image Added

  3. Select a Mobile App platform (iOS or Android) from the Platform drop-down menu.
    Image Added

  4. Enter the fully-qualified domain for the associated site.

    Info

    The URL must start with https:// or https:// and contain .com or the equivalent at the end.


  5. Enter a name for the App Identifier. This will appear in reporting, therefore, be as descriptive as possible.  

  6. Select Secure if the site is compatible with the HTTPS protocol.
  7. If the app is available in the App Store, toggle Availability on App Store to Yes and enter the App Store URL. Click Lookup on App Store to complete available information below.
  8. Complete remaining details in the Configuration Preferences section, including:
    - Select Monthly Ad Impressions for the app.
    - Add URL of your privacy policy, if desired.
    - Select COPPA Compliant if the app is child-directed.

    Info

    The United States Federal Trade Commission has changed the compliance rules for the Children’s Online Privacy Protection Act (“COPPA”), effective July 1, 2013. The proposal effects websites and applications that have been identified as: (1) directed to users under 13 years of age; or (2) collecting information from users actually known to be under 13 (collectively “Children’s Sites”).

    For an impression meeting any one of the above-mentioned criteria, the COPPA field must be selected.

    The FTC has written a comprehensive FAQ on complying with COPPA at http://business.ftc.gov/documents/Complying-with-COPPA-Frequently-Asked-Questions.

    - Select API Settings if you are a publisher who integrates with PubMatic through a server-to-server integration.
    - Select Override Publisher Data to give higher preference to application information stored in PubMatic over publisher- provided information. 
    - Specify which mobile rich media versions the app supports, if any. 
    - Select RTB for Targeted Campaign Type if this is for a real-time bidding campaign. 

  9. Click Save or Save and Add Another Site.
    Image Added

Creating an Ad Tag

An ad tag is a piece of HTML or JavaScript code that your webmaster or developer inserts into the source code of a web page. There is usually a separate ad tag for each ad that you want to display on your website. You can add an ad tag for every site you add. The more sites/tags you have, the more granular your reporting will be.

  1. Select Inventory > Sites & Tags.
  2. Select Create Ad Tag.


  3. Select the site or app for which the ad tag will be applied. 
  4. Enter the Format Type and Response Code.

    Info
    titleSee also…
    For Video Ads see, Refer to Creating Video Ad Tags in PubMatic.
    For Native Ads see,  below for options related to creating ad tags for video ads in PubMatic.
    Refer to Creating Native Ad Tags in PubMatic below for options related to creating ad tags for native ads in PubMatic.


  5. Complete 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).
  6. Select User Data Parameters. For Mobile/Video, add details such as location, DMA, and so on, adding as many details as possible.
  7. 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. 

    Warning
    titleEvery tag requires a passback…
    This ensures that if PubMatic doesn’t fill an ad space, the system will prevent a blank ad occurrence.


Downloading Ad Tags

To download ad tags, select each in the left-hand column, then choose Download Selected Tag Codes. If more than one tag is selected, all will be placed in the same .txt file that downloads to your local drive.

Info
The JavaScript, Iframe, and HTML ad tags for Desktop and Mobile Banner ads now contain the kadGdpr and kadGdprConsent fields, while the Desktop and Mobile Video ad tags will contain the gdpr and gdpr_consent fields. 

If the kadGdpr or gdpr field is set to 1, then it indicates that the given impression must be subjected to the GDPR compliance process. If set to 0, then the given impression is not GDPR compliant and will be processed as usual. 

The kadGdprConsent and gdpr_consent fields should contain the visitor’s GDPR consent data; that is, whether they have provided their consent for being targeted or not.

Ad Network Addition & Mapping

If you are working with an Ad Network, use these instructions to add them to the PubMatic system.

  1. Select Inventory > Ad Networks and Placements from the main navigation.
  2. Select Link Ad Network.


  3. Select Filters to expand the section, enter the name of your Ad Network in the Find box and choose Go to search for it.
  4. Once the Ad Network is located choose,  .
  5. Complete the Add Placement details and edit the auto-populated name, if required, and choose  Save Placement or Save and Add Another Placement .

Mapping Ad Network Placements to an Ad Tag

  1. Select Inventory > Sites & Tags  from the main navigation.
  2. Select the Ad Tags tab and select the Ad Tag you want to map to a placement.
  3. Select Edit Ad Network Mapping.
  4. Select Select Ad Networks.
  5. Select the desired Ad Network. Then select the Placement it is associated with and choose  Save.
     

     
    (The placement should be added to the list of mapped placements.)

  6. Select  Save. The Ad Network Placement is now successfully mapped to the Ad Tag.

Info

You can also confirm the mapping is successful by using View Placements on the Ad Tags page.

Passback Management

The process to add passback tags is similar to adding Ad Network tags. There are two ways to add passbacks:

  • Add a passback from the Ad Tag editing screen.
  • Add a passback Ad Network variant followed by the passback tags as placements. You can further map those placements to the respective ad tags.

Brand Control: Blocklist Manager

Blocklist Manager helps you avoid the display of unwanted creative to your visitors by blocking the advertiser, advertiser category, domain URL and/or creative attributes. Blocklist Manager enables you to view the domain URLs for an advertiser and block/unblock accordingly.

 

For instructions and best practices for using Blocklist Manager, refer to the following documentation in the Quality Controls section of the community:


Whitelisting Advertisers

The Whitelist Manager enables the display of specific creative to visitors by whitelisting URLs, advertisers or advertiser categories. The Whitelist Manager displays the advertiser URL for you to enable or disable for whitelisting. This process facilitates a safe and time-saving whitelisting of URLs within the PubMatic interface. 

The Whitelisting feature must be enabled on your account. If you would like to enable whitelisting for your account, contact your Customer Success Manager or Customer Success Operations Manager.

Using the Whitelisting Feature, you can:

  • Whitelist domain URL, advertiser, or advertiser category for all sites or select just a single, specific site.
  • View available domain URLs for whitelisting and can enable/disable the whitelist as needed. Note: if you disable the whitelist for a website, the blocklist configuration will be applicable for your inventory.
  • View, schedule, download and email whitelisted advertiser categories, advertiser and domain URLs for all or any specific sites.

For instructions and best practices for using Whitelist Manager, refer to the Whitelist Manager documentation in the  Quality Controls  section of the community.