このガイドでは、Google Mobile Ads SDK でメディエーションを使用して i-mobile から広告を読み込み、表示する方法について説明します。ここでは、ウォーターフォールの統合について説明しています。i-mobile を広告ユニットのメディエーション設定に追加する方法と、i-mobile SDK とアダプタを Unity アプリに統合する方法について説明します。
i-mobile のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されます。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンを括弧内に英語に翻訳して記載しています。
サポートされている統合と広告フォーマット
i-mobile 向け Ad Manager メディエーション アダプタの機能は次のとおりです。
インテグレーション | |
---|---|
入札 | |
ウォーターフォール | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 |
要件
- Unity 5.6 以降
- 最新の Google Mobile Ads SDK
- Android にデプロイするには
- Android API レベル 21 以降
- 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 を設定するときに必要になります。 Ad Manager
Android
iOS
ステップ 2: 管理画面で i-mobile デマンドを設定する Ad Manager
広告ユニットのメディエーション設定を行う
ステップ 3: i-mobile SDK とアダプターをインポートする
変更履歴のダウンロード リンクから i-mobile 向け Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsIMobileMediation.unitypackage
を抽出します。
Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsIMobileMediation.unitypackage
ファイルを見つけます。すべてのファイルが選択されていることを確認して、[インポート] をクリックします。
次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolve] を選択します。Unity Play 開発者サービス リゾルバ ライブラリは、依存関係の解決をゼロから実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android
ディレクトリにコピーします。
ステップ 4: 追加のコードを要求する
Android
i-mobile の統合には追加のコードは必要ありません。
iOS
SKAdNetwork との統合
i-mobile のドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの Info.plist
ファイルに追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
Ad Manager。 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 で設定した Ad Manager i-mobile サーバー パラメータがないか、無効です。 |
103 | リクエストされた広告サイズは、i-mobile でサポートされているバナーサイズと一致しません。 |
104 | i-mobile のネイティブ広告の読み込み成功コールバックから、空のネイティブ広告リストが返されました。 |
iOS
エラーコード | 理由 |
---|---|
0-10 | i-mobile SDK からエラーが返されました。詳しくは、コードをご覧ください。 |
101 | UI で設定した Ad Manager i-mobile サーバー パラメータがないか、無効です。 |
102 | リクエストされた広告サイズは、i-mobile でサポートされているバナーサイズと一致しません。 |
103 | i-mobile が広告を表示できませんでした。 |
104 | i-mobile が空のネイティブ広告配列を返しました。 |
105 | i-mobile がネイティブ広告アセットをダウンロードできませんでした。 |
106 | i-mobile では、同じ Spot ID を使用して複数のインタースティシャル広告をリクエストすることはできません。 |
i-mobile Unity メディエーション プラグインの変更履歴
バージョン 1.3.5
- i-mobile Android アダプター バージョン 2.3.2.0 をサポートします。
- i-mobile iOS アダプター バージョン 2.3.4.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 1.3.4
- i-mobile Android アダプター バージョン 2.3.1.2 をサポートしています。
- i-mobile iOS アダプター バージョン 2.3.4.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 1.3.3
- i-mobile Android アダプター バージョン 2.3.1.1 をサポートします。
- i-mobile iOS アダプター バージョン 2.3.3.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 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 Plugin バージョン 7.4.1 でビルド、テストされていること。
バージョン 1.3.0
- i-mobile Android アダプター バージョン 2.3.0.0 をサポートします。
- i-mobile iOS アダプター バージョン 2.3.0.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.3.1 でビルド、テストされていること。
バージョン 1.2.2
- i-mobile Android アダプター バージョン 2.0.23.1 をサポートします。
- i-mobile iOS アダプター バージョン 2.2.0.1 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 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 をサポートします。