This guide shows you how to use Google Mobile Ads Flutter Plugin to load and display ads from maio using [mediation](https://developers.google.com/admob/flutter/mediation.md.txt), covering waterfall integrations. It covers how to add maio to an ad unit's mediation configuration, and how to integrate the maio SDK and adapter into a Flutter 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,". ## Supported integrations and ad formats The mediation adapter for maio has the following capabilities: | Integration || |---|---| | Bidding | | | Waterfall | Yes | | App Open | | | Banner | | | Interstitial | Yes | | Rewarded | Yes | | Rewarded Interstitial | | | Native | | ## Prerequisites Before you continue, verify the following: - Latest Google Mobile Ads Flutter Plugin version. - Flutter framework version 3.7.0 or later. - To deploy on Android - Android API level 24 or later. - To deploy on iOS - iOS deployment target of 15.0 or later. - A working Flutter project configured with Google Mobile Ads Flutter Plugin. See [Set up Google Mobile Ads Flutter Plugin](https://developers.google.com/admob/flutter/quick-start.md.txt) for details. - [Set up AdMob Mediation](https://developers.google.com/admob/flutter/mediation.md.txt). ## Step 1: Set up configurations in maio UI - First, [sign up](https://docs.google.com/forms/d/e/1FAIpQLScSrlf8JTwTdvJjaLjc3v4z8PfunngKALSBdRf3EfyctdMY3Q/viewform) or [log in](https://maio.jp/publisher/login) to your maio account. Click the **Application management** button on the left sidebar and click on **New app**. -  - Select the tab corresponding to your preferred **Ad Type**. ### Interstitial Enter the **Name** of your app, select the platform and provide your **App URL** . Select **Video interstitial** as the **Ad Type** , and then click **Update**. ### Android  ### iOS  **Note:** Interstitial ads from maio are skippable by default. ### Rewarded Enter the **Name** of your app, select the platform and provide your **App URL** . Select **Video Rewards** as the **Ad Type** , and then click **Update**. ### Android  ### iOS  **Note:** Rewarded Video ads from maio are **NOT** skippable by default. - 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. ### Android  ### iOS  - 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. ### Android  ### iOS  (Waterfall only) In addition to **Media ID** and **Zone ID** , you will need **API ID** and **API KEY** to set up your ad unit ID for mediation. In **Reporting API page** , make a note of **API ID** and **API KEY** . -  > [!NOTE] > **Note:** (Waterfall only) If this is your first time setting up your maio account, you may need to contact maio's support team in order for your **API ID** and **API KEY** to be issued to you. ## Step 2: Set up maio demand in AdMob UI ### Configure mediation settings for your ad unit ### Android For instructions, see step 2 in the guide for [Android](https://developers.google.com/admob/android/mediation/maio.md.txt#step-2). ### iOS For instructions, see step 2 in the guide for [iOS](https://developers.google.com/admob/ios/mediation/maio.md.txt#step-2). ## Step 3: Import the maio SDK and adapter > [!NOTE] > **Note:** Failure to integrate the compatible maio and Google Mobile Ads SDK versions might lead to build issues. ### Integration through pub.dev - (Android only) Add the following repositories to the `build.gradle` file inside your project's `android` directory: ```groovy repositories { google() mavenCentral() maven { url = uri("https://imobile-maio.github.io/maven") } } ``` - Add the following dependency with the latest versions of the maio SDK and adapter in your package's `pubspec.yaml` file: ```yaml dependencies: gma_mediation_maio: ^1.1.8 ``` ### Manual Integration - Download the latest version of Google Mobile Ads mediation plugin for [maio](https://pub.dev/packages/gma_mediation_maio/versions), extract the downloaded file, and add the extracted plugin folder (and its contents) to your Flutter project. Then, reference the plugin in your `pubspec.yaml` file by adding the following dependency: ```yaml dependencies: gma_mediation_maio: path: path/to/local/package ``` ## Step 4: Add required code ### Android No additional code is required for maio integration. ### iOS ### SKAdNetwork integration Follow [maio's documentation](https://github.com/imobile-maio/maio-iOS-SDK#skadnetworkid) to add the SKAdNetwork identifiers to your project's `Info.plist` file. ## Step 5: Test your implementation ### Enable test ads - Make sure you [register your test device](https://developers.google.com/admob/flutter/test-ads.md.txt#enable_test_devices) for AdMob. - Publishers using version 7.26.0 or higher of Google Mobile Ads Flutter Plugin will automatically receive test ads from maio on phones and tablets registered as [test devices](https://developers.google.com/admob/flutter/test-ads.md.txt#enable_test_devices) when making requests. > [!IMPORTANT] > **Important:** Disable test mode for AdMob and maio before releasing your app. ### Verify test ads - To verify that you are receiving test ads from maio, enable [single ad source testing](https://developers.google.com/admob/flutter/ad-inspector.md.txt#single_ad_source_testing) in ad inspector using the **maio (Waterfall)** ad source(s). ## Error codes - If the adapter fails to receive an ad from maio, publishers can check the underlying error from the ad response using [`ResponseInfo`](https://developers.google.com/admob/flutter/response-info.md.txt) under the following classes: ### Android | Format | Class name | |---|---| | Interstitial | jp.maio.sdk.android.mediation.admob.adapter.Interstitial | | Rewarded | jp.maio.sdk.android.mediation.admob.adapter.Rewarded | ### iOS | Format | Class name | |---|---| | Interstitial | GADMMaioInterstitialAdapter | | Rewarded | GADMMaioRewardedAdapter | - Here are the codes and accompanying messages thrown by the maio adapter when an ad fails to load: ### Android | Error code | Reason | |---|---| | 0-10 | maio returned an SDK-specific error. See [code](https://github.com/googleads/googleads-mobile-android-mediation/blob/cd4c87f4e61adcf1bacc69da8c1f69d972105672/ThirdPartyAdapters/maio/maio/src/main/java/com/google/ads/mediation/maio/MaioMediationAdapter.java#L64-L78) and maio's [documentation](https://github.com/imobile-maio/maio-Android-SDK/wiki/API-Reference-(EN)#failnotificationreason-enum-1) for more details. | | 101 | Maio does not have an ad available. | | 102 | Invalid server parameters (e.g. missing Placement ID). | | 103 | Context used to load an ad was not an \`Activity\` instance. | ### iOS | Error code | Reason | |---|---| | 0-10 | maio returned an SDK-specific error. See maio's [code](https://github.com/imobile-maio/maio-iOS-SDK/blob/master/Maio.xcframework/ios-arm64_armv7/Maio.framework/Headers/MaioDelegate.h) for more details. | | 101 | maio doesn't yet have an ad available. | | 102 | Invalid server parameters (e.g. missing Placement ID). | | 103 | The maio adapter does not support the ad format being requested. | | 104 | An ad is already loaded for this network configuration. | ## maio Flutter Mediation Adapter Changelog #### Version 1.1.8 - Supports [maio Android adapter version 2.0.9.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2091). - Supports [maio iOS adapter version 2.2.3.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2230). - Built and tested with the Google Mobile Ads Flutter Plugin version 9.1.0. #### Version 1.1.7 - Updated to support Google Mobile Ads Flutter Plugin version 9.1.0. - Add Swift Package Manager support. - Supports [maio Android adapter version 2.0.9.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2090). - Supports [maio iOS adapter version 2.2.2.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2220). - Built and tested with the Google Mobile Ads Flutter Plugin version 9.1.0. #### Version 1.1.6 - Supports [maio Android adapter version 2.0.9.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2090). - Supports [maio iOS adapter version 2.2.1.2](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2212). - Built and tested with the Google Mobile Ads Flutter Plugin version 9.0.0. #### Version 1.1.5 - Supports [maio Android adapter version 2.0.8.2](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2082). - Supports [maio iOS adapter version 2.2.1.2](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2212). - Built and tested with the Google Mobile Ads Flutter Plugin version 8.0.0. #### Version 1.1.4 - Updated minimum Flutter version to 3.38.1. - Updated to support Google Mobile Ads Flutter Plugin version 8.0.0. - Supports [maio Android adapter version 2.0.8.2](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2082). - Supports [maio iOS adapter version 2.2.1.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2211). - Built and tested with the Google Mobile Ads Flutter Plugin version 8.0.0. #### Version 1.1.3 - Supports [maio Android adapter version 2.0.7.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2070). - Supports [maio iOS adapter version 2.2.0.3](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2203). - Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0. #### Version 1.1.2 - Updated minimum Flutter version to 3.35.1 - Updated to support Google Mobile Ads Flutter Plugin version 7.0.0 - Supports [maio Android adapter version 2.0.8.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2080). - Supports [maio iOS adapter version 2.2.0.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2201). #### Version 1.1.1 - Supports [maio Android adapter version 2.0.7.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2070). - Supports [maio iOS adapter version 2.2.0.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2201). - Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0. #### Version 1.1.0 - Supports [maio Android adapter version 2.0.6.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2060). - Supports [maio iOS adapter version 2.2.0.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2200). - Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0. #### Version 1.0.3 - Supports [maio Android adapter version 2.0.5.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2050). - Supports [maio iOS adapter version 2.1.6.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2161). - Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0. #### Version 1.0.2 - Supports [maio Android adapter version 2.0.4.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2040). - Supports [maio iOS adapter version 2.1.6.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2161). - Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0. #### Version 1.0.1 - Supports [maio Android adapter version 2.0.3.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2031). - Supports [maio iOS adapter version 2.1.6.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2161). - Built and tested with the Google Mobile Ads Flutter Plugin version 6.0.0. #### Version 1.0.0 - Initial release. - Supports [maio Android adapter version 2.0.3.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/maio/CHANGELOG.md#version-2030). - Supports [maio iOS adapter version 2.1.6.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/Maio/CHANGELOG.md#version-2160). - Built and tested with the Google Mobile Ads Flutter Plugin version 5.3.1.