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

Google モバイル広告メディエーションテストスイートを使用すると、第三者ネットワークからメディエーション経由で配信された広告を表示するよう、アプリや広告ユニットが正しく設定されているかどうかをテストできます。このガイドでは、アプリにツールを統合して、Android アプリで Google モバイル広告メディエーションテストスイートを使用する方法の概要を説明します。

前提条件

Android SDK 4.1（API レベル 16）以降。
Google Play 開発者サービス 9.8.0 以降。

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

AndroidManifest.xml にアプリ ID が正しく入力されていること。

インストール

Gradle を使用する

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

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

最上位の 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.2.1'

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

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

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

次のコード行を使用して、メディエーションテストスイートを起動します。


MediationTestSuite.launch(MainActivity.this);

テストスイートの操作

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

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

アカウントの広告ユニットのリストが、[動作していない広告ユニット] と [動作している広告ユニット] の 2 つのタブに分かれて表示されます。

テストデバイスの登録

AdMob 管理画面でデバイスがテストデバイスとして登録されていない場合は、テストデバイスとして登録するかどうか尋ねるメッセージが表示されます。

テストデバイスとして登録すると、メディエーションテストスイートで次の操作が可能になります。

テストスイートの管理画面で、広告ユニット ID ではなく広告ユニット名が表示されるようになります。
広告ユニット詳細情報の画面で、広告ユニット ID に加えて広告ユニット名でも検索が行えるようになります。
AdMob からテスト広告を受信できるようになります。

[デバイスを登録] をクリックすると、テストデバイスを登録する AdMob 管理画面のページが表示されます。このページには、メディエーションテストスイートから抽出されたデバイスのプラットフォームと ID があらかじめ入力されています。テストデバイスの名前を追加して [保存] をクリックすると、デバイスが登録されます。詳しくは、テストデバイスを設定するをご覧ください。

デバイスの登録は、メディエーションテストスイートで通常 15 分以内に有効になりますが、24 時間ほどかかる場合もあります。登録のステータスを確認するには、メディエーションテストスイートをいったん閉じてから開き直す必要があります。

テストデバイスの登録ページにアクセスするには、AdMob アカウントにログインしている必要があります。アカウントへのアクセス権がない場合、この方法でデバイスを登録するには、リンクをクリックし、表示されるブラウザで URL をアカウント所有者と共有してください。アカウント所有者がリンクにアクセスし、お客様に代わってデバイスを登録します。

現時点でテストデバイスとして登録しない場合は、[閉じる] をクリックします。

動作していない広告ユニット

[動作していない広告ユニット] のリストは、[コンポーネントがありません] と [設定エラー] に分かれています。

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

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

以下のような場合、この画面には広告ユニットごとに警告が表示されます。

広告ソースの SDK がインストールされていない
広告ソースアダプタがインストールされていない
広告ソースに必要なマニフェストエントリが設定されていない

テストが可能な場合は、すべての広告ソースの総合的なテスト結果のステータスも表示されます。

[広告ユニット詳細情報] 画面に移動する広告ユニットを選択します。

広告ユニット詳細情報

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

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

広告ソースの概要

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

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

検索

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

一括テスト

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

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

広告の読み込みと表示

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

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

SDK がインストールされているかどうか（取得可能な場合、SDK のバージョン）。
アダプタがインストールされているかどうか（取得可能な場合はアダプタのバージョン）。
必要なマニフェストエントリが適切に構成されているかどうか。
アダプタの初期化ステータス（取得可能な場合）。
AdMob コンソールに入力された設定のパラメータ。

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

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

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

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

広告は次のように新しい画面で開きます。

詳細情報の画面に戻ると、ad unitのリスト画面で最後に行った広告テストの結果が表示されます。正常に読み込まれた広告ソースはリストの一番下に移動し、さらにテストが必要な広告ソースが上部に表示されます。

Open Bidding パートナー

Open Bidding のテストについて詳しくは、 Open Bidding 設定ガイドを確認するをご覧ください。

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

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

アプリが本番環境になってから、デバイスでメディエーションテストスイートを実行する必要がある場合は、SDK でデバイスをテストデバイスとして登録します。

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

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

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(\,
// \)'
...
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(\,
// \)'
...
MediationTestSuite.setAdRequest(requestBuilder.build())

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

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