このガイドでは、Google Mobile Ads SDK を使用し、ウォーターフォール統合を対象に、メディエーションを使用して i-Mobile から広告を読み込んで表示する方法を説明します。i-mobile を広告ユニットのメディエーション設定に追加する方法と、i-mobile SDK とアダプタを Unity アプリに統合する方法について説明します。
i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストを使用しています。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは英語の対応するものを括弧で囲んで翻訳しています。
サポートされている統合と広告フォーマット
AdMob i-mobile 用メディエーション アダプタには次の機能があります。
統合 | |
---|---|
入札 | |
ウォーターフォール | |
形式 | |
バナー | |
インタースティシャル | |
特典 |
要件
- Unity 5.6 以降
- 最新の Google Mobile Ads SDK
- Android にデプロイするには
- Android API レベル 19 以降
- iOS にデプロイする場合
- iOS デプロイ ターゲットが 12.0 以降であること
- Google Mobile Ads SDK を使って動作する Unity プロジェクトが設定されていること。詳しくは、使ってみるをご覧ください。
- メディエーションのスタートガイドを完了します。
ステップ 1: i-Mobile の UI で設定を行う
[サイト / アプリ管理(サイト / アプリケーション管理)] タブとアプリのプラットフォームのボタンをクリックして、アプリを i-mobile ダッシュボードに追加します。
Android
iOS
フォームに入力し、[新規登録] ボタンをクリックします。
Android
iOS
新しい広告スポットを作成するには、[サイト / アプリ管理(サイト / アプリケーション管理)] タブでアプリを選択します。
Android
iOS
[広告スポット管理(広告スポット管理)] タブに移動し、[新規広告スポット(新しい広告スポット)] ボタンをクリックします。
次に、「広告スポット名(広告スポット名)」や「広告スポットサイズ(広告スポットのサイズ)」などの情報をフォームに記入します。次に、[新規登録] ボタンをクリックします。
新しい広告スポットの準備ができました。統合の詳細を表示するには、[アプリ設定取得(App settings を取得)] ボタンをクリックします。
パブリッシャー ID(パブリッシャー ID)、メディア ID(メディア ID)、スポット ID(スポット ID)をメモします。これらのパラメータは、後で UI でメディエーション用に i-Mobile を設定するときに必要になります。 AdMob
Android
iOS
ステップ 2: 管理画面で i-Mobile の AdMob デマンドを設定する
広告ユニットのメディエーション設定を行う
ステップ 3: i-mobile SDK とアダプターをインポートする
変更履歴のダウンロード リンクから i-mobile 向け Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsIMobileMediation.unitypackage
を抽出します。
Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsIMobileMediation.unitypackage
ファイルを見つけます。すべてのファイルが選択されていることを確認して、[Import] をクリックします。
次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolver] を選択します。Unity Play Services Resolver ライブラリは、依存関係の解決をゼロから行い、宣言された依存関係を Unity アプリの Assets/Plugins/Android
ディレクトリにコピーします。
ステップ 4: 追加のコードが必要
Android
i-Mobile との統合に追加のコードは必要ありません。
iOS
SKAdNetwork との統合
i-mobile のドキュメントに沿って、プロジェクトの Info.plist
ファイルに SKAdNetwork 識別子を追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
AdMob。 i-mobile ではテスト用のスポット ID、メディア ID、パブリッシャー ID を提供しています。こちらで確認できます。
テスト広告を確認する
i-mobileからテスト広告を受信していることを確認するには、広告インスペクタで i-mobile (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
エラーコード
アダプタが i-Mobile から広告を受信できない場合、パブリッシャーは、次のクラスの ResponseInfo
を使用して、広告レスポンスの根本的なエラーを確認できます。
Android
形式 | クラス名 |
---|---|
バナー | com.google.ads.mediation.imobile.IMobileAdapter |
インタースティシャル | com.google.ads.mediation.imobile.IMobileAdapter |
ネイティブ | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
形式 | クラス名 |
---|---|
バナー | IMobileAdapter |
インタースティシャル | IMobileAdapter |
ネイティブ | GADMediationAdapterIMobile |
広告の読み込みに失敗したときに i-Mobile アダプタによってスローされるコードと付随するメッセージは次のとおりです。
Android
エラーコード | 理由 |
---|---|
0-99 | i-mobile SDK からエラーが返されました。詳しくは、コードをご覧ください。 |
101 | i-mobile で広告を読み込むには Activity コンテキストが必要です。 |
102 | UI で設定されている i-Mobile サーバー パラメータがないか AdMob 無効です。 |
103 | リクエストされた広告サイズが i-Mobile でサポートされているバナーサイズと一致しません。 |
104 | i-mobile のネイティブ広告の読み込み成功のコールバックで、空のネイティブ広告リストが返されました。 |
iOS
エラーコード | 理由 |
---|---|
0-10 | i-mobile SDK からエラーが返されました。詳しくは、code をご覧ください。 |
101 | UI で設定されている i-Mobile サーバー パラメータがないか AdMob 無効です。 |
102 | リクエストされた広告サイズが i-Mobile でサポートされているバナーサイズと一致しません。 |
103 | i-mobile で広告を表示できませんでした。 |
104 | i-mobile から空のネイティブ広告配列が返されました。 |
105 | i-mobile でネイティブ広告アセットをダウンロードできませんでした。 |
106 | i-mobile では、同じ Spot ID を使用して複数のインタースティシャル広告をリクエストすることはできません。 |
i-mobile Unity メディエーション プラグインに関する変更履歴
バージョン 1.3.2
- アダプターのコンテンツを
GoogleMobileAds/Mediation/IMobile/
に移動しました。 - i-mobile Android アダプター バージョン 2.3.1.1 をサポートします。
- i-mobile iOS アダプタ バージョン 2.3.2.0 に対応しています。
- Google Mobile Ads Unity プラグイン バージョン 8.1.0 でビルドおよびテストされています。
バージョン 1.3.1
- i-mobile Android アダプター バージョン 2.3.0.0 をサポートします。
- i-mobile iOS アダプタ バージョン 2.3.0.1 に対応しています。
- Google Mobile Ads Unity プラグイン バージョン 7.4.1 でビルドおよびテストされています。
バージョン 1.3.0
- i-mobile Android アダプター バージョン 2.3.0.0 をサポートします。
- i-mobile iOS アダプタ バージョン 2.3.0.0 に対応しています。
- Google Mobile Ads Unity プラグイン バージョン 7.3.1 でビルドおよびテストされています。
バージョン 1.2.2
- i-mobile Android アダプター バージョン 2.0.23.1 をサポートします。
- i-mobile iOS アダプタ バージョン 2.2.0.1 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 7.0.2 でビルドおよびテストされています。
バージョン 1.2.1
- i-mobile Android アダプター バージョン 2.0.23.0 をサポートします。
- i-mobile iOS アダプタ バージョン 2.2.0.1 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 7.0.0 でビルドおよびテストされています。
バージョン 1.2.0
- i-mobile Android アダプター バージョン 2.0.23.0 をサポートします。
- i-mobile iOS アダプタ バージョン 2.2.0.0 に対応しています。
バージョン 1.1.0
- i-mobile Android アダプター バージョン 2.0.22.2 をサポートします。
- i-mobile iOS アダプター バージョン 2.1.0.1 に対応しています。
バージョン 1.0.2
- i-mobile Android アダプター バージョン 2.0.22.0 をサポートします。
- i-mobile iOS アダプタ バージョン 2.0.32.0 をサポートします。
バージョン 1.0.1
- i-mobile Android アダプター バージョン 2.0.21.0 をサポートします。
- i-mobile iOS アダプタ バージョン 2.0.31.0 をサポートします。
バージョン 1.0.0
- 初回リリース
- i-mobile Android アダプター バージョン 2.0.20.1 をサポートします。
- i-mobile iOS アダプター バージョン 2.0.29.0 をサポートします。