Page tree

OpenWrap now supports delivering mobile in-app ads on Android and iOS devices integrated with PubMatic's OpenBid SDK.

About OpenBid Integration

The OpenBid SDK lets you leverage PubMatic's robust platform of OpenWrap capabilities within your mobile app. Publishers who want to increase monetization and access the broadest set of exchanges and unique demand, use OpenWrap's transparent enterprise wrapper solution for Prebid. OpenWrap simplifies partner management with an intuitive UI. Enterprise grade analytics and a dedicated support team help you optimize your inventory's monetization. OpenBid takes the power of OpenWrap mobile.

The sections below describe the processes for creating the OpenWrap profile required to integrate OpenBid SDK in your mobile app.

Create an OpenWrap Profile for Mobile In-App

  1. Login to the PubMatic UI portal with your account credentials. If you're unsure of your account credentials, contact to your account manager for assistance.
  2. From the main navigation select, Inventory > OpenWrap.

2. Switch to the Profile Management tab, then choose, Create Profile.

3. Enter a  Profile Name , set Platform to Mobile In-app, then set AdServer to a supported ad server; for example, DFP.

4. 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. Choosing the Mobile In-App platform automatically filters the list of available partners to only those who can monetize in-app traffic.

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

6. Next enter a Refresh Interval. Choose an interval of 15-to-120 seconds (whole numbers only), that determine how long a banner remains onscreen before it refreshes with a new ad. The Refresh Interval applies to all banner ad units served by this profile.

Refresh Interval does not apply to interstitial ads…

Because interstitial ads do not support auto-refresh.

7. Choose Save. The Status column displays, DRAFT (Mapping Pending).

If you want to review/change the details of your profile and partners, see Managing a Profile below.

Manage 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: Edit, to change the profile, or Map Ad Units (described below). 

Map 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. The table below describes the template you'll use for mobile in-app.

Template Type


Ad Unit Name + Size

(Currently the only type available for Mobile In-App.)

The AD Unit Code of the slot defined for DFP; for example, /12345/Adunit1/Adunit2/

Size will be, Width x Height

When mapping ad units for interstitial ads…

You must map the predefined ad sizes for each device type on which the interstitial ad will display:

  • 320 x 480 and 480 x 320 for mobile phones.
  • 1024 x 768 and 768 x 1024 for tablets.

In-App Integration

After you have created your Mobile In-App profile, you can link directly to the OpenBid SDK documentation for your target mobile platform.

  1. Select the Tag Management tab.
  2. Choose your Mobile In-App profile from the Select a profile drop-down menu.
  3. Use the Android and iOS links to view the OpenBid SDK documentation for integration instructions for your platform.

The OpenBid SDK documentation demonstrates how to integrate ad support in your app by adding code that includes your Publisher ID, Profile ID, and Ad Unit ID. First complete the requirements documented in the Getting Started guide, then use the instructions and code samples in the following documentation sections to learn how to integrate one or more ad types in your app:



⇧ Top