Page tree

Versions Compared


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

Table of Contents

Profile defines groups of inventory units that have the same configuration settings.

Example: A website’s home page may have different requirements than its subpages based on user behavior. Users tend to spend little time on a home page of a site, instead, they use it to transition to other subpages where they spend more time digesting content. This may result in different latency requirements for the home page than its subpages. You can configure separate profiles in PubMatic to optimize different latency requirements. 

From the Profile Management tab you can:

  • Create a profile.
  • Create a new version of an existing profile.

Creating a Profile

Add a new profile to OpenWrap when you have a group of inventory that share similar configuration settings.

  1. Select Inventory | > OpenWrap from the main navigation and select the Profile Management tab.
  2. Choose Create Profile.
  3. In the Create Profile dialog box, enter a Profile Name and Comment.

    A red asterisk ( * ) denotes required valuesindicates a required.

  4. Leave Platform set to Display unless you are deploying ads to an AMP page.

    To use OpenWrap with AMP pages see, OpenWrap AMP Support.

  5. Select the Ad Server. OpenWrap supports both UAS and DFP ad servers.
  6. Select a release version from the Release Version drop-down menu. 
    There are two types of releases: Stable and NightlyStable releases go through planned release cycles and testing. Nightly releases are purpose-oriented versions of our wrapper, such as the inclusion of a requested feature or adapter. Nightly releases should be deployed in accordance with our documentation and consultation with PubMatic solutions engineer as necessary.

    GDPR Note: Choose the Release Version Nightly - v11.2.0 or later. See the release notes before using any version. You will receive a warning about using a nightly version, but rest assured this nightly version has been fully tested by PubMatic.

  7. Select the partners that apply to your profile. PubMatic appears by default; to add additional partners, choose the Select Partners drop-down menu, select partner names, then choose Done to add your selections.
  8. Check Send All Bids to send additional key values to the ad server with bid information for every bidder.  This feature is supported only if ad server for the profile is DFP.

    Sending all bids to the ad server is a prerequisite to enabling bid landscape or per partner reporting on the ad server. Sending all bids is also necessary when a publisher wants to provide priority to PMP bids. When Send All Bids is selected, OpenWrap still sets the OpenWrap key values for the winning bid in addition to the per-bidder key values.

  9. Select Enabled for Consent Management (if setting for GDPR compliance).

    OpenWrap only supports Consent Management Platforms (CMPs) that are compliant with the IAB Consent Management Provider JavaScript API v1.1

  10. (If Enabled was chosen in step 8) Choose your timeout and whether to continue the impression auction on CMP failure. For the timeout, choose a long time; for example,10000ms or more if you want to wait to load ads until the user has had a chance to interact with the consent management platform during the first visit to your site.
  11. Choose Save. Status will display DRAFT (Mapping Pending).


Continue with Mapping Ad Units below.

Managing a Profile

  1. Select the Profile Management tab.
  2. Select a profile from the menu.
  3. Choose an option from the Actions menu based on the action you want to perform.

Mapping Ad Units

After adding a new profile or creating a new profile version with additional partners, you will need to create and upload a mapping file for each partner. The mapping process allows the wrapper tag to include a partner-specific identifier (for example, PubMatic requires a site id and ad tag id in the ad call) that allows each partner to understand which ad unit is generating the impression. Partners use this information to apply various settings in their own platform, such as floor price, demand sources, etc.

A mapping file needs to be uploaded for each partner. Template type below refers to the on-page information that the wrapper looks for in runtime and then maps to the partner-specific ids uploaded in the mapping file. There are several template type choices below as mentioned.


Template Type


Ad Unit Name + Size                             

The AD Unit Code of the slot defined for GPT (e.g., /12345/Adunit1/Adunit2/

Size will be Width x Height

Div ID + Size

The Div ID on the page

Size is specified as Width x Height

Div IDOnly Div ID (PubMatic header tag always requires size, therefore this option is not available)
SizeMapping is only for sizes; i.e., for a particular size across all inventory, the same partner tag id/ad unit will be called.

Synchronous and Asynchronous Tags

OpenWrap provides options to generate both synchronous and asynchronous wrapper tags. Synchronous and asynchronous tags determine how the wrapper (and not the underlying header tags) is loaded on the page.

In the synchronous version, the publisher doesn’t have to delay gpt.js load explicitly to ensure pubmatic pwt.js is loaded before it (pwt.js still needs to load before gpt.js)

All the partner calls occur asynchronously in parallel.

On-Page Integration

  1. Select the Ad Server DFP or UAS
  2. Select either Synchronous or Asynchronous.
  3. Copy code from the editable portion of the Document Layout section.
  4. Paste the code into the <head> section of the relevant pages or tag management solution.

⇧ Top