このガイドでは、広告インスペクタの起動方法とさまざまな機能の使い方を説明します。
前提条件
広告インスペクタを使用するには、次の準備が必要です。
- AdMob アカウントを作成して アプリを設定します。
- スタートガイドを完了している。
- Google Mobile Ads SDK バージョン 9.1.0 以降を使用している。
- ご利用のデバイスをテストデバイスとして追加します。 広告インスペクタはテストデバイスでのみ起動します。
広告インスペクタを起動
広告インスペクタは、アプリのどこからでも次の方法で起動できます。
- テストデバイスの登録時に AdMob 管理画面で選択したジェスチャーを使用します。
- 提供された API を使ってプログラムで起動します。
- デバッグ メニューの起動ボタンを使用します。
ジェスチャーを使って起動する
ジェスチャーを使って広告インスペクタを起動するために、アプリに変更を加える必要はありません。テストデバイス用に AdMob で設定したジェスチャー（ダブルフリックまたはシェイク）を実行するだけです。詳細
AdMob 管理画面でジェスチャーを設定し、設定が反映されるまで 15 分待機したら、アプリで広告リクエストを作成して、設定したジェスチャーが Google Mobile Ads SDK に認識されるようにする必要があります。指定したジェスチャーが機能しない場合は、広告を読み込んでからアプリを再起動し、もう一度ジェスチャーをお試しください。
プログラムから起動
広告インスペクタはプログラムで起動することもできます。
この API は、プログラム経由または AdMob 管理画面から 登録された テストデバイスで動作します。
広告ユニットを表示してトラブルシューティングを行う
広告インスペクタを起動するとメイン画面が表示され、入札設定やメディエーション設定がなされた AdMob アプリ ID と関連付けられた、AdMob 管理画面内の全広告 ユニット のリストが次のように表示されます。
広告インスペクタを使用する前に、Google Mobile Ads SDKを初期化することをおすすめします。
広告ユニットのメディエーションの順次処理の詳細を表示する
広告ユニットをタップして、その SDK リクエストログを表示します。このログには、最新の広告リクエストで広告が配信された（または配信できなかった）時点までのメディエーション ウォーターフォールの詳細が表示されます。
Disclosure Indicator を使って各リクエストを展開すると、そのリクエストのメディエーションの順次処理の結果が表示され、そのリクエストでエラーやレイテンシがあった場合はその情報も確認できます。
第三者の広告のソースの場合、エラー メッセージは広告のソースから直接送信されます。詳しい情報が必要な場合は、ご利用の第三者広告のソースにお問い合わせください。
広告ユニットの入札の詳細を表示する
入札を初めてご利用の場合は、 概要をご覧ください。
SDK リクエストログには、広告リクエストで呼び出された入札広告ソースが表示されます。SDK リクエストログの広告ユニットをタップすると、入札オークションの各広告のソースの詳細が表示されます。
入札結果の項目は、実施可能な順に表示されるように並べ替えられています。
リストの最上部に表示されるのは、そのオークションで落札された広告ネットワークです。
その次に表示されるのは、問題のある広告ネットワークです。こうした問題を解決するには、 トラブルシューティングの手順をご覧ください。
さらにその下には、広告の配信や入札をまったくしなかった広告ネットワークが表示されます。こうした広告ネットワークは、その広告のソースの設定や判断材料が原因で入札単価が設定されなかった場合があり、さまざまな問題を示唆している可能性があります。詳しくは、広告のソースの設定ガイドを確認するか、 広告のソースに直接お問い合わせ ください。
リストの一番下には、入札オークションで落札できなかった広告ネットワークが表示されます。
メディエーションの順次処理では、入札オークションで落札した広告のソースを eCPM 値に基づいて配置できます。
メディエーションの順次処理で広告のソースが呼び出されると、広告が配信されます。メディエーションの順次処理における入札の詳しい仕組みは「入札とウォーターフォール方式の広告ソースが両方含まれるメディエーション グループ」の 例 2 と 例 3でご確認ください。
広告ユニットの詳細なデバッグ
広告ユニットのトラブルシューティングを行う際は、広告リクエストとレスポンスを詳しく調べてエラーの原因を特定したり、Google サポートと共有してデバッグを支援してもらったりすると便利です。ウォーターフォール チェーンの上部にあるメニュー アイコンをタップし、[広告リクエストとレスポンスを共有] を選択して、広告リクエストとレスポンス全体をエクスポートします。これにより、アプリでネットワーク トレースを実行する手間が省けます。
また、リクエスト文字列と同じメニューの [第三者の入札パラメータ] オプションをタップすると、デコードされた第三者の入札パラメータを確認できます。これにより、問題が発生している可能性のある第三者の入札パラメータの詳細を確認できるため、アプリのデバッグや、ネットワークがシグナルを正常に収集しているかどうかの検証に役立ちます。
利用可能なアダプタを確認する
[アダプタ] タブをクリックすると、アプリの入札やメディエーションの構成に含まれる広告ソースに関連付けられた第三者アダプタの一覧が表示されます。カードを展開すると、初期化ステータスと SDK バージョンを確認できます。 サポートされているサードパーティ アダプタに加えて、カスタム イベント アダプタを表示することもできます。
カスタム イベントを使用すると、 AdMob でサポートされていない広告ネットワークを使用できるようになります。カスタム イベントは、アダプタのリストで、一意のクラス名によって標準のサードパーティ アダプタと区別できます。広告インスペクタでは、クラス名とステータス情報に加え、AdMob ウェブ インターフェースでカスタム イベントに割り当てられたラベルも表示されます。
アダプタが見つからない場合や初期化に失敗した場合は、 広告インスペクタを使用して発見された問題のトラブルシューティングを行う をご覧ください。
広告ユニットをテストする
アプリの UI で広告ユニットに移動せずにテストしたい場合は、広告インスペクタの広告ユニットの詳細画面から直接テストできます。 さらに、複数の広告ユニットを一度にテストしたり、テスト広告リクエストを非同期で読み込んで表示したり、単一の広告のソースのテストを実施したりできます。
広告のテスト
このセクションで説明する広告インスペクタの広告テストは、基本的な広告エクスペリエンスを検証するのに最適なツールです。単一の広告のソースのテストと組み合わせて使用すると、メディエーション設定を検証できます。
広告ユニットをテストする準備ができたら、広告インスペクタ画面の上部にある [テスト広告をリクエスト] ボタンをタップして、広告インスペクタの広告テストをトリガーします。テスト結果は、[広告インスペクタからリクエストされました] というヘッダーの下の SDK リクエストログに表示されます。
単一の広告のソースのテスト
広告インスペクタには、1 つの 入札または ウォーターフォール メディエーションの広告のソースからの広告だけを配信するように、アプリ内の広告リクエストを制限する機能があります。これにより、サードパーティアダプターが正しく実装されているか、広告のソースが想定どおりに広告を配信しているかを検証できます。
この機能を有効にするには、画面下部の [単独の広告ソースのテスト] スイッチを有効にします。これにより、次の広告のソース選択ダイアログが表示されます。
注: 単一の広告のソースをテストするには、Google Mobile Ads SDK を 初期化する必要があります。
ここで、テストする単独の広告のソースを選択できます。広告ソースを選択すると、次の画面が表示されます。
単独の広告のソースのテスト設定は、その後に同じセッションで作成される広告リクエストにも適用されます。ただし、そのセッションで以前にキャッシュされた広告のうち、まだ表示されていないものには適用されません。単独の広告のソースのテストを適用する際は、指定した広告のソースがリクエストを受信する代わりに配信される可能性のあるキャッシュ済みの広告を無効にするため、アプリを強制的に再起動することをおすすめします。
アプリを再起動すると、すべての広告ユニットのプレースメントには、選択したネットワークからの広告のみが表示されるように試行されます。単独の広告のソースのテストを実施している間に広告インスペクタを起動すると、次のようにテスト中の広告のソースが表示されます。
単独の広告のソースのテストモードでは、リクエストされた広告ユニットの入札またはメディエーションがその広告のソースで設定されているかどうかにかかわらず、すべての広告リクエストに対してその広告のソースの広告が配信されるようになります。テストしている広告のソースが広告ユニットのメディエーションの順次処理に含まれない場合、「No fill（広告なし）のエラー」が表示されます。
単独の広告ソースのテストでは、広告ユニットをタップすると SDK リクエストログが表示されます。 これにより、単独の広告ソースのテストが有効になった後に発生した広告リクエストに対して、その広告ソースから広告が配信されたかどうかを確認できます。広告のソースが広告の読み込みに失敗すると、エラーを説明するエラー メッセージが表示されます。
選択した広告ソースの複数のインスタンスがメディエーション ウォーターフォールに追加されていた場合、広告が配信されるか、広告が配信されずにウォーターフォールが終了するまで、ウォーターフォール内で広告ソースを呼び出す各インスタンスが表示されます。
単独の広告のソースのテストを停止する
テストを停止するには、スイッチをオフにします。
すると、次の再起動画面に確認メッセージが表示されます。
テストを停止した後は、テスト対象だった広告のソースのキャッシュ済みの広告を無効にするため、アプリを強制的に再起動することをおすすめします。
プライバシー設定をデバッグする
前提条件: Google Mobile Ads SDK バージョン 9.6.0 以降
広告インスペクタを使用すると、パブリッシャー様による IAB ヨーロッパの TCF の統合の一環として、広告 リクエストで渡される次のプライバシーシグナルを確認できます。
- GDPR が適用される（
IABTCF_gdprApplies） - AC 文字列（
IABTCF_AddtlConsent） - TC 文字列（
IABTCF_TCString）
広告を読み込むか、広告インスペクタで 広告テスト を実行したら、[SDK リクエストログ]のリクエストのメニューアイコンをタップします。 次に、[プライバシー シグナル] オプションを選択します。
[プライバシー シグナル] 画面に、広告リクエストで渡されたプライバシー シグナルが表示されます。
AC 文字列の詳細については、 Google の追加同意の技術仕様をご覧ください。 TC 文字列の同意の詳細（CMP ID や IAB に関連付けられた同意済みベンダー ID のリストなど）を表示するには、[デコード] をクリックして [IAB GPP エンコーダ / デコーダ] を開きます。
エラーが発生した場合は、 プライバシーに関する問題についての手順 に沿ってトラブルシューティングを行ってください。
デバッグ出力全体をコピーする
広告インスペクタでは、AdMob で収益化しているアプリの詳細、アダプタの初期化ステータス、すべての広告ユニットのテスト結果など、デバッグ出力全体を含む JSON 文字列をツールからコピーできます。
コピーするには、[広告インスペクタの JSON をクリップボードにコピーしました] というメッセージが表示されるまで、アプリアイコンを 7 回タップします。