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