MoPub Mediation Integration Guide

This guide will instruct you step-by-step on how to set MoPub live as an Ad Network on the ironSource Mediation platform.

Before You Start 

Make sure you have correctly integrated ironSource’s Rewarded Video into your application. 

Step 1. Create a MoPub Account

First Time Setup

Go to the Mopub platform to create an account and sign up for MoPub Marketplace.  To be approved to the MoPub Marketplace, send an email to policy@mopub.com with the subject line “Ironsource – MoPub Marketplace Approval”and cc support@mopub.com.  Make sure to include the following details in your email:

  1. Up-to-date payment information
  2. Screenshots of the app in your Admin page to show that you are the owner of the account

Registered Users

  1. Sign into your Mopub Account
  2. Navigate to the Apps tab

 

ironsource-mediation-mopub-dashboard

Step 2. Add Your Application

You must add the app you’d like to run Rewarded Video on to your MoPub account. If you’re a returning user and the app has already been added to your account, you may skip to Step 3.

If it’s your first time adding an application, simply click on ‘Get Started‘.
ironsource-mopub-add-app
As a returning user, under Apps, on the top right corner, select ‘Add New App‘ :
ironsource-mopub-add-new-app

App Details

Define the Ad Unit

  • Device: Phone
  • Format: Rewarded Video
  • Name: Fill in a name for this ad unit placement
    ironsource-mopub-ad-unitYou can skip the Ad Unit settings on the right-hand side as Frequency Caps and Rewards will be set on the ironSource platform.
  • Select ‘Save and View Code Integration
  • You will then be directed to the below window with your Ad Unit ID. Reserve this data for future use on the ironSource platform and ignore the code integration instructions by clicking ‘All Done!‘.
    ironsource-ad-unit-id

Step 3. Activate MoPub on the ironSource SDK Network Module

API Key This is a unique identifier for your MoPub account.
Inventory Report ID This is the unique identifier for the ad unit inventory served through MoPub which allows the ironSource Mediation Platform to import performance data from your MoPub account to use in reporting & optimization.
Ad Unit ID The unique identifier for your ad unit in MoPub’s system.

Once you obtain this information, you must configure MoPub’s Parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of MoPub ad inventory and reporting data on the ironSource Mediation platform.

  1. API Key & Inventory Report ID
    Navigate to the Reports tab. Check the box to ‘Enable data access through API‘ and click ‘View API Access Details‘.
    ironsource-mopub-reports-dashboardThe following window will open where you can find your API Key and Inventory Report ID:
    ironsource-mopub-reporting-api-access
  2. Ad Unit ID

    1. You can find your Ad Unit ID by navigating to the Apps tab and clicking on the relevant app.
      ironsource-mopub-apps-app-id
    2. You will then see an Ad Unit Summary table with your configured Ad Units. Click on the relevant ad unit to open the Ad Unit Details:ironsource-mopub-ad-unit-summary
    3. Then, click on the Code Integration button to view your Ad Unit ID:ironsource-mopub-app-details
      ironsource-mopub-ad-unit-id-details

 

Configure MoPub’s Parameters into ironSource Account

  • Once you have all of these parameters, log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘SDK Networks‘. Select MoPub from the list of Available Ad Networks:
    ironsource-sdk-networks-setup
  • Then enter your MoPub API Key and Inventory Report ID. You can also choose to activate MoPub ad inventory for all countries or specify to activate it in select countries. Then click ‘Save‘:
    ironsource-mopub-account-settings
  • MoPub will be enabled in the Available Ad Networks list and you can define the app settings in the setup module below by clicking on the ‘Define‘ icon:
    ironsource-sdk-networks-setup-define-mopub
  • Enter the Ad Unit ID, set the Status to Active and click ‘Save‘:
    ironsource-mopub-app-settings
  • You will then see MoPub as Active for Rewarded Video:
    ironsource-sdk-networks-mopub-activated
  • Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed and No Response. Double check your integration and the information you entered above; then click ‘Retry‘ until you see ‘Verified’.

Step 4. Add the MoPub Adapter to Your Build

Unity Plugin (Android Integration)

 MoPub requires support-v4-[version].jar, android-support-annotations.jar, and android-support-v7-recyclerview.jar to be included in your application. If it’s not already included, please make sure to add it as well.
  1. Download the Mopub Unity Package:
    Import the IronSourceMopubAdapter_[version].unitypackage to your Unity project. You can find the latest Mopub Unity Package here.
  2. Add the Mopub files to your Unity project:
    1. To add the adapter, simply double click on the IronSourceMopubAdapter_[version].unitypackage and add all files to your Unity project.
      Note: If you are upgrading from a previous version, please remove Mopub.x.x.x.jar from Assets/Plugins/Android.
  3. Update AndroidManifest.xml
     <activity
                android:name="com.mopub.mobileads.MoPubActivity"
                android:configChanges="keyboardHidden|orientation|screenSize" />
     <activity
                android:name="com.mopub.mobileads.MraidActivity"
                android:configChanges="keyboardHidden|orientation|screenSize" />
     <activity
                android:name="com.mopub.common.MoPubBrowser"
                android:configChanges="keyboardHidden|orientation|screenSize" />
     <activity
                android:name="com.mopub.mobileads.MraidVideoPlayerActivity"
                android:configChanges="keyboardHidden|orientation|screenSize" />

For ProGuard Users Only 

If you are using ProGuard with the MoPub adapter, you must add the following code to your ProGuard configuration (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt):

keepclassmembers class com.mopub.** { public *; }
keep public class com.mopub.**
keep public class android.webkit.JavascriptInterface {}

Unity Plugin (iOS Integration)

  1. Download the Mopub Unity Package:
    Import the IronSourceMopubAdapter_[version].unitypackage to your Unity project. You can find the latest Mopub Unity Package here.
  2. Add the Mopub files to your Unity project:
    To add the adapter, simply double click on the IronSourceMopubAdapter_[version].unitypackage and add all files to your Unity project.
     Note: If you are upgrading from a previous version, please remove Mopub.x.x.x.framework from Assets/Plugins/iOS.
    Our Unity Plugin adds the necessary frameworks automatically to your Xcode project.
  3. After exporting your project into Xcode:
    Select the project root folder, Find the Embedded Binaries section and click the + button. Then select MoPubSDKFramework.framework and click Add.
  4. Go to your project’s build settings and set “Enable Bitcode” to NO.

Done!
You are now all set to deliver MoPub Ads within your application!


What’s Next?

To add additional mediation Ad networks, integrate the ironSource adapters and follow our integration guides.