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. Your apps iTunes URL
  3. 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

  • Platform: iOS
  • App Name: Fill in your app’s name
  • iTunes URL: Enter the app’s iTunes URL. If your app is not live in the App Store yet, you can enter a placeholder URL for testing purposes.
  • Category: Select the most relevant category for your app
    ironsource-mopub-add-app-2

    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

    iOS

     ironSource supports both Cocoapods and Manual download mechanisms.

    Cocoapods

    To integrate the MoPub SDK with Cocoapods, enter the following line in your podfile and you’re good to go!

    pod 'IronSourceMoPubAdapter','4.1.2'

    Manual Download

    1. Download the MoPub Adapter
      Add the MoPub Adapter to your build. You can find the latest MoPub Adapter here. Then, add the MoPub framework to your project by dragging and dropping the adapter framework into your Xcode Project, i.e. drop ISMoPubAdapter.framework into your Xcode project.
    2. Download the MoPub SDK
      Download the Mopub iOS SDK and drag it into your Xcode application group:
      MoPub SDK Drag'n Drop Manual

    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.