This guide shows you how to use Google Mobile Ads Unity Plugin to load and display ads from i-mobile using [mediation](https://developers.google.com/admob/unity/mediation.md.txt), covering waterfall integrations. It covers how to add i-mobile to an ad unit's mediation configuration, and how to integrate the i-mobile SDK and adapter into a Unity app. The dashboard interface for i-mobile uses Japanese text for its labels, buttons, and descriptions. The screenshots in this guide have not been translated. In this guide's descriptions and instructions however, labels and buttons are translated with their English language equivalents in parentheses. ## Supported integrations and ad formats The AdMob mediation adapter for i-mobile has the following capabilities: | Integration || |---|---| | Bidding | | | Waterfall | Yes | | App Open | | | Banner | Yes | | Interstitial | Yes | | Rewarded | | | Rewarded Interstitial | | | Native | Yes | ## Prerequisites Before you continue, verify the following: - Latest Google Mobile Ads Unity Plugin version. - Unity Editor version 5.6 or later. - To deploy on Android - Android API level 24 or later. - To deploy on iOS - iOS deployment target of 13.0 or later. - A working Unity project configured with Google Mobile Ads Unity Plugin. See [Set up Google Mobile Ads Unity Plugin](https://developers.google.com/admob/unity/quick-start.md.txt) for details. - [Set up AdMob Mediation](https://developers.google.com/admob/unity/mediation.md.txt). ## Step 1: Set up configurations in i-mobile UI - [Sign up](https://www2.i-mobile.co.jp/pre_register_partner.aspx) or [log in](https://sppartner.i-mobile.co.jp/login.aspx) to your i-mobile account. - Add your app to the i-mobile dashboard by clicking the **サイト／アプリ管理 (Site/Application Management)** tab and the button for your app's platform. ### Android  ### iOS  - Fill out the form and click the **新規登録 (Sign up)** button. ### Android  ### iOS  > [!NOTE] > **Note:** i-mobile has to approve your registration. Once you are approved, you can create an **Advertising Spot**. - To create a new Advertising Spot, select your app under the **サイト／アプリ管理 (Site/Application Management)** tab. ### Android  ### iOS  - Navigate to the **広告スポット管理 (Ad Spot Management)** tab and click the **新規広告スポット (New Ad Spot)** button. -  - Next, fill out the form by providing the **広告スポット名 (Ad Spot name)** , **広告スポットサイズ (Ad Spot size)** and other details. Then, click the **新規登録 (Sign up)** button. -  - Your new **Ad spot** is ready. To view its integration details, click the **アプリ設定取得 (Get App settings)** button. -  - Take note of the **パブリッシャーID (Publisher ID)** , **メディアID (Media ID)** , and **スポットID (Spot ID)**. You'll need these parameters later when configuring i-mobile for mediation in the AdMob UI. ### Android  ### iOS  ### Update your app-ads.txt - [Authorized Sellers for Apps app-ads.txt](https://iabtechlab.com/wp-content/uploads/2019/03/app-ads.txt-v1.0-final-.pdf) is an IAB Tech Lab initiative that helps ensure your app ad inventory is only sold through channels you've identified as authorized. To prevent a significant loss in ad revenue, you'll need to implement an `app-ads.txt` file. If you haven't done so already, [set up an app-ads.txt file for your app](https://support.google.com/admob/answer/9363762). - To implement `app-ads.txt` for i-mobile, see their [Frequently Asked Questions](https://www.i-mobile.co.jp/help_partner_sp.html#3-10). ## Step 2: Set up i-mobile 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/imobile.md.txt#step-2). ### iOS For instructions, see step 2 in the guide for [iOS](https://developers.google.com/admob/ios/mediation/imobile.md.txt#step-2). ## Step 3: Import the i-mobile SDK and adapter > [!NOTE] > **Note:** Failure to integrate the compatible i-mobile and Google Mobile Ads SDK versions might lead to build issues. ### OpenUPM-CLI > [!IMPORTANT] > **Important:** If you are migrating from using a `.unitypackage` to using OpenUPM-CLI, you must manually uninstall the assets from the old location by deleting all files from the `Assets/GoogleMobileAds/Mediation/IMobile` folder. If you have [OpenUPM-CLI](https://github.com/openupm/openupm-cli#installation) installed, you can install the Google Mobile Ads i-mobile Mediation Plugin for Unity to your project by running the following command from your project's root directory: ```bash openupm add com.google.ads.mobile.mediation.imobile ``` ### OpenUPM > [!IMPORTANT] > **Important:** If you are migrating from using a `.unitypackage` to using OpenUPM, you must manually uninstall the assets from the old location by deleting all files from the `Assets/GoogleMobileAds/Mediation/IMobile` folder. In your Unity project editor, select **Edit** \> **Project Settings** \> **Package Manager** to open the [Unity Package Manager Settings](https://docs.unity3d.com/Manual/class-PackageManager.html). Under the **Scoped Registries** tab, add OpenUPM as a scoped registry with the following details: - Name: `OpenUPM` - URL: `https://package.openupm.com` - Scope(s): `com.google`  Then, navigate to **Window** \> **Package Manager** to open the [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui-install.html) and select **My Registries** from the drop-down menu.  Select the **Google Mobile Ads IMobile Mediation** package and click **Install**.  ### Unity Package Download the latest version of Google Mobile Ads mediation plugin for i-mobile from the download link in the [Changelog](https://developers.google.com/admob/unity/mediation/imobile.md.txt#i-mobile-unity-mediation-plugin-changelog) and extract the `GoogleMobileAdsIMobileMediation.unitypackage` from the zip file. In your Unity project editor, select **Assets** \> **Import Package** \> **Custom Package** and find the `GoogleMobileAdsIMobileMediation.unitypackage` file you downloaded. Make sure that all the files are selected and click **Import**.  Then, select **Assets** \> **External Dependency Manager** \> **Android Resolver** \> **Force Resolve** . The External Dependency Manager library will perform dependency resolution from scratch and copy the declared dependencies into the `Assets/Plugins/Android` directory of your Unity app.  ## Step 4: Additional code required ### Android No additional code is required i-mobile integration. ### iOS ### SKAdNetwork integration Follow [i-mobile's documentation](https://sppartner.i-mobile.co.jp/webdoc/index.html#objective-c/ios14.html) 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/unity/test-ads.md.txt#enable_test_devices) for AdMob. i-mobile provides test **Spot ID** , **Media ID** , and **Publisher ID** for testing, you can find them [here](https://sppartner.i-mobile.co.jp/webdoc/common/test-id.html). > [!IMPORTANT] > **Important:** Disable test mode for AdMob and i-mobile before releasing your app. ### Verify test ads - To verify that you are receiving test ads from i-mobile, enable [single ad source testing](https://developers.google.com/admob/unity/ad-inspector.md.txt#single_ad_source_testing) in ad inspector using the **i-mobile (Waterfall)** ad source(s). ## Error codes - If the adapter fails to receive an ad from i-mobile, publishers can check the underlying error from the ad response using [`ResponseInfo`](https://developers.google.com/admob/unity/response-info.md.txt) under the following classes: ### Android | Format | Class name | |---|---| | Banner | com.google.ads.mediation.imobile.IMobileAdapter | | Interstitial | com.google.ads.mediation.imobile.IMobileAdapter | | Native | com.google.ads.mediation.imobile.IMobileMediationAdapter | ### iOS | Format | Class name | |---|---| | Banner | IMobileAdapter | | Interstitial | IMobileAdapter | | Native | GADMediationAdapterIMobile | - Here are the codes and accompanying messages thrown by the i-mobile adapter when an ad fails to load: ### Android | Error code | Reason | |---|---| | 0-99 | i-mobile SDK returned an error. See [code](https://github.com/googleads/googleads-mobile-android-mediation/blob/master/ThirdPartyAdapters/imobile/imobile/src/main/java/com/google/ads/mediation/imobile/AdapterHelper.java) for more details. | | 101 | i-mobile requires an `Activity` context to load ads. | | 102 | i-mobile server parameters configured in the AdMob UI are missing or invalid. | | 103 | The requested ad size does not match an i-mobile supported banner size. | | 104 | i-mobile's native ad load success callback returned an empty native ads list. | ### iOS | Error code | Reason | |---|---| | 0-10 | i-mobile SDK returned an error. See [code](https://github.com/imobile/adnw-sdk-ios/blob/master/ImobileSdkAds.framework/Headers/ImobileSdkAds.h) for more details. | | 101 | i-mobile server parameters configured in the AdMob UI are missing or invalid. | | 102 | The requested ad size does not match an i-mobile supported banner size. | | 103 | i-mobile failed to present an ad. | | 104 | i-mobile returned an empty native ad array. | | 105 | i-mobile failed to download native ad assets. | | 106 | i-mobile does not support requesting for multiple interstitial ads using the same Spot ID. | ## i-mobile Unity Mediation Plugin Changelog #### [Version 1.3.16](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.16.zip) - Supports [i-mobile Android adapter version 2.3.2.5](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2325). - Supports [i-mobile iOS adapter version 2.3.4.8](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2348). - Built and tested with the Google Mobile Ads Unity Plugin version 11.5.0. #### [Version 1.3.15](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.15.zip) - Supports [i-mobile Android adapter version 2.3.2.4](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2324). - Supports [i-mobile iOS adapter version 2.3.4.8](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2348). - Built and tested with the Google Mobile Ads Unity Plugin version 11.5.0. #### [Version 1.3.14](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.14.zip) - Supports [i-mobile Android adapter version 2.3.2.4](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2324). - Supports [i-mobile iOS adapter version 2.3.4.7.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2347). - Built and tested with the Google Mobile Ads Unity Plugin version 11.4.0. #### [Version 1.3.13](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.13.zip) - Supports [i-mobile Android adapter version 2.3.2.4](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2324). - Supports [i-mobile iOS adapter version 2.3.4.7](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2347). - Built and tested with the Google Mobile Ads Unity Plugin version 11.1.0. #### [Version 1.3.12](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.12.zip) - Supports [i-mobile Android adapter version 2.3.2.3](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2323). - Supports [i-mobile iOS adapter version 2.3.4.7](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2347). - Built and tested with the Google Mobile Ads Unity Plugin version 11.1.0. #### [Version 1.3.11](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.11.zip) - Supports [i-mobile Android adapter version 2.3.2.3](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2323). - Supports [i-mobile iOS adapter version 2.3.4.6](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2346). - Built and tested with the Google Mobile Ads Unity Plugin version 11.0.0. #### [Version 1.3.10](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.10.zip) - Supports [i-mobile Android adapter version 2.3.2.2](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2322). - Supports [i-mobile iOS adapter version 2.3.4.5](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2345). - Built and tested with the Google Mobile Ads Unity Plugin version 11.0.0. #### [Version 1.3.9](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.9.zip) - Supports [i-mobile Android adapter version 2.3.2.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2321). - Supports [i-mobile iOS adapter version 2.3.4.5](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2345). - Built and tested with the Google Mobile Ads Unity Plugin version 11.0.0. #### [Version 1.3.8](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.8.zip) - Supports [i-mobile Android adapter version 2.3.2.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2321). - Supports [i-mobile iOS adapter version 2.3.4.3](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2343). - Built and tested with the Google Mobile Ads Unity Plugin version 10.6.0. #### [Version 1.3.7](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.7.zip) - Supports [i-mobile Android adapter version 2.3.2.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2321). - Supports [i-mobile iOS adapter version 2.3.4.2](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2342). - Built and tested with the Google Mobile Ads Unity Plugin version 10.0.0. #### [Version 1.3.6](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.6.zip) - Supports [i-mobile Android adapter version 2.3.2.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2320). - Supports [i-mobile iOS adapter version 2.3.4.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2341). - Built and tested with the Google Mobile Ads Unity Plugin version 9.3.0. #### [Version 1.3.5](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.5.zip) - Supports [i-mobile Android adapter version 2.3.2.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2320). - Supports [i-mobile iOS adapter version 2.3.4.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2340). - Built and tested with the Google Mobile Ads Unity Plugin version 9.1.0. #### [Version 1.3.4](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.4.zip) - Supports [i-mobile Android adapter version 2.3.1.2](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2312). - Supports [i-mobile iOS adapter version 2.3.4.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2340). - Built and tested with the Google Mobile Ads Unity Plugin version 9.0.0. #### [Version 1.3.3](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.3.zip) - Supports [i-mobile Android adapter version 2.3.1.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2311). - Supports [i-mobile iOS adapter version 2.3.3.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2330). - Built and tested with the Google Mobile Ads Unity Plugin version 9.0.0. #### [Version 1.3.2](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.2.zip) - Moved adapter content to `GoogleMobileAds/Mediation/IMobile/`. - Supports [i-mobile Android adapter version 2.3.1.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2311). - Supports [i-mobile iOS adapter version 2.3.2.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2320). - Built and tested with the Google Mobile Ads Unity Plugin version 8.1.0. #### [Version 1.3.1](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.1.zip) - Supports [i-mobile Android adapter version 2.3.0.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2300). - Supports [i-mobile iOS adapter version 2.3.0.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2301). - Built and tested with the Google Mobile Ads Unity Plugin version 7.4.1. #### [Version 1.3.0](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.3.0.zip) - Supports [i-mobile Android adapter version 2.3.0.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-2300). - Supports [i-mobile iOS adapter version 2.3.0.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2300). - Built and tested with the Google Mobile Ads Unity Plugin version 7.3.1. #### [Version 1.2.2](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.2.2.zip) - Supports [i-mobile Android adapter version 2.0.23.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-20231). - Supports [i-mobile iOS adapter version 2.2.0.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2201). - Built and tested with the Google Mobile Ads Unity Plugin version 7.0.2. #### [Version 1.2.1](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.2.1.zip) - Supports [i-mobile Android adapter version 2.0.23.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-20230). - Supports [i-mobile iOS adapter version 2.2.0.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2201). - Built and tested with the Google Mobile Ads Unity Plugin version 7.0.0. #### [Version 1.2.0](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.2.0.zip) - Supports [i-mobile Android adapter version 2.0.23.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-20230). - Supports [i-mobile iOS adapter version 2.2.0.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2200). #### [Version 1.1.0](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.1.0.zip) - Supports [i-mobile Android adapter version 2.0.22.2](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-20222). - Supports [i-mobile iOS adapter version 2.1.0.1](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-2101). #### [Version 1.0.2](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.0.2.zip) - Supports [i-mobile Android adapter version 2.0.22.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-20220). - Supports [i-mobile iOS adapter version 2.0.32.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-20320). #### [Version 1.0.1](https://dl.google.com/googleadmobadssdk/mediation/unity/imobile/IMobileUnityAdapter-1.0.1.zip) - Supports [i-mobile Android adapter version 2.0.21.0](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-20210). - Supports [i-mobile iOS adapter version 2.0.31.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-20310). #### Version 1.0.0 - First release! - Supports [i-mobile Android adapter version 2.0.20.1](https://github.com/googleads/googleads-mobile-android-mediation/blob/main/ThirdPartyAdapters/imobile/CHANGELOG.md#version-20201). - Supports [i-mobile iOS adapter version 2.0.29.0](https://github.com/googleads/googleads-mobile-ios-mediation/blob/main/adapters/I-Mobile/CHANGELOG.md#version-20290).