InMobi Mediation Integration Guide

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

Before You Start

Make sure you have correctly integrated ironSource‘s Rewarded Video or Interstitial into your application.

Step 1. Create an InMobi Account

  1. Create an account with InMobi. You can do so here.
  2. Once your account has been verified you can login at their partner login here.

Step 2. Create an Application and Placement in InMobi

To configure your application on InMobi, complete the following steps:

  1. Create an Application

    1. After you login you will immediately see the ‘Add an App’ option:
      Supersonic Mediation with Inmobi Add AppYou can enter the URL of your app in the AppStore or Google Play and select ‘Look Up‘.
    2. Alternatively, if your app is not live yet, select ‘Have an app that isn’t yet published?
      You can then manually enter your application’s name and select its platform:
      Supersonic Mediation Inmobi Info
      Please check the box if your app is specifically directed to children under the age of 13 for specific filtering and targeting reasons.
    3. Once finished select ‘Add App‘.
      Note: You will need a unique InMobi application per platform (iOS + Android) just like you do with your ironSource account.
  2. Create a Placement

    Once you have created an application, you must create a Placement. Placements are locations to which InMobi will deliver specific Ad-types. This will be the placement in your app where you have configured the ironSource Rewarded Video or Interstitial to trigger.

    1. For Video Ads, select ‘Rewarded Video’, and then ‘Create Placement‘:
      Supersonic Mediation Integration Inmobi Placement
    2. For Interstitial Ads, select ‘Interstitial’, and then ‘Create Placement‘:
      IM Supersonic IS Mediation Placement
    3. After you create the Placement you will see the details about this placement. Select ‘Proceed to Integration‘:
      Supersonic Mediation Inmobi Integration
  3. Finalize the App Setting

    The final section in the app setup is ‘Integrate and Test‘. ironSource provides an Adapter for the InMobi SDK with all the code pre-written, so there isn’t any integration work you need to do at this stage. Simply choose ‘Other‘ as your development platform and select ‘Done‘.
    Supersonic Mediation Inmobi Finalize

Step 3. Activate InMobi in Your ironSource Network Setup Module

There are 5 pieces of Data from the InMobi account which need to be input into your ironSource Network Setup Module in order for InMobi to work correctly in connection with ironSource:

Username This is the username you use to login to your InMobi account. This is required for ironSource to access the InMobi reporting API for your account, which allows your ironSource Mediation Platform to import performance data from your InMobi account to use in reporting & optimization.
Password  This is the password you use to login to your InMobi account. This is required along with the username in order for ironSource to access reporting information for your account.
API Key This is the unique key to verify requests made for reporting info.
Account ID This is the unique identifier for your InMobi account.
Placement ID This is the unique Placement to which InMobi will deliver ads to.

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

  1. Username

    This is the username you use to log in to your InMobi account.

  2. Password

    This is the password you use to log in to your InMobi account.

  3. API Key

    This is the unique key to verify requests made for reporting info. To receive this info, email InMobi at ‘helpdesk@inmobi.com‘ and they will provide this parameter for your account.

  4. Account ID

    This is the unique identifier for your InMobi account. To locate this parameter, hover over the Drop-down arrow in the top right-hand corner of your admin panel. You will then see your ‘Account ID‘ listed:
    Supersonic Mediation Integration Inmobi ID

  5. Placement ID

    To find your applications ‘Placement ID‘, select ‘Monetize‘ from the top navigation header ➣ select the relevant app from your list ➣ select the name of the relevant placement for this app. A pop-up dialog will open the listing of ‘Placement ID‘:
    Supersonic Mediation Inmobi Placement ID

 

Configure InMobi’s Parameters into ironSource Account

Once you obtain the above parameters, log in to your ironSource account.

  • Go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.
    ironsource-platform-mediation-network-setup
  • Select InMobi from the table of Available Ad Networks.ironsource-platform-select-mediation-network-inmobi
  • Enter your InMobi ‘Username‘ , ‘Password‘ , ‘API Key‘ and ‘Account ID‘ in the relevant fields.
    ironsource-platform-account-settings-inmobi
  • Select the app on which you’d like to run ironSource’s Interstitial Mediation with InMobi.
  • Scroll down to InMobi from the Setup list of Ad Networks and click on the ‘Define‘ icon. Enter the Placement ID, under the Rewarded Video or Interstitial Settings. Set status to Active and click ‘Save’.
    ironsource-platform-define-app-settings-inmobiironsource-platform-app-settings-inmobi
  • You will then see InMobi as Active for Mediation on your Setup Dashboard.
    ironsource-platform-mediation-activated-inmobi
  • New! 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 InMobi Adapter to Your Build

Android

ironSource supports both Gradle dependencies and manual download mechanisms.

Gradle

  1. Make sure the following Maven URL exist in your build.gradle script of your app module (should appear only once for all the adapters).
    repositories {
    maven {
    url "https://dl.bintray.com/ironsource-mobile/android-adapters"
    }
    }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies {
      compile 'com.ironsource.adapters:inmobiadapter:3.2.0@jar'
    }

Manual Download

 

  1. Download the InMobi Adapter:
    Add the InMobi Adapter to your build. You can find the latest InMobi Adapter here.
    Important! The InMobi Adapter also contains the InMobi jar. You DON’T need to additionally add the InMobi jar directly.
  2. Add the InMobi Adapter to Your Project:
    After you download the Adapter; drop the InMobiAdapter jar into the libs folder in your Android Project.
  3. Add the following to your Gradle build file under the dependencies section:

    compile files('libs/inmobiadapter:3.2.0@jar')

Step 5. Update AndroidManifest.xml

Manifest permissions: (Optional)
Add the following permissions inside the manifest tag but outside the<application>tag:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Manifest activities:
Add the following activities inside the <application>tag on your manifest:

<activity
    android:name="com.inmobi.rendering.InMobiAdActivity"
     android:configChanges="keyboardHidden|orientation keyboard|smallestScreenSize|screenSize|screenLayout"
       android:hardwareAccelerated="true"
       android:resizeableActivity="false"
       android:theme="@android:style/Theme.NoTitleBar"
       tools:ignore="UnusedAttribute" />
<receiver 
android:name="com.inmobi.commons.core.utilities.uid.ImIdShareBroadCastReceiver"
android:enabled="true"
android:exported="true"
tools:ignore="ExportedReceiver">
<intent-filter>
<action android:name="com.inmobi.share.id"/>
</intent-filter>
</receiver>

Evaluate Your Ad Network Integration

  • Verify your ad network integration with our Integration Helper. The ironSource SDK provides a tool to ensure you’ve successfully integrated our SDK as well as any additional network adapters.
  • Manage the debug logs for your integrated mediation ad networks with this boolean

    IronSource.setAdaptersDebug(true);
  • When set to TRUE, this line of code will enable debug logs to help you troubleshoot issues with all of your mediation ad networks. Remove this code before your app goes live with our ad units! Supported for SDK versions 6.5.2 and up.

Done!

You are now all set to deliver InMobi Ads through the ironSource Mediation platform!


What’s Next?
To leverage additional ad networks through ironSource Mediation, integrate the adapters and follow our integration guides.