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

このガイドでは、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 アカウントに登録またはログインします。

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

次に、「広告スポット名（広告スポット名）」や「広告スポットサイズ（広告スポットのサイズ）」などの情報をフォームに記入します。次に、[新規登録] ボタンをクリックします。

new_ad_spot_form

新しい広告スポットの準備ができました。統合の詳細を表示するには、[アプリ設定取得（App settings を取得）] ボタンをクリックします。

ad_spot_list

パブリッシャー ID（パブリッシャー ID）、メディア ID（メディア ID）、スポット ID（スポット ID）をメモします。これらのパラメータは、後で UI でメディエーション用に i-Mobile を設定するときに必要になります。 Ad Manager

Android

iOS

ステップ 2: 管理画面で i-mobile デマンドを設定する Ad Manager

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

Android

手順については、 Android。

iOS

手順については、 iOS。

ステップ 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.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