テスト広告ユニット

広告検査ツールでは、次のテストがサポートされています。

  • コンテキスト内テスト: アプリ内の広告ユニットから広告を読み込みます。広告インスペクタを開くと、広告ユニットから行われたリクエストの詳細を確認できます。
  • コンテキスト外テスト: アプリの UI に移動せずに、広告インスペクタで広告ユニットを直接テストします。複数の広告ユニットを一度にテストしたり、テスト広告リクエストを非同期で読み込んで表示したり、単一の広告ソースのテストを行ったりできます。

コンテキスト外テストを実行する場合、リクエストには、子ども向けコンテンツ向けの処理の設定、カスタム ターゲティング、ネットワーク エクストラ、さまざまなサイズなど、アプリの UI で実行するパラメータは含まれません。これらのリクエストには制限があるため、アプリの UI でコンテキスト内テストを使用することをおすすめします。

前提条件

続行する前に、次のことを行います。

  • 最初の前提条件のすべての項目を完了して、AdMob アカウントを作成、テストデバイスを設定し、Google Mobile Ads SDK を初期化して最新バージョンをインストールします。
  • 広告インスペクタを起動します。

テスト広告をリクエストする

広告検査ツールでテスト広告をリクエストする手順は次のとおりです。詳しくは、アプリで広告インスペクタを使用する方法をご覧ください。

  • コンテキスト内:

    1. テストデバイスでアプリの UI に移動し、広告を読み込みます。
    2. 広告インスペクタを開きます。[広告ユニット] タブで、広告を読み込んだ広告ユニットを見つけます。
    3. [SDK リクエストログ] で、リクエストしたテスト広告の詳細を確認します。
  • Out-of-context:

    1. [広告ユニット] タブで広告ユニットをタップし、[テスト広告をリクエスト] をクリックします。
    2. [SDK リクエストログ] で、リクエストしたテスト広告の詳細を確認します。

広告ユニットのフォーマットが [不明] と表示されている場合、[テスト広告をリクエスト] はグレー表示になります。

単一の広告ソースをテストする

広告インスペクタでは、1 つの入札またはウォーターフォールの広告ソースからの広告のみを配信するように、アプリ内の広告リクエストを制限できます。このアプローチでは、第三者アダプタが正しく統合され、広告ソースが想定どおりに配信されていることを確認できます。

単一の広告ソースをテストするには、次の手順を行います。

  1. 広告インスペクタで、[単一の広告ソースのテスト] をオンに切り替えます。[単一の広告ソースのテスト] ダイアログが表示されます。

  2. テストする広告ソースを選択します。その後、[アプリを強制再起動] ページが表示されます。

単独の広告ソースのテスト設定は、その後に作成されるすべての広告リクエストに適用されます。このテストは、そのセッションで以前にキャッシュされた広告には適用されません。単一の広告ソースのテストを適用する際は、アプリを強制的に再起動することをおすすめします。このアプローチでは、指定した広告ソースがリクエストを受け取る代わりに、キャッシュに保存されている広告が無効になります。

アプリを再起動すると、すべての広告ユニットのプレースメントには、選択した広告ソースからの広告が表示されます。単独の広告ソースのテストを実施している間に広告インスペクタを起動すると、次のようにテスト中の広告ソースが表示されます。

単独の広告ソースのテストモードでは、その広告ソースが入札またはウォーターフォール用に設定されているかどうかにかかわらず、すべての広告リクエストに対してその広告ソースの広告が配信されるようになります。テストしている広告ソースが広告ユニットの入札またはウォーターフォールに設定されていない場合は、次のエラー メッセージが表示されます。

Ad Unit has no applicable adapter for single ad source testing on network: AD_SOURCE_ADAPTER_CLASS_NAME

単一の広告ソースのテスト開始後に広告ソースが広告リクエストを配信したかどうかを確認するには、広告ユニットをタップして SDK リクエストログを表示します。広告ソースが広告の読み込みに失敗すると、エラーを説明するエラー メッセージ(Adapter failed to initialize など)が表示されます。

選択した広告ソースの複数のインスタンスがウォーターフォールに追加されている場合、広告ソースを呼び出す各インスタンスが表示されます。このプロセスは、広告が配信されるか、広告が配信されずにウォーターフォールが終了するまでレンダリングされます。

単独の広告ソースのテストを停止する

テストを停止するには、次の操作を行います。

  1. 広告インスペクタで、[単一の広告ソースのテスト] をオフに切り替えます。[単独の広告ソースのテストを停止しますか?] ダイアログが表示されます。
  2. [テストを停止] をタップします。

    正常に完了すると、[アプリを強制的に再起動] の上に確認メッセージが表示されます。

テスト対象の広告ソースのキャッシュ済み広告を取り消すには、テストを停止した後にアプリを強制的に再起動することをおすすめします。