Integrating maio with Mediation

This guide is intended for publishers who want to use the Google Mobile Ads SDK to load and display ads from maio via mediation. It covers how to add maio to an ad unit's mediation configuration, and how to integrate the maio SDK and adapter into a Unity app.

The dashboard interface for maio uses Japanese text for its labels, buttons, and descriptions, and the screenshots in this guide have not been translated. However, in descriptions and instructions here, labels and buttons are referred to by their English language equivalents. "URL スキーム," for example, is "URL Scheme," and so on.

Supported formats and features

The mediation adapter for maio has the following capabilities:

Formats
Banners
Interstitials
Rewarded video
Features
Smart banners
Ad Network Optimization (ANO)

Requirements

  • Unity 4 or higher
  • To deploy on Android:
    • Android API level 14 or higher
    • Google Play services 9.2 or higher
  • To deploy on iOS
    • Xcode 7.0 or higher
    • iOS Deployment target of 7.0 or higher
    • Google Mobile Ads SDK 7.14.0 or higher
  • A working Unity project configured with the Google Mobile Ads SDK. See the Get Started guide for details.

Step 1: Set up maio network

First, sign up or log in to your maio account. Click the Application management button on the left sidebar and click on New app.

Next, follow the instructions below for the ad types included in your app. For apps that are built for both Android and iOS, you'll need to follow both sets of instructions to set up your maio account.

Interstitial Android

Enter the Name of your app, set the platform as Android and provide your App URL and URL Scheme. Select Video interstitial as the Ad Type, and then click Update.

Interstitial iOS

Enter the Name of your app, set the platform as iOS and provide your App URL and URL Scheme. Select Video interstitial as the Ad Type, and then click Update.

Rewarded Android

Enter the Name of your app, set the platform as Android and provide your App URL and URL Scheme. Select Video Rewards as the Ad Type, and then click Update.

Rewarded iOS

Enter the Name of your app, set the platform as iOS and provide your App URL and URL Scheme. Select Video Rewards as the Ad Type, and then click Update.

In the Application Management page, make a note of the Media ID. It's needed to set up your AdMob ad unit in the next section.

In the Zone Management page, make a note of the Zone ID. It will also be needed to set up your AdMob ad unit in the next section.

In addition to Media ID and ZoneID, you will need API ID and API KEY to set up your Android ad unit ID for mediaiton.

In Reporting API page, make a note of API ID and API KEY.

Step 2: Configure mediation settings for your AdMob ad unit

You need to add maio to the mediation configuration for your AdMob ad unit. First, sign in to your AdMob account. If you're deploying your Unity app to both Android and iOS, you need two AdMob ad units, one for each platform.

Next, follow the instructions for either Android or iOS.

Android

Navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add maio as an ad source.

To create a new mediation group, select Create Mediation Group.

Enter your Ad Format and Platform, then click Continue.

Give your mediation group a Name, and select locations to target. Next, set the mediation group status to Enabled, and then click Add Ad Units.

Associate this mediation group with one or more of your existing AdMob ad units. Then, click Done.

You should now see the ad units card populated with the ad units you selected as shown below:

Add maio as an ad source

In the Ad Sources card, select Add Ad Network.

Select maio as the ad network and enter the API ID and API KEY obtained in previous section to set up ANO for maio. Then enter an eCPM value for maio and click Continue.

Enter the Media ID and Zone ID obtained in the previous section and click Done.

iOS

Navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add maio as an ad source.

To create a new mediation group, select Create Mediation Group.

Enter your Ad Format and Platform, then click Continue.

Give your mediation group a Name, and select locations to target. Next, set the mediation group status to Enabled, and then click Add Ad Units.

Associate this mediation group with one or more of your existing AdMob ad units. Then, click Done.

You should now see the ad units card populated with the ad units you selected as shown below:

Add maio as an ad source

In the Ad Sources card, select Add Ad Network.

Select maio as the ad network and enter the API ID and API KEY obtained in previous section to set up ANO for maio. Then enter an eCPM value for maio and click Continue.

Enter the Media ID and Zone ID obtained in the previous section and click Done.

Using rewarded video ads

In the settings for your rewarded video ad unit, check the Apply to all networks in Mediation groups box so that you provide the same reward to the user no matter which ad network is served.

If you don't ocheck this setting, the maio adapter defaults to a reward of type "" (empty string) with value 1.

For more information on setting reward values for AdMob ad units, see Create an ad unit.

Step 3: Import the maio SDK and adapter

Download the latest version of Google Mobile Ads mediation plugin for maio and extract the GoogleMobileAdsMaioMediation.unitypackage from the zip file.

In your Unity project editor, select Assets > Import Package > Custom Package and find the GoogleMobileAdsMaioMediation.unitypackage file you downloaded. Make sure that all the files are selected and click Import.

Step 4: Additional code required

No Additional code is required for maio Integration.

Step 5: Test your implementation

Publishers using version 3.10.0 or higher of the Google Mobile Ads Unity plugin will automatically receive test ads from maio on phones and tablets registered as test devices when making requests.

Send feedback about...

Need help? Visit our support page.