広告インスペクタ

広告インスペクタ は、承認されたデバイスがモバイルアプリ内でテスト広告リクエストのリアルタイム分析を直接実行できるアプリ内オーバーレイです。 コーディングなしで有効にできます。

モバイル広告 Flutter 1.3.0 以上では、次のことが可能です。

  • 広告ユニットを確認する
  • サードパーティ製アダプターを検査する
  • 広告が想定どおりに掲載されているか確認する
  • エラーを特定し、解決方法の詳細を確認する
  • 各広告ネットワークの入札とウォーターフォール メディエーションの詳細をリクエストごとに表示する
  • 第三者の入札とメディエーションの広告ソースを個別にテストする

  • 各広告ユニットが入札とウォーターフォール メディエーション用に正しく設定されていることを確認する

  • カスタム イベントの統合をテストする

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

前提条件

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

  • モバイル広告 Flutter プラグイン バージョン1.3.0 以降を使用します。

広告インスペクタを起動

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

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

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

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

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

プログラムから起動する

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

MobileAds.instance.openAdInspector(
  (AdInspectorError? error) {
    // Error will be non-null if ad inspector closed due to an error.
  });

この API は、プログラムまたは AdMob 管理画面で登録されたテストデバイスで機能します。

広告ユニットの表示とトラブルシューティング

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

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

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

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

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

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

広告ユニットの入札単価の詳細を確認する

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

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

bidding の結果は、対応可能なアイテムがリストの先頭になるように並べ替えられています。

  • 上部には、オークションで落札した広告ネットワークが表示されます。

  • 次は問題のある広告ネットワークです。 問題のトラブルシューティング手順に従ってください。

  • 続いて、広告が返されなかった広告ネットワークや入札しなかった広告ネットワークが表示されます。これは、広告ソースの設定や決定が原因で入札が行われなかった場合に、さまざまな問題があることを示している可能性があります。広告ソースの設定ガイドをご覧いただくか、 広告ソースに直接お問い合わせください。

  • リストの一番下に、bidding オークションで落札できなかった広告ネットワークが表示されます。

メディエーションの順次処理では、eCPM 値に応じてオークションで落札した広告ソースをbidding 配置できます。

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

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

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

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

Android
iOS

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

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

アダプターが見つからない場合や初期化に失敗した場合は、 広告インスペクタを使用して見つかった問題のトラブルシューティング で詳細をご確認ください。

Android
iOS

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

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

広告のテスト

このセクションで説明する広告インスペクタの広告テストは、ベースとなる広告エクスペリエンスを検証し、単一の広告ソースのテストで使用する場合のメディエーションの設定を検証するための優れたツールです。

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

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

1 つの広告ソースのテスト

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

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

Android
iOS

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

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

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

アプリを再起動すると、すべての広告ユニットのプレースメントで、選択したネットワークの広告のみが表示されるようになります。単一の広告ソースのテストが有効になっているときに広告インスペクタを起動すると、有効なテスト広告ソースが表示されます。

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

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

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

1 つの広告ソースのテストを停止する

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

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

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

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

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

それには、[Copied ad Inspector JSON to クリップボード] というメッセージが表示されるまでアプリアイコンを 7 回タップします。