Maio Mediation Integration Guide

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

Step 1.  Create an account at Maio

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

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 ironSource mediation platform.

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 ironSource’s 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

Unity Plugin (Android Integration)

  1. Download the maio Unity Package
    Import the IronSourceMaioAdapter_[version].unitypackage to your Unity project. You can find the latest maio Unity Package here.
  2. Add the maio files to your Unity project
    To add the adapter, simply double click on the IronSourceMaioAdapter_[version].unitypackage and add all files to your Unity project.
    Note: If you are upgrading from a previous version, please remove Maio.y.x.x.x.jar from Assets/Plugins/Android/IronSource/libs.
  3. Update AndroidManifest.xml
    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>


Unity Plugin (iOS Integration)

  1. Download the maio Unity Package
    Import the ISMaioAdapter_[version].unitypackage to your Unity project. You can find the latest maio Unity Package here.
  2. Add the maio files to your Unity project
    To add the adapter, simply double click on the ISMaioAdapter_[version].unitypackage and add all files to your Unity project.

Our Unity Plugin adds the necessary frameworks automatically to your Xcode project.

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.