Page tree

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, then select the Profile Management tab.
  2. Choose Create Profile.
  3. In the Create Profile dialog, enter a Profile Name and Comment.

    A red asterisk (*) indicates a required entry.

  4. Select a radio button for your target Platform, then expand the matching instructions below:


    Continue with step 5 below.


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

     Video (VAST)…

    The process of defining a video ad in OpenWrap is to create a profile and generate an ad tag as you normally would in DFP, then append video-specific parameters to the tag. Continue to step 5 below, and choose DFP as your ad server. After you have created your profile and ad tag, see OpenWrap for Video for details about appending video-specific parameters to your tag.

     Mobile In-App…
    1. Select your AdServer from the picker list. PubMatic's mobile in-app SDK 6.0 currently supports only DFP.
    2. Open the Select Partners picker to choose partners from the list, or search for partners. The selected partner list on the right contains PubMatic by default. Mobile in-app filters the list of available partners to only those who are configured to support server-side transactions.
    3. Select a partner from the left to move them into the selected list. Select Done when you have finished selecting partners to add to your profile.
    4. Next enter a Refresh Interval. Choose an interval of 15-to-120 seconds (whole numbers only), that determine how long a banner remains on a user's display before it refreshes with a new ad. Interstitial ads do not refresh.
    5. Choose Save. The Status column displays, DRAFT (Mapping Pending).
    6. If you want to review the details of your profile and partners, see Managing a Profile below.

    Ready for the next step…

    Continue with the Mapping Ad Units section below.

  5. Select your AdServer. OpenWrap supports both UAS and DFP ad servers.
  6. Select a release 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 PubMatic's wrapper, such as the inclusion of a requested feature or adapter. Deploy nightly releases in accordance with our documentation and consultation with a PubMatic solutions engineer as necessary.

    GDPR Note…

    Choose 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 versions are fully tested by PubMatic.
  7. Select 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 supports only Consent Management Platforms (CMPs) that are compliant with the IAB Consent Management Provider JavaScript API v1.1
  10. If you did not check Send All Bids in step 8, skip to the next step. Otherwise 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. The Status column displays, DRAFT (Mapping Pending).

Ready for the next step…

Continue with the Mapping Ad Units section below.

Managing a Profile

  1. Select the Profile Management tab.
  2. Select a profile using the Select Profile picker.
  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 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, and so on.

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; for example, /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; that is, 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), loads on the page.

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

All 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