このページは Cloud Translation API によって翻訳されました。

広告インスペクタ

広告インスペクタは、承認済みのデバイスにおいて、モバイルアプリ内でテスト広告リクエストを直接分析できるアプリ内オーバーレイです。 Google Mobile Ads SDK バージョン 20.0.0 以降に付属しており、コーディングなしでご利用いただけます。

バージョン 20.2.0 より前の Mobile Ads SDK で広告インスペクタを使用する場合、以下を行うことができます。

広告ユニットを確認する
第三者アダプタを検査する
広告が想定どおりに表示されているか確認する
エラーを特定し、解決方法の詳細を表示する
リクエストごとに各広告ネットワークのメディエーションの詳細を表示する
第三者のメディエーションの広告ソースを個別にテストする
各広告ユニットがウォーターフォールメディエーション用に正しく設定されていることを確認する
カスタムイベントの統合をテストする

Mobile Ads SDK バージョン 20.2.0 以降の場合は、次のことも可能です。

各広告ネットワークの入札の詳細をリクエストごとに表示する
各広告ネットワークの入札とウォーターフォールメディエーションの詳細をリクエストごとに表示する
第三者によって入札された広告ソースまたはウォーターフォールメディエーションの広告ソースを個別にテストする
各広告ユニットが入札とウォーターフォールメディエーション用に正しく設定されていることを確認する

このガイドでは、広告インスペクタの起動方法とさまざまな機能の使い方を説明します。

前提条件

広告インスペクタを使用するには、次のことを行う必要があります。

AdMob アカウントを作成して、アプリを設定します。

スタートガイドを完了している。

Google Mobile Ads SDK バージョン 20.0.0 以降を使用してください。

自分のデバイスをテストデバイスとして追加します。広告インスペクタはテストデバイスでのみ起動します。

広告インスペクタを起動

広告インスペクタは、次の方法でアプリのどこからでも起動できます。

テストデバイスの登録時に、AdMob 管理画面で選択したジェスチャーを使用します。
提供された API を使ってプログラムで起動します。
デバッグメニューの起動ボタンを使用

ジェスチャーを使用して起動する

ジェスチャーを使って広告インスペクタを起動するために、アプリに変更を加える必要はありません。テストデバイス用に AdMob で設定したジェスチャー（ダブルフリックまたはシェイク）を実行するだけです。詳細

AdMob 管理画面で操作を設定し、その操作が反映されるまでに 15 分待つと、アプリは Google Mobile Ads SDK に対して操作の設定を学習させる広告リクエストを発行する必要があります。指定したジェスチャーが機能しない場合は、広告を読み込んでからアプリを再起動し、もう一度ジェスチャーをお試しください。

プログラムから起動する

広告インスペクタはプログラムで起動することもできます。

Java

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

Kotlin

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

この API は、プログラム経由または AdMob 管理画面から登録されたテストデバイスで動作します。

広告ユニットを表示してトラブルシューティングする

広告インスペクタのメイン画面が表示されます。この画面には、入札またはメディエーションが設定されている AdMob アプリ ID に関連付けられている、AdMob 管理画面のすべての広告ユニットのリストが表示されます。

広告インスペクタを使用する前に、Google Mobile Ads SDK を初期化することをおすすめします。

広告ユニットのメディエーションウォーターフォールの詳細を表示する

広告ユニットをタップすると SDK リクエストログが表示され、最新の広告リクエストについて、広告が配信された時点（または広告が配信されずにウォーターフォールが終了した時点）までのメディエーションウォーターフォールの詳細を確認できます。

開示インジケーターを使って各リクエストを開くと、そのリクエストのメディエーションウォーターフォールの結果と、そのリクエストで発生したエラーやレイテンシが表示されます。

第三者の広告ソースの場合、エラーメッセージは広告ソースから直接送信されます。詳しくは、第三者の広告ソースにお問い合わせください。

広告ユニットの入札の詳細を表示する

前提条件: Google Mobile Ads SDK 20.2.0 以降

入札を初めて使用する場合は、概要をご覧ください。

SDK リクエストログには、広告リクエストで呼び出された入札広告ソースが表示されます。SDK リクエストログで広告ユニットをタップすると、入札オークションの各広告ソースの詳細が表示されます。

入札結果は、操作可能なアイテムがリストの先頭になるように並べ替えられます。

上部には、オークションで落札した広告ネットワークが表示されます。
次は問題のある広告ネットワークです。こうした問題を解決するには、トラブルシューティングの手順をご覧ください。
さらにその下には、広告の配信や入札をまったくしなかった広告ネットワークが表示されます。こうした広告ネットワークは、その広告ソースの設定や判断材料が原因で入札単価が設定されなかった場合があり、さまざまな問題を示唆している可能性があります。詳しくは、広告ソースの設定ガイドを確認するか、広告ソースに直接お問い合わせください。
リストの一番下には、入札で落札できなかった広告ネットワークが表示されます。

メディエーションウォーターフォールでは、入札オークションで落札した広告ソースを eCPM 値に基づいて配置できます。

メディエーションウォーターフォールで広告ソースが呼び出されると、広告を配信できるようになります。メディエーションウォーターフォールにおける入札の詳しい仕組みは「入札とウォーターフォール方式の広告ソースが両方含まれるメディエーショングループ」の例 2 と例 3 でご確認ください。

広告ユニットの高度なデバッグ

広告ユニットのトラブルシューティングを行う際は、広告リクエストとレスポンスを確認して問題の原因を特定したり、Google サポートと共有してデバッグを支援したりすると役に立ちます。ウォーターフォールチェーンの上部にあるメニューアイコンをタップし、[広告リクエストとレスポンスを共有] を選択して、広告リクエストとレスポンス全体をエクスポートします。これにより、独自のアプリでネットワークトレースを実行する手間が省けます。

また、リクエスト文字列と同じメニューにある [第三者入札パラメータ] オプションをタップすると、デコードされた第三者入札パラメータを表示できます。問題がある可能性のある第三者入札パラメータの詳細を確認できるため、アプリのデバッグや、ネットワークがシグナルを正常に収集しているかどうかの検証に役立ちます。

利用可能なアダプターを表示する

[アダプタ] タブをクリックすると、アプリの入札設定またはメディエーション設定で指定された広告ソースに関連付けられているすべてのサードパーティアダプタのリストが表示されます。次に、カードを展開して初期化ステータスと SDK バージョンを確認します。サポートされているサードパーティアダプタとともに、カスタムイベントアダプタを表示することもできます。カスタムイベントを使用すると、AdMob でサポートされていない広告ネットワークを使用できます。カスタムイベントは、アダプタのリストで固有のクラス名によって標準のサードパーティアダプタと区別できます。広告インスペクタでは、クラス名とステータス情報に加え、AdMob ウェブインターフェースでこれらのカスタムイベントに割り当てられたラベルも表示されます。

アダプタが見つからない、または初期化できない場合は、広告インスペクタを使って発見された問題のトラブルシューティングを行うをご覧ください。

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

アプリの UI で広告ユニットに移動しなくても広告ユニットをテストしたい場合は、広告インスペクタの広告ユニットの詳細画面から直接テストできます。また、複数の広告ユニットを一度にテストしたり、テスト用の広告リクエストを非同期で読み込んで表示したり、単一の広告ソースのテストを行ったりすることもできます。

広告テスト

このセクションで説明する Ad inspector 広告テストは、単一の広告ソースのテストと組み合わせて使用することで、ベースの広告エクスペリエンスを検証し、メディエーション設定を検証するのに適したツールです。

広告ユニットをテストする準備ができたら、広告インスペクタ画面の上部にある [テスト広告をリクエスト] ボタンをタップして、広告インスペクタの広告テストをトリガーします。テスト結果は、SDK リクエストログの [Requested from ad inspector] というヘッダーの下に表示されます。

アプリで広告インスペクタを使用する方法

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

広告インスペクタには、1 つの入札またはウォーターフォールメディエーションの広告ソースからの広告だけを配信するように、アプリ内の広告リクエストを制限する機能があります。これにより、第三者アダプタが正しく実装されていることと、広告ソースが想定どおりに配信されていることを確認できます。

この機能を有効にするには、画面下部にある [単一の広告ソースのテスト] スイッチを切り替えます。これにより、次の広告ソース選択ダイアログが表示されます。

単独の広告ソースをテストするには、Google Mobile Ads SDK を初期化する必要があります。

その後、テストする広告ソースを 1 つ選択できます。広告ソースを選択すると、次の画面が表示されます。

単独の広告ソースのテスト設定は、その後に同じセッションで作成される広告リクエストにも適用されます。ただし、そのセッションで以前にキャッシュされた広告のうち、まだ表示されていないものには適用されません。単独の広告ソースのテストを適用する場合は、選択した広告ソースではなく、キャッシュ内の広告が配信される可能性があるため、アプリを強制的に再起動することをおすすめします。

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

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

単独の広告ソースのテストでは、広告ユニットをタップすると SDK リクエストログを表示できます。これにより、単独の広告ソースのテストを有効にした後に行われた広告リクエストに、その広告ソースが配信したかどうかを確認できます。広告ソースが広告の読み込みに失敗した場合は、エラーを説明するエラーメッセージが表示されます。

選択した広告ソースの複数のインスタンスがメディエーションウォーターフォールに追加されていた場合、広告が配信されるか、広告が配信されずにウォーターフォールが終了するまで、ウォーターフォール内で広告ソースを呼び出す各インスタンスが表示されます。

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

テストを停止するには、スイッチをオフに切り替えます。

次の再起動画面に確認メッセージが表示されます。

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

デバッグ出力全体をコピーする

広告インスペクタは、AdMob アプリの詳細、アダプターの初期化ステータス、すべての広告ユニットのテスト結果など、ツールからのデバッグ出力全体を含む JSON 文字列のコピーをサポートしています。

コピーするには、アプリアイコンを 7 回タップして、[広告インスペクタの JSON がクリップボードにコピーされました] というメッセージが表示されるまで待ちます。