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.

For the Mintegral network, the auto setup tool is available to use once you complete step 1. The auto setup tool will create an application and bidder placement and pull placement details from Mintegral—so you don’t need to switch between the LevelPlay and Mintegral platforms. Alternatively, you can complete the whole setup manually.

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.

Important! Once you’ve completed step 1, you can skip to step 3 and use the auto bidder setup tool to get up and running with the Mintegral bidder on Unity LevelPlay. If you’d rather continue with a manual setup, continue with step 2.

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

  • Click on SDK Networks in the left side nav bar. Then click Available networks at the top of the page and select Mintegral from the list of supported networks.
  • There are values from your Mintegral account that need to be inserted into your LevelPlay network setup module:
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. Setup Mintegral on the app level

  • There are two ways that you can get the Unity Ads bidder  setup on LevelPlay:
    1. Auto-setup – Automatically create a new application and placement bidders, and pull all the necessary configurations settings from Unity Ads
    2. Manual – Go between the LevelPlay and Unity Ads platforms to retrieve and enter the necessary information.

Auto-setup

  • To activate the auto setup feature toggle on the bidder auto-setup tool. This will enable you to automatically create an application and bidder placement on the MIntegral platform and allow LevelPlay to pull placement details from Mintegral.

Note: If you toggle the auto setup tool on, you can still configure MIntegral bidding manually later in LevelPlay

  • Select the app where you’d like to run interstitial, rewarded video, or banner ads from Mintegral. Then click the define icon in the Unity Ads row.

  • Click the Add bidder button to automatically create new application and bidding placements on the Mintegral platform, and import the, App ID,  Placement ID and Ad unit ID.

Click Save to approve and accept all configurations. If you close the module without saving, the assets will be created on the Mintegral platform without importing the data onto the Levelplay platform.

Important!

The status of Mintegral bidder instances will be according to the ad units you have activated for the ironSource Ads bidder. For example, if you’re not using the ironSource bidder for rewarded videos, it will not automatically be activated for the Unity Ads network. To activate the Unity Ads bidding instance for rewarded videos, click on the Unity Ads row and toggle on the ad unit. 

Manual setup 

  • On SDK network page, choose the application you would like to configure, and click on Setup under Mintegral bidder
  • Enter your App ID,  then add your Placement ID and Ad Unit ID for each ad unit you want to use with the Mintegral bidder.

  • You can retrieve these parameters from your 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.
        // Add Mintegral Network
        implementation 'com.ironsource.adapters:mintegraladapter:4.3.24'
        
        //overseas market
        implementation 'com.mbridge.msdk.oversea:mbbid:16.6.31'
        implementation 'com.mbridge.msdk.oversea:reward:16.6.31'
        implementation 'com.mbridge.msdk.oversea:mbbanner:16.6.31'
        implementation 'com.mbridge.msdk.oversea:newinterstitial:16.6.31'
        
        
        
        
        
      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.

      Step 6. Mintegral Additional Settings

      Set COPPA

      Unity LevelPlay platform lets publishers communicate Mintegral COPPA settings directly to the Mintegral network.
This feature is enabled using ironSource SDK 7.2.4.1+, Mintegral Android Adapter 4.3.12+.

      Use the following syntax, to set Mintegral COPPA with the value true, to report Child:

       IronSource.setMetaData("Mintegral_COPPA","true");

      Use the following syntax, to set Mintegral COPPA with the value 0, to report Adult:

       IronSource.setMetaData("Mintegral_COPPA","false");

      To learn more about age-restrictions settings Under Mintegral network visit here.

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