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
- Create an account with Mintegral. You can do so here.
- 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 ProcessIf this is your first time setting up a Mintegral account, continue below.
- Login
- When you log in for the first time, select ‘APP Setting’
- When you log in for the first time, select ‘APP Setting’
- Add Your App
- Upon clicking ‘+ Add APP’, a setup module will appear, you can enter details here:
Note: Note: You will need a unique Mintegral application per platform (iOS + Android) just like you do with your ironSource account. - After you defined the settings, you will be asked to check the ad types you DO NOT wish to be delivered to your application.
- Upon clicking ‘+ Add APP’, a setup module will appear, you can enter details here:
- Add Ad Units
- After you defined the Applications settings, select the relevant Apps through dashboard and click ‘Add AD Unit‘:
- Mintegral adapters can serve Rewarded Video, Interstitial and Banner.
If interested in serving Mintegral Interstitial Ads on the ironSource Mediation platform, select ‘Interstitial Video‘ and select ‘Next‘:
For Rewarded Video, please follow the same steps, only select ‘Rewarded Video‘ in step b. this time.
For Banner, select ‘Banner‘ as the ad format. It is highly recommended to set the “Auto Refresh” value for No, since you can control the refresh rate on the mediation platform.
- After you defined the Applications settings, select the relevant Apps through dashboard and click ‘Add AD Unit‘:
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.
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
Once you have logged into your Mintegral user (as described in step 1), go to the ‘Company Info’ under ‘Account’ tab – on the left menu:
Now, on the bottom of the page you can find your SKey, as well as your Secret:
Secret (same as SKey)
Once you have logged into your Mintegral user (as described in step 1), go to the ‘Company Info’ under ‘Account’ tab – on the left menu:
Now, on the bottom of the page you can find your Secret, as well as your SKey:
Step 4. Add the Mintegral Adapter to Your Build
ironSource supports both Gradle dependencies and manual download mechanisms.
Gradle
- 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" } }
- Add the adapter’s Maven name to your build.gradle script of your app module.
Manual Download
- Download the Mintegral Adapter:
Add the Mintegral Adapter and SDK to your build. You can find the latest Mintegral files here. - Download the Mintegral .AAR
- Unzip “Mintegral AARs” and the following for each file:
- Add the Mintegral Adapter to your Project:
After you download the Adapter; drop the Mintegral Adapter jar into the libs folder in your Android Project.
- Make sure you add the following to your Gradle build file under the dependencies section:
dependencies { implementation 'com.ironsource.adapters:adcolonyadapter:4.3.11' implementation 'com.adcolony:sdk:4.7.1' }
For Proguard Users Only
If you are using ProGuard with the Mintegral adapter, you must add the following code to your ProGuard file:
-keepattributes Signature -keepattributes *Annotation* -keep class com.mintegral.** {*; } -keep interface com.mintegral.** {*; } -keep class android.support.v4.** { *; } -dontwarn com.mintegral.** -keep class **.R$* { public static final int mintegral*; } -keep class com.alphab.** {*; } -keep interface com.alphab.** {*; }
Step 5. Update AndroidManifest.xml
Manifest Permissions:
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Manifest Activities:
Add the following requirement inside the <application> tag on your manifest:
<uses-library android:name="org.apache.http.legacy" android:required="false"/>
Add the following activities inside the <application> tag on your manifest:
<activity android:name="com.mintegral.msdk.activity.MTGCommonActivity" android:configChanges="keyboard|orientation" android:screenOrientation="portrait" android:exported="true" android:theme="@android:style/Theme.Translucent.NoTitleBar"> </activity> <activity android:name="com.mintegral.msdk.reward.player.MTGRewardVideoActivity" android:configChanges="orientation|keyboardHidden|screenSize" android:theme="@android:style/Theme.NoTitleBar.Fullscreen"> </activity>
Done!
You are now all set to deliver Mintegral ads within your application!