Mintegral Integration Guide

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

Before you start

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

Step 1. Create a Mintegral Account

  1. Create an account with Mintegral. 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 in Mintegral

Already set up your application(s) at Mintegral? Skip to here.

First Time Setup Process
If this is your first time setting up a Mintegral account, continue below.

  1. Login
    1. When you log in for the first time, select ‘APP Setting
  2. Add Your App
    1. Upon clicking ‘+ Add APP’, a setup module will appear, Configure your app settings (Choose Ironsource as mediation platform)
      Note: Note: You will need a unique Mintegral application per platform (iOS + Android) just like you do with your ironSource account.
    2. After you defined the settings, you can choose to check the ad types you DO NOT wish to be delivered to your application.
  3. Add placements
    1. After you defined the Applications settings, select the relevant Apps through dashboard and click ‘Placement Management‘:
    2. click on ‘Add Placement’ button for adding new placements
    3. Mintegral adapters can serve  Rewarded Video, Interstitial and Banner. Choose the ‘AD format’ according to your needs
      For Banner,  It is highly recommended to set the “Auto Refresh” value for No, since you can control the refresh rate on the mediation platform.
    4. Define your ad unit. As Mintegral network is a bidder only, you must choose ‘Header Bidding’ as the Bidding Type

Step 3. Activate Mintegral in Your ironSource Network Setup Module

Serving Mintegral’s ads through the ironSource mediation platform has never been this easy. Sign in to your Mintegral account when setting up Mintegral on the ironSource SDK Networks setup page.

There are values from your Mintegral account which need to be inserted into your ironSource network setup module in order for Mintegral to work correctly in connection with ironSource:

App Key
The unique ID assigned to your app on Mintegral’s dashboard.
SKey
API key for reporting
Secret
The unique ID assigned to your Mintegral user.

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

If you don’t find the SKey or Secret values feel free to contact developer@mintegral.com or your account manager on Mintegral.

App Key

Once you have created an application in the Mintegral dashboard (as described in step 2), go to the ‘APP Setting’ screen – on top of this page, you will find your App Key:

SKey + Secret

Once you have logged into your Mintegral user (as described in step 1), go to the ‘API Tools’ under ‘Account’ tab – on the Upper menu:
Now, on the bottom of the page you can find your SKey, as well as your Secret:

Step 4. Add the Mintegral App level parameters to your app setup

  1. On SDK network page, choose the application you would like to configure, and click on ‘Setup’ under Mintegral bidder
  2. App level configuration will pop-up , and you will need to insert the following parameters for each app you would like to monetize with Mintegral
    1. App ID
    2. Placement ID
    3. Ad Unit ID
  3. Get all the parameters from you Mintegral account
    1. App ID
    2. Placement ID
    3. Ad Unit ID

Step 5. Add the Mintegral Adapter to Your Build

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 {
    // For China Traffic app, Android X Version
     maven {
           url 'https://android-sdk.is.com/'
           url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_china"
     }
     // For the non-China Traffic app, Android X Version
     maven {
            url 'https://android-sdk.is.com/'
            url  "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea"
     }
    }

  2.  Add the adapter’s Maven name to your build.gradle script of your app module.
    // For the China Traffic app, add Mintegral Network
    implementation 'com.ironsource.adapters:mintegraladapter: 4.3.11'
    implementation 'com.mbridge.msdk.china:mbbid:16.2.62'
    implementation 'com.mbridge.msdk.china:reward:16.2.62'
    implementation 'com.mbridge.msdk.china:mbbanner:16.2.62'
    implementation 'com.mbridge.msdk.china:newinterstitial:16.2.62'
    
    
    // For the non-China Traffic app, Add Mintegral Network
    implementation 'com.ironsource.adapters:mintegraladapter:4.3.11'
    implementation 'com.mbridge.msdk.oversea:mbbid:16.2.61'
    implementation 'com.mbridge.msdk.oversea:reward:16.2.61'
    implementation 'com.mbridge.msdk.oversea:mbbanner:16.2.61'
    implementation 'com.mbridge.msdk.oversea:newinterstitial:16.2.61'
    
    
Note: When using the MTG SDK, make sure to introduce the RecyclerView dependency into the project, to avoid potential crashes.

For Proguard Users Only

If you are using ProGuard with the Mintegral adapter, you must add the following code to your ProGuard file:

AndroidX Support:

-keepattributes Signature
-keepattributes *Annotation*
-keep class com.mbridge.** {*; }
-keep interface com.mbridge.** {*; }
-keep class android.support.v4.** { *; }
-dontwarn com.mbridge.**
-keep class **.R$* { public static final int mbridge*; }
-keep public class com.mbridge.* extends androidx.** { *; }
-keep public class androidx.viewpager.widget.PagerAdapter{ *; }
-keep public class androidx.viewpager.widget.ViewPager.OnPageChangeListener{ *; }
-keep interface androidx.annotation.IntDef{ *; }
-keep interface androidx.annotation.Nullable{ *; }
-keep interface androidx.annotation.CheckResult{ *; }
-keep interface androidx.annotation.NonNull{ *; }
-keep public class androidx.fragment.app.Fragment{ *; }
-keep public class androidx.core.content.FileProvider{ *; }                                                 
-keep public class androidx.core.app.NotificationCompat{ *; }                                                
-keep public class androidx.appcompat.widget.AppCompatImageView { *; }
-keep public class androidx.recyclerview.*{ *; }

If you’re not using AndroidX follow the instructions on the Mintegral website.

Done!
You are now all set to deliver Mintegral ads within your application!