広告ユニットをテストする

プラットフォームを選択: Android iOS Unity Flutter

広告インスペクタは、次のテストに対応しています。

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

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

前提条件

続行する前に、次の操作を行います。

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

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

広告ユニットが複数の広告フォーマットに対応している場合でも、広告インスペクタではテストするフォーマットを選択することはできません。デフォルトでは、最後にリクエストされたフォーマットが使用されます。

広告インスペクタでテスト広告をリクエストする手順は次のとおりです。詳しくは、広告インスペクタ（ベータ版）をご覧ください。

• コンテキスト内:

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

• Out-of-context:

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

広告ユニットの形式が [不明] と表示されている場合は、[テスト広告をリクエスト] がグレー表示されます。1 つの広告ユニットに対して複数のフォーマットをリクエストした場合、広告インスペクタは最後の広告ユニットを使用します。

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

広告インスペクタでは、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. [テストを停止] をタップします。

   

   成功すると、[アプリを強制再起動] に確認メッセージが表示されます。

   

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