メディエーションテストスイート

AdMob メディエーションテストスイートを使用すれば、第三者ネットワークから AdMob メディエーション経由で配信された広告を表示できるよう、アプリや広告ユニットが正しく設定されているかどうかを確認できます。

このガイドでは、Androidアプリで AdMob メディエーションテストスイートを使用する方法の概要を説明します。最初のステップは、アプリにツールを統合することです。

前提条件

Android SDK 4.0（API レベル 14）以降
Google Play サービス 9.8.0 以降

AdMob アカウントを作成して、アプリを登録していること

インストール

Gradle を使用する

次の必要な依存関係をアプリの build.gradle ファイルにコピーします。

dependencies {
    // You should already have the ads dependency in your app.
    implementation 'com.google.android.gms:play-services-ads:17.2.0'
    implementation 'com.google.android.ads:mediation-test-suite:0.9.5'
}

最上位の build.gradle ファイルに google() リポジトリを含めます。

// Top-level build file where you can add configuration options common to all
// sub-projects/modules.

buildscript {

   repositories {
       google()
       jcenter()
   }
   dependencies {
       classpath 'com.android.tools.build:gradle:3.1.1'

       // NOTE: Do not place your application dependencies here; they belong
       // in the individual module build.gradle files
   }
}

allprojects {
   repositories {
       google()
       jcenter()
   }
}

メディエーションテストスイートの起動

AdMob アプリ ID をメディエーションテストスイートに提示します。アプリの App ID は AdMob の管理画面で確認できます。

MediationTestSuite.launch(MainActivity.this, "Your application ID");

ツールを開くと、次の免責条項が表示されます。

チェックボックスをオンにし、[Agree] を押して続行します。

アカウントの広告ユニットのリストが、[Failing Ad Units] と [Working Ad Units] の 2 つのタブに分かれて表示されます。

[Failing Ad Units] のリストは、[Missing Components] と [Configuration Errors] に分かれています。

広告ユニットのネットワークがすべて正常にテストされると、広告ユニットは [Failing] タブから [Working] タブに移動します。ネットワークの呼び出しに失敗した場合や広告ユニットが見つからなかった場合、広告ユニットのリストは表示されません。

広告ユニットのリストを検索する場合は、上部にある検索アイコンを押し、広告ユニット ID の文字列を入力します。ネットワーク名や広告フォーマットで検索することもできます。

画面には、指定した広告ユニットについて次の情報が表示されます。

SDK がインストールされているかどうか
アダプタがインストールされているかどうか
必要なマニフェストエントリが正しく設定されているかどうか

[Ad Unit Details] 画面に移動する広告ユニットを選択します。

Ad Unit Details

この画面には、広告ユニットに設定された広告ユニット ID、広告フォーマット、メディエーションウォーターフォールなど、広告ユニットの詳細が表示されます。

この画面の詳細は次のとおりです。

広告ソースの概要

各広告ソースには、SDK やアダプタがインストールされているかどうか、必要なマニフェストエントリが見つかっているかどうかを示すインジケータがあり、このセッションの最新のテスト結果が表示されます。

カスタムイベントの場合は、「Custom Event: Your custom event」ラベルが使用されます。カスタムイベント用に指定したクラスが見つかると、カスタムイベントのアダプタステータスインジケータはオンになります。カスタムイベントの広告は、他のネットワークと同じ方法で読み込みと表示が行われます。

検索

検索アイコンを押すと検索画面が表示され、広告ソースを名前で検索できます。

一括テスト

一括でテストする広告ソースを選択するには、各広告ソース名の左側にあるチェックボックスをオンにします。すると、新しいオプションがナビゲーションバーに表示されます。

選択した広告ソースの広告を順番に読み込むには、右上にある [Load Ads] ボタンを押します。テスト中は進行状況インジケータが表示されます。左上の戻るアイコンを押すと選択が解除されます。

広告の読み込みと表示

広告ソースのエントリをタップすると、広告ソースの詳細画面が表示されます。

画面には、指定した広告ソースについて次の情報が表示されます。

SDK がインストールされているかどうか
アダプタがインストールされているかどうか
必要なマニフェストエントリが正しく設定されているかどうか
設定のパラメータが AdMob コンソールに入力されているかどうか

必要なコンポーネントをすべてインストールしたら、広告の読み込みテストに進むことができます。[Load Ad] をタップすると、広告ソースの SDK に広告リクエストが送信されます。広告リクエストが完了すると、リクエストの成否を示す最新情報が表示されます。

リクエストが失敗した場合は、テスト対象の SDK からのメッセージをコンソールログで確認します。

リクエストが成功した場合:

バナー広告の場合、広告はインラインで表示されます。
インタースティシャル広告やリワード広告の場合は、[Show Ad] をタップして広告を表示できます。

広告は新しい画面で開きます。たとえば、次のようになります。

[Ad Unit Details] 画面に戻ると、広告ユニットのリスト画面で最後に広告をテストした結果が表示されます。正常に読み込まれた広告ソースはリストの一番下に移動され、さらにテストが必要な広告ソースが上部に表示されます。これらの結果は、セッション中のみ保存されます。

本番環境でテストを有効にする

メディエーションテストスイートは、デフォルトでは debuggable ビルドでのみ起動します。これは、エンドユーザーが誤ってテストスイートを起動しないようにするためです。

アプリが本番環境となってからメディエーションテストスイートをデバイスで実行する場合は、ビルドを配布する前に、コンソールログから取得した AdMob テストデバイス ID を使用してデバイスをホワイトリストに登録します。

デバイスをホワイトリストに追加するには、メディエーションテストスイートでテストデバイス ID を登録します。

Java

MediationTestSuite.addTestDevice("33BE2250B43518CCDA7DE426D04EE231");  // An example device ID

Kotlin

MediationTestSuite.addTestDevice("33BE2250B43518CCDA7DE426D04EE231") // An example device ID

本番環境のアプリにメディエーションテストスイートを含める場合は、隠された方法でテストスイートを起動する必要があります（非公開の操作やデバッグメニューなど）。その後、ビルドでホワイトリストに登録されているデバイスでテストスイートを起動できるようになります。

ネットワークの追加パラメータを使用した広告リクエストの設定（省略可）

Vungle などの一部のメディエーション向けネットワークでは、カスタムのネットワーク追加バンドルを提供して、ネットワークへのリクエストに追加情報を含める必要があります（場合によっては省略可）。メディエーションリクエストにネットワークの追加オブジェクト（またはバンドル）を含める場合は、MediationTestSuite.setAdRequest() 静的メソッドを使用してテストスイートの広告リクエストを設定できます。

Java

AdRequest requestBuilder = new AdRequest.Builder();
...
// Set your network extras for your chosen networks here.
// i.e for each network extras bundle, call
// 'requestBuilder.addNetworkExtrasBundle(<network adapter class>, <network extras bundle>)'
...
MediationTestSuite.setAdRequest(requestBuilder.build());

Kotlin

val requestBuilder = AdRequest.Builder()
...
// Set your network extras for your chosen networks here.
// i.e for each network extras bundle, call
// 'requestBuilder.addNetworkExtrasBundle(<network adapter class>, <network extras bundle>)'
...
MediationTestSuite.setAdRequest(requestBuilder.build())

この設定は、メディエーションテストスイートを起動する前に行うようにしてください。

これにより、必要な追加パラメータを使用して広告リクエストのインスタンス化と設定を行えます。テストスイートはこれをメディエーションネットワークへのリクエストに使用できます。

よくある質問

免責条項は毎回表示されますか？: はい。メディエーション広告ソースのテストモードをオンにする必要があることのリマインダーとして、意図的に毎回表示しています。
広告ユニットの詳細ページで AdMob が何回も表示されるのはなぜですか？: 複数のメディエーショングループが同じ広告ユニットをターゲットにしている場合は、すべてのグループが結合されます。たとえば、複数の AdMob エントリ、場合によっては複数の他の広告ソースが表示されることがあります。同じメディエーショングループ内であっても、メディエーションパートナーは最大 3 回まで定義できます。
どのネットワークまたは広告ソースがメディエーションテストスイートでサポートされていますか？: テストスイートは、オープンソースおよびバージョン対応のすべてのアダプタとカスタムイベントアダプタで機能します。オープンソースの広告ネットワークについては、メディエーションに関するページで一覧をご確認いただけます。

メディエーション テストスイート

前提条件

インストール

Gradle を使用する

メディエーション テスト スイートの起動

Ad Unit Details

広告の読み込みと表示

本番環境でテストを有効にする

Java

Kotlin

ネットワークの追加パラメータを使用した広告リクエストの設定（省略可）

Java

Kotlin

よくある質問

メディエーションテストスイート

メディエーションテストスイートの起動