Maio Mediation Integration Guide

This guide will instruct you step-by-step on how to set Maio live as an Ad Network on the Unity LevelPlay Mediation.

Step 1.  Create an account at Maio

Sign up for an account at Maio here to access their ad inventory through the Unity LevelPlay Mediation.

Step 2. Add Your App and Create an Ad Zone

Add Your App

Once you’ve set up your account, add your app to the Maio dashboard. To do this, navigate to the Application Management page and click on ‘New Application‘:
ironsource-maio-app-management

Then fill in the following:

  • Name
  • Platform
  • App URL

and click on ‘Update‘:
ironsource-maio-new-app

Create an Ad Zone

Once you’ve added your app to the dashboard, you must create an ad zone. In Maio’s system Zones are Placements to which Maio delivers ads. This will be the placement in your app where you have configured the Rewarded Video or Interstitial to show.

On the ‘Application Management’ page, you will see a table with the app you added. Go to the last column and click on ‘New Zone‘:

ironsource-maio-new-zone

Enter a name for this zone and click ‘Update‘.
ironsource-maio-new-zone

Step 3. Activate Maio in the ironSource SDK Networks Module

There are a few parameters from your Maio account which need to be inserted into the SDK Networks Setup Module in order for Maio to work correctly in connection with ironSource:

API Key  This is the unique key for your Maio account.
API ID This is the unique identifier for your Maio account.
App ID This is the unique identifier of your application in Maio’s system.
Media ID This is the unique identifier of the ad unit.
Zone ID This is the unique zone to which Maio will deliver ads to.
Contact the Maio team to obtain the above information.

Once you obtain the necessary parameters, you must configure Maio’s parameters in your ironSource account. By adding the above information correctly, you will be able to take full advantage of Maio’s ad inventory and reporting data on the Unity LevelPlay mediation.

Enter Maio’s Data in Your ironSource Account

  • Log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘SDK Networks‘. Select Maio from the list of Available Ad Networks list:

ironsource-sdk-networks-page-maio

  • Enter your account’s API Key and API ID. Click ‘Save‘.
    ironsource-maio-account-settings
  • Maio will then be enabled in the Available Ad Networks table.
    ironsource-maio-account
  • Make sure to define the app on which you’d like to run Unity LevelPlay Mediation with Maio. Go to Maio on the setup list of ad networks and click on the ‘Define‘ icon:
    ironsource-define-maio
  • Enter your App ID, Media ID and Zone ID (for the relevant ad units) and click ‘Save‘.
    ironsource-maioapp-settings
  • 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’. Once you the reporting API verifies the integration, turn the status of the ad unit to Active.

Step 4. Add the Maio Adapter to Your Build

Android

 ironSource SDK 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.
    repositories {
        maven {
            url "https://android-sdk.is.com/"
            url "https://imobile-maio.github.io/maven"
        }
    }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    implementation 'com.ironsource.adapters:maioadapter:4.1.11'
    implementation 'com.maio:android-sdk:1.1.16@aar'

Manual Download

  1. Download the Maio Adapter and SDK:
    Add the Maio adapter and SDK to your build. You can find the latest Maio files here.
  2. Add the Maio adapter and SDK to your Project:
    After you download the adapter; drop the Maio adapter jar into the libs folder in your Android Project.
  3. Make sure you add the following to your Gradle build file under the dependencies section:
    implementation 'com.ironsource.adapters:maioadapter:4.1.11'
    implementation 'com.maio:android-sdk:1.1.16@aar'

Step 5. Update AndroidManifest.xml

As of Maio Android adapter version 4.1.5+ (Android SDK Version 6.17.0), Maio adapter will be released as AAR. Only if you intend to keep your Jar integration, please add the manifest.
Add the following activities to your manifest: 

<activity  
          android:name="jp.maio.sdk.android.AdFullscreenActivity"  
          android:configChanges="orientation|screenLayout|screenSize"  
          android:hardwareAccelerated="true"  
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" >  
</activity>
<activity            
          android:name="jp.maio.sdk.android.HtmlBasedAdActivity"            
          android:configChanges="keyboardHidden|orientation|screenSize"            
          android:theme="@android:style/Theme.NoTitleBar.Fullscreen" >
</activity>

Done!
You are now all set to deliver Maio Ads within your application!


What’s Next?

To add additional mediation Ad networks, integrate the ironSource adapters and follow our integration guides.