i-mobile をメディエーションと統合する

このガイドでは、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 レベル 21 以降
  • iOS にデプロイするには
    • iOS デプロイ ターゲットが 12.0 以降
  • Google Mobile Ads SDK で設定された動作する Unity プロジェクト。詳しくは、使ってみるをご覧ください。
  • メディエーションのスタートガイドを完了していること

ステップ 1: i-mobile UI で設定を行う

i-mobile アカウントに登録またはログインします。

[サイト / アプリ管理] タブと、アプリのプラットフォームのボタンをクリックして、アプリを i-mobile ダッシュボードに追加します。

Android

iOS

フォームに入力し、[新規登録] ボタンをクリックします。

Android

iOS

新しい広告スポットを作成するには、[サイト / アプリ管理] タブでアプリを選択します。

Android

iOS

[広告スポット管理] タブに移動し、[新規広告スポット] ボタンをクリックします。

create_ad_spot

次に、フォームに広告スポット名（Ad Spot name）、広告スポットサイズ（Ad Spot size）などの詳細情報を入力します。[新規登録] ボタンをクリックします。

new_ad_spot_form

新しい広告枠が作成されました。統合の詳細を表示するには、[アプリ設定取得] ボタンをクリックします。

ad_spot_list

パブリッシャー ID、メディア ID、スポット ID をメモします。これらのパラメータは、後で AdMob 管理画面でメディエーション用に i-mobile を構成するときに必要になります。

Android

iOS

ステップ 2: AdMob UI で i-mobile デマンドを設定する

広告ユニットのメディエーション設定を行う

Android

手順については、 Android 向けガイドのステップ 2 をご覧ください。

iOS

手順については、 iOS 向けガイドのステップ 2 をご覧ください。

ステップ 3: i-mobile SDK とアダプタをインポートする

OpenUPM-CLI

OpenUPM-CLI をインストールしている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Unity 用 Google Mobile Ads i-mobile メディエーション プラグインをプロジェクトにインストールできます。

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

Unity プロジェクト エディタで、[Edit] > [Project Settings] > [Package Manager] を選択して、Unity Package Manager Settings を開きます。

[スコープ付きレジストリ] タブで、OpenUPM をスコープ付きレジストリとして追加し、次の詳細情報を指定します。

  • 名前: OpenUPM
  • URL: https://package.openupm.com
  • スコープ: com.google

OpenUPM の詳細

次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウン メニューから [My Registries] を選択します。

Unity レジストリ

[Google Mobile Ads i-mobile Mediation] パッケージを選択し、[Install] をクリックします。

OpenUPM からインストールする

Unity パッケージ

変更ログのダウンロード リンクから i-mobile 用 Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ZIP ファイルから GoogleMobileAdsIMobileMediation.unitypackage を抽出します。

Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsIMobileMediation.unitypackage ファイルを見つけます。すべてのファイルのチェックボックスがオンになっていることを確認して、[インポート] をクリックします。

Unity からインポートする

次に、[Assets] > [External Dependency Manager] > [Android Resolver] > [Force Resolve] を選択します。External Dependency Manager ライブラリは、依存関係の解決を最初から実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリにコピーします。

強制解決

ステップ 4: 追加のコードが必要

Android

i-mobile の統合に追加のコードは必要ありません。

iOS

SKAdNetwork の統合

i-mobile のドキュメントに沿って、SKAdNetwork ID をプロジェクトの Info.plist ファイルに追加します。

ステップ 5: 実装をテストする

テスト広告を有効にする

AdMob 用にテストデバイスを登録してください。 i-mobile では、テスト用のスポット ID、メディア ID、パブリッシャー ID がこちらで提供されています。

テスト広告を確認する

i-mobile からテスト広告が配信されていることを確認するには、広告インスペクタで i-mobile（ウォーターフォール）広告ソースを使用して単一の広告ソースをテストします。

エラーコード

アダプターが 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 AdMob UI で構成された i-mobile サーバー パラメータが存在しないか、無効です。
103 リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。
104 i-mobile のネイティブ コンテンツ広告の読み込み成功コールバックから、空のネイティブ コンテンツ広告リストが返されました。

iOS

エラーコード 理由
0-10 i-mobile SDK からエラーが返されました。詳しくは、コードをご覧ください。
101 AdMob UI で構成された i-mobile サーバー パラメータが存在しないか、無効です。
102 リクエストされた広告サイズが、i-mobile でサポートされているバナーサイズと一致しません。
103 i-mobile で広告を表示できませんでした。
104 i-mobile から空のネイティブ広告配列が返されました。
105 i-mobile でネイティブ広告アセットをダウンロードできませんでした。
106 i-mobile では、同じ Spot ID を使用して複数のインタースティシャル広告をリクエストすることはできません。

i-mobile Unity メディエーション プラグインの変更履歴

バージョン 1.3.6

バージョン 1.3.5

バージョン 1.3.4

バージョン 1.3.3

バージョン 1.3.2

バージョン 1.3.1

バージョン 1.3.0

バージョン 1.2.2

バージョン 1.2.1

バージョン 1.2.0

バージョン 1.1.0

バージョン 1.0.2

バージョン 1.0.1

バージョン 1.0.0