PubMatic Integration Guide

This guide will instruct you step-by-step on how to set up PubMatic as an Ad Network on Unity LevelPlay.

Step 1: Create a PubMatic account

1. Go to the PubMatic website and create an account.
2. Wait for your account to be approved.
3. Sign in to the Pubmatic monetization dashboard.

Step 2: Create an app and ad units

Add your app

Add your app and configure your ad units in the PubMatic dashboard before you can activate PubMatic in LevelPlay.

1. Log in to the Pubmatic monetization dashboard.
2. Select Set Up > Apps.
3. Click Add App.
   
4. In the General section:
   • Select Android as the platform.
   • Enter a valid Google Play URL.
   • Review or edit the auto-generated app name
5. In the Configuration section:
   • Select your Integration Path.
   • Set Sub-Integration Path to “LevelPlay – SDK Bidding”.
6. In the Advanced section:
   • Ensure the currency is set to USD.
7. Click Add App.
   

Create ad units

After adding your app, create individual ad units that LevelPlay will request during bidding.

1. Select Set Up > Ad Units.
2. Select your app to view its ad units.
3. Click Create Ad Unit.
   
4. Enter an ad unit ID.
5. Select an ad format and complete any required fields.
6. Click Save or Save & Create Another.
   

PubMatic generates an ad unit ID, which appears in the Ad Units section.

Manage bidder partners

Review which bidder partners have access to your ad units.

1. Select Set Up > Bidder Partners.
2. Select your app.
3. Enable or disable ad units for each bidder partner using the toggles.

Step 3: Activate PubMatic in your LevelPlay setup

After configuring your app and ad units in PubMatic, activate the PubMatic network inside LevelPlay to connect your PubMatic credentials to your placements.

1. In LevelPlay, open Monetize > Setup > SDK Networks.
2. Select Pubmatic from the list of available networks.
3. Enter the required parameters, click Activate, then Save.
4. Select Pubmatic again from your configured networks and click Setup.
5. Enter the following values from your PubMatic dashboard:
   1. Publisher ID: found in your PubMatic publisher account
      
   2. Profile ID: found on the Apps page
      
      
   3. Ad Unit ID: found in the Ad Units section
6. Set the status to Active and click Save.

PubMatic now appears as active for mediation on your Setup dashboard.

Step 4: Add the PubMatic adapter to Your Build

To complete the integration, add the Pubmatic SDK and the LevelPlay PubMatic adapter to your Android project.

Gradle

1. Make sure the following Maven URL exist in your build.gradle script of your app module.

   repositories {
       mavenCentral()
       maven {
           url 'https://repo.pubmatic.com/artifactory/public-repos' 
       }
   }

2. Add the adapter’s Maven name to your build.gradle script of your app module.
   

   dependencies {
       implementation 'com.unity3d.ads-mediation:pubmatic-adapter:5.0.0'
       implementation 'com.pubmatic.sdk:openwrap:4.10.0'
   }

Manual integration

1. Download the latest version of the PubMatic OpenWrap SDK for iOS and link all the .xcframework files and bundles in your project.
2. Add the PubMatic Adapter to your build. You can find the latest PubMatic Adapter here.
3. Make sure you add the following to your Gradle build file under the dependencies section
   

   dependencies {
       implementation 'com.unity3d.ads-mediation:pubmatic-adapter:5.0.0'
       implementation 'com.pubmatic.sdk:openwrap:4.10.0'
   }

Step 5. PubMatic Additional Settings

User-level COPPA

Unity LevelPlay let’s publishers communicate PubMatic User-level COPPA settings directly to the PubMatic network. This feature is enabled using LevelPlay SDK 9.0.0+, PubMatic iOS Adapter 5.0.0+.

Use the following syntax, to set PubMatic COPPA with the parameter True:

LevelPlay.setMetaData("LevelPlay_ChildDirected","true");

Use the following syntax, to set PubMatic COPPA with the parameter False:

LevelPlay.setMetaData("LevelPlay_ChildDirected","false");