Documentation

Support

Unity LevelPlay

Get started with LevelPlay

SDK integration

LevelPlay platform

Unity LevelPlay

Integrate PubMatic with LevelPlay

Learn how to integrate PubMatic with your LevelPlay-enabled iOS app
Read time 3 minutesLast updated 8 days ago
Learn how to integrate PubMatic with your LevelPlay-enabled iOS app. It walks through account setup, app configuration, ad unit creation, and adapter installation in LevelPlay. Follow the steps below to ensure your ad placements are correctly configured for PubMatic bidding.

Prerequisites

Make sure you can access the PubMatic monetization dashboard and your LevelPlay project in the Unity Dashboard. You must also have an iOS app ready to configure.

Topic

Description

Create a PubMatic accountSet up your PubMatic publisher profile
Create an app and ad unitsAdd your app and configure monetization
Activate PubMatic in LevelPlayConnect PubMatic to your project
Add the PubMatic adapter (ios)Add the iOS Pubmatic SDK adapter
Handle user consentGDPR and GPP behavior

Create a PubMatic account

To create a PubMatic account, reach out to PubMatic at sdk-support@pubmatic.com. The PubMatic team will assist you with account creation and approval for Pubmatic inventory through LevelPlay. Once your account is approved, sign in to the Pubmatic monetization dashboard. If you already created ad units in your Pubmatic monetization dashboard, skip to Activate PubMatic in LevelPlay.

Create an app and ad units

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

Add your app

  1. Log in to the Pubmatic monetization dashboard.
  2. Select Set Up > Apps.
  3. Click Add App.
  4. In the General section:
    • Select iOS as the platform.
    • Enter a valid App Store 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.
    • Complete any additional fields that appear.
  6. In the Advanced section:
    • Ensure the currency is set to USD.
  7. Click Add App.

Create ad units

  1. Select Set Up > Ad Units.
  2. Select your app. The ad units associated with the app will display.
  3. Click Create Ad Unit.
  4. Enter an ad unit ID.
  5. Select an ad format and complete the 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

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

Activate PubMatic in your LevelPlay setup

After configuring your app and ad units in PubMatic, activate Pubmatic inside LevelPlay to link your 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:
    • Publisher ID: found in your PubMatic publisher account
    • Profile ID: found on the Apps page
    • 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 LevelPlay Setup dashboard.

Add the PubMatic adapter

To complete the bidder integration, add the PubMatic SDK and the LevelPlay PubMatic adapter to your iOS project. There are two ways to do so, by using CocoaPods or manually integrating the SDK and adapter into your project.

Integrate with CocoaPods

Add this line to your Podfile to integrate the PubMatic adapter to LevelPlay: 
pod '<LevelPlayPubMaticAdapter>'
Run the following code to install the adapter and SDK: 
pod install --repo-update

Manual integration

  1. Download the latest PubMatic SDK for iOS.
  2. Add all required .xcframework files and bundles to your project.
  3. Download the latest LevelPlay PubMatic adapter.
  4. Follow the manual integration steps once the adapter instructions are finalized.

Handle user consent

  • Pubmatic SDK retrieves GDPR values using the IAB TCF 2.0 standard through shared preferences or user defaults, ideally via a CMP SDK.
  • Pubmatic also supports the IAB GPP standard for retrieving GPP consent signals.
  • Refer to the Pubmatic SDK Advanced Topics for information on passing consent values.