広告インスペクタを使用すると、次のことができます。
- 広告ユニットを確認する
- 広告が想定どおりに掲載されているか確認する
- エラーを特定し、解決方法の詳細を確認する
- リクエストごとに各 Open Bidding 広告ネットワークの詳細を表示する
- リクエストごとに各広告ネットワークのメディエーションの詳細を表示する
- 第三者の Open Bidding またはウォーターフォール メディエーションの広告ソースを個別にテストする
- 各広告ユニットが Open Bidding とウォーターフォール メディエーション用に正しく設定されていることを確認する
このガイドでは、広告インスペクタを起動してさまざまな機能を使用する方法について説明します。
前提条件
広告インスペクタを使用するには、次のことを行う必要があります。
- スタートガイドを完了している。
- Google Mobile Ads SDK バージョン 20.2.0 以降を使用します。
- テストモードを有効にするか、デバイスをアド マネージャーにリンクします。広告インスペクタは、テストデバイスまたはリンクされたデバイスでのみ起動します。
広告インスペクタを起動
広告インスペクタは、次の方法でアプリのどこからでも起動できます。
- デバッグ メニューの起動ボタンを使用します。
- 広告インスペクタの設定で選択したジェスチャーを使用します。
- 提供された API を使用してプログラムで作成する。
デバッグ メニューを使用して起動する
デバッグ メニューから広告インスペクタを起動するために、アプリに変更を加える必要はありません。アド マネージャー ネットワークから配信された広告を見つけて、2 本の指で広告を長押ししてデバッグ メニューを開くだけです。[広告インスペクタを開く] を選択します。
デバイスをリンクしていない場合は、アド マネージャー アカウントへのログインを求められることがあります。
デバッグ設定から [広告インスペクタの設定] を選択し、今後はデバッグ メニューを経由せずに広告インスペクタを開くことができるジェスチャーを選択することもできます。
プログラムから起動する
広告インスペクタはプログラムで起動することもできます。
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 管理画面を開くと、広告インスペクタのメイン画面が表示され、入札またはメディエーションが設定されている AdMob アプリ ID に関連付けられているすべての広告ユニット このアプリ セッション中に広告インスペクタが有効になってから、デバイスが広告リクエストを行っている。このリストには、Open Bidding が有効になっている広告ユニット(完了したリクエストが最も新しい順)と完了した広告リクエストがない(グレー表示)広告ユニットも表示されます。
広告インスペクタを使用する前に、Google Mobile Ads SDK を初期化することをおすすめします。
広告ユニットのメディエーション ウォーターフォールの詳細を表示する
広告ユニットをタップすると SDK リクエストログが表示され、最新の広告リクエストについて、広告が配信された時点(または広告が配信されずにウォーターフォールが終了した時点)までのメディエーション ウォーターフォールの詳細を確認できます。
開示インジケーターを使って各リクエストを開くと、そのリクエストのメディエーション ウォーターフォールの結果と、そのリクエストで発生したエラーやレイテンシが表示されます。
第三者広告ソースの場合、エラー メッセージは広告ソースから直接送信されます。詳しくは、第三者の広告ソースにお問い合わせください。
広告ユニットの入札単価の詳細を確認する
Open Bidding を初めて使用する場合は、Open Bidding の概要をご覧ください。
SDK リクエストログでは、広告リクエストで呼び出された Open Bidding 広告ソースを確認できます。SDK リクエストログの広告ユニットをタップすると、オークション内の各広告ソースの詳細が表示されます。 Open Bidding
Open Bidding の結果は、対応可能なアイテムがリストの先頭になるように並べ替えられています。
上部には、オークションで落札した広告ネットワークが表示されます。
次は問題のある広告ネットワークです。 よくある質問の最後にある問題のトラブルシューティングの手順をご覧ください。 Open Bidding
続いて、広告が返されなかった広告ネットワークや入札しなかった広告ネットワークが表示されます。これは、広告ソースの設定や決定が原因で入札が行われなかった場合に、さまざまな問題があることを示している可能性があります。広告ソースの設定ガイドをご覧いただくか、 Open Bidding に関するよくある質問もご覧ください。
リストの一番下に、Open Bidding オークションで落札できなかった広告ネットワークが表示されます。
メディエーションの順次処理では、eCPM 値に応じてオークションで落札した広告ソースをOpen Bidding 配置できます。
メディエーション ウォーターフォールとは、複数の収益グループが同じ広告枠をめぐって競合した結果です。1 つの収益グループには、Open Bidding の収益パートナーとモバイルアプリ向けメディエーションの収益パートナーの両方を含め、最大 10 件の第三者収益パートナーを追加できます。
広告ユニットの高度なデバッグ
広告ユニットのトラブルシューティングを行う際は、広告リクエストとレスポンスを詳しく調べて、エラーが発生している箇所を特定したり、Google サポートと共有してデバッグに役立てたりすることができます。ウォーターフォール チェーンの上部にあるメニュー アイコンをタップし、[広告リクエストとレスポンスを共有] を選択して、広告リクエストとレスポンス全体をエクスポートします。これにより、独自のアプリでネットワーク トレースを実行する手間を省くことができます。
また、リクエスト文字列と同じメニューにある [第三者入札パラメータ] オプションをタップすると、デコードされた第三者入札パラメータを表示できます。問題がある可能性のある第三者入札パラメータの詳細を確認できるため、アプリのデバッグや、ネットワークがシグナルを正常に収集しているかどうかの検証に役立ちます。
利用可能なアダプターを表示する
[アダプタ] タブをクリックすると、アプリの入札設定またはメディエーション設定で指定された広告ソースに関連付けられているすべてのサードパーティ アダプタのリストが表示されます。次に、カードを展開して初期化ステータスと SDK バージョンを確認します。サポートされているサードパーティ アダプタとともに、カスタム イベント アダプタを表示することもできます。カスタム イベントを使用すると、サポートされていない広告ネットワークを使用できます。 Ad Managerカスタム イベントは、アダプタリスト内の標準のサードパーティ アダプタと、固有のクラス名で区別できます。広告インスペクタでは、クラス名とステータス情報が表示されるだけでなく、カスタム イベントに割り当てられたラベルがAd Manager ウェブ インターフェースに表示されます。
アダプターが見つからない場合や初期化に失敗した場合は、 モバイルアプリの広告配信を検査する で詳細をご確認ください。
広告ユニットをテストする
広告インスペクタを使用すると、アプリの UI で移動することなく広告ユニットをテストしたい場合は、広告ユニットの詳細画面から直接テストできます。また、一度に複数の広告ユニットをテストしたり、テスト用の広告リクエストを非同期で読み込んで表示したり、単一の広告ソースのテストを実行したりすることもできます。
広告のテスト
このセクションで説明する広告インスペクタの広告テストは、ベースとなる広告エクスペリエンスを検証し、単一の広告ソースのテストで使用する場合のメディエーションの設定を検証するための優れたツールです。
広告ユニットをテストする準備ができたら、広告インスペクタの画面上部にある [テスト広告をリクエスト] ボタンをタップして、広告インスペクタの広告テストをトリガーします。テスト結果は、SDK リクエストログの [Requested from ad Inspector] ヘッダーの下に表示されます。
アプリで広告インスペクタを使用する方法1 つの広告ソースのテスト
広告インスペクタには、単一またはウォーターフォールのメディエーション広告ソースからの広告のみを配信するよう、アプリ内の広告リクエストを制限する機能があります。 Open Bidding これにより、サードパーティ アダプタが正しく実装されていることと、広告ソースが想定どおりに配信されていることを確認できます。
この機能を有効にするには、画面下部にある [単一の広告ソースのテスト] スイッチを切り替えます。次のような広告ソース選択ダイアログが表示されます。
単独の広告ソースをテストするには、Google Mobile Ads SDK を初期化する必要があります。
その後、テストする広告ソースを 1 つ選択できます。広告ソースを選択すると、次の画面が表示されます。
単独の広告ソースのテスト設定は、同じセッションで今後作成する広告リクエストに適用されます。ただし、そのセッションで以前にキャッシュに保存された、まだ表示されていない広告には適用されません。単独の広告ソースのテストを適用する場合は、選択した広告ソースの代わりに配信される可能性のあるキャッシュされた広告を無効にするため、アプリを強制的に再起動することをおすすめします。
アプリを再起動すると、すべての広告ユニットのプレースメントで、選択したネットワークの広告のみが表示されるようになります。単一の広告ソースのテストが有効になっているときに広告インスペクタを起動すると、有効なテスト広告ソースが表示されます。
単独の広告ソースのテストモードでは、リクエストされた広告ユニットに対して、その広告ソースが入札またはメディエーションに設定されているかどうかに関係なく、すべての広告リクエストに対して、選択した広告ソースによる広告掲載が試行されます。テストしている広告ソースが広告ユニットのメディエーション ウォーターフォールに含まれていない場合は、「広告掲載なし」というエラー メッセージが表示されます。
単独の広告ソースのテストでは、広告ユニットをタップすると SDK リクエストログを表示できます。 これにより、単独の広告ソースのテストを有効にした後に行われた広告リクエストに、その広告ソースが配信したかどうかを確認できます。広告ソースが広告の読み込みに失敗した場合は、エラーを説明するエラー メッセージが表示されます。
選択した広告ソースの複数のインスタンスをメディエーション ウォーターフォールに追加した場合、広告が配信されるか、ウォーターフォールが広告掲載なしで終了するまで、広告ソースの呼び出しの各インスタンスがウォーターフォールに表示されます。
1 つの広告ソースのテストを停止する
テストを停止するには、スイッチをオフに切り替えます。
次の再起動画面に確認メッセージが表示されます。
テストを停止した後は、アプリを強制的に再起動して、テストした広告ソースのキャッシュされた広告を無効にすることをおすすめします。
デバッグ出力全体をコピーする
広告インスペクタでは、Ad Manager アプリの詳細、アダプタの初期化ステータス、すべての広告ユニットのテスト結果など、ツールからのデバッグ出力全体を含む JSON 文字列をコピーできます。
それには、[Copied ad Inspector JSON to クリップボード] というメッセージが表示されるまでアプリアイコンを 7 回タップします。