広告インスペクタには次のような機能があります。
- 広告ユニットの詳細を確認する
- 広告が想定どおりに配信されているかどうかを確認する
- エラーを特定し、解決方法の詳細を表示
- 各 Open Bidding 広告ネットワークの詳細をリクエストごとに確認できます
- 各広告ネットワークのメディエーションの詳細をリクエストごとに確認できます
- 第三者の Open Bidding またはウォーターフォール メディエーションの広告ソースを個別にテストする
- 各広告ユニットで Open Bidding とウォーターフォール メディエーションが正しく設定されていることを確認する
このガイドでは、広告インスペクタを起動して各種の機能を使用する方法について説明します。
前提条件
広告インスペクタを使用するには、次の要件を満たしている必要があります。
- スタートガイドを完了している。
- Google Mobile Ads SDK バージョン 8.10.0 以降を使用している。
- テストモードを有効にするか、デバイスをアド マネージャーにリンクします。広告インスペクタは、テストデバイスまたはリンクされたデバイスでのみ起動します。
広告インスペクタを起動
広告インスペクタは、アプリのどこからでも、以下の方法で起動できます。
- デバッグ メニューの起動ボタンを使用
- 広告インスペクタの設定で選択したジェスチャーを使用します。
- 提供された API をプログラムで使用します。
デバッグ メニューを使用して起動する
デバッグ メニューから広告インスペクタを起動するために、アプリに変更を加える必要はありません。アド マネージャー ネットワークで配信される広告を見つけて、2 本の指で広告を長押ししてデバッグ メニューを開きます。[広告インスペクタを開く] を選択します。
デバイスをリンクしていない場合は、アド マネージャー アカウントへのログインを求められることがあります。
デバッグ設定から [広告インスペクタの設定] を選択して、デバッグ メニューを開かなくても広告インスペクタを今後開く操作を選択することもできます。
プログラムから起動
広告インスペクタはプログラマティックに起動することもできます。
Swift
GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
// Error will be non-nil if there was an issue and the inspector was not displayed.
}
Objective-C
[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
completionHandler:^(NSError *error) {
// Error will be non-nil if there was an issue and the inspector was not displayed.
}];
この API は、 プログラムで行うこともできます。
この API に渡されたビュー コントローラが、すでに画面上に完全に表示されている（viewDidAppear: が呼び出された）ことを確認します。ビュー コントローラの viewDidLoad 関数で API が呼び出されたときなど、ビュー コントローラが表示プロセス中に渡された場合は、広告インスペクタの表示が失敗します。
広告ユニットの表示とトラブルシューティング
広告インスペクタを起動すると、メインの広告インスペクタ画面が表示され、入札またはメディエーションが設定されている AdMob アプリ ID に関連付けられている、AdMob 管理画面のすべての広告ユニットのリストが表示されます。 このアプリ セッションで広告インスペクタを有効にしてから、デバイスで広告リクエストが行われた。このリストには、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
メディエーションの順次処理では、オークションを落札した広告ソースをOpen Bidding eCPM 値に応じて配置します。
メディエーション ウォーターフォールは、複数の収益グループが同じ広告枠で競合した結果です。1 つの収益グループには、Open Bidding の収益パートナーとモバイルアプリ向けのメディエーションの収益パートナーの両方を含む、最大 10 件の第三者の収益パートナーを追加できます。
広告ユニットの詳細なデバッグ
広告ユニットのトラブルシューティングを行う場合は、広告リクエストとレスポンスを詳しく調べて、エラーが発生している箇所を突き止めたり、デバッグに役立つ情報を Google サポートと共有したりすると便利です。広告リクエストとレスポンス全体をエクスポートするには、ウォーターフォール チェーンの一番上のメニュー アイコンをタップして [広告リクエストとレスポンスを共有] を選択します。これにより、独自のアプリでネットワーク トレースを実行する手間が省けます。
また、リクエスト文字列と同じメニューで [第三者の入札パラメータ] オプションをタップすると、デコードされた第三者の入札パラメータを確認できます。これにより、問題のあるサードパーティの入札パラメータの詳細を確認し、アプリのデバッグやネットワークによるシグナル収集が適切に行われているかどうか検証できます。
利用可能なアダプタを表示する
[アダプタ] タブをクリックすると、アプリの入札設定またはメディエーション設定で広告ソースに関連付けられている第三者アダプタの一覧が表示されます。カードを展開して初期化ステータスと SDK バージョンを確認します。 サポートされているサードパーティのアダプタに加えて、カスタム イベント アダプタを表示することもできます。カスタム イベントを使用すると、パブリッシャーは、サポートされていない広告ネットワークを使用できます。 Ad Managerカスタム イベントは、アダプタリスト内の標準のサードパーティ アダプタと一意のクラス名で区別できます。広告インスペクタでは、クラス名とステータス情報だけでなく、それらのカスタム イベントに割り当てられたラベルもAd Manager 管理画面に表示されます。
アダプターが見つからない場合、または初期化に失敗した場合は、 モバイルアプリの広告配信の詳細を確認する で詳細をご確認ください。
広告ユニットをテストする
アプリの管理画面で移動せずに広告ユニットをテストする場合は、広告インスペクタで広告ユニットの詳細画面から直接行うことができます。また、複数の広告ユニットを一度にテストしたり、テスト用の広告リクエストを非同期で読み込んで表示したりできるほか、広告ソースを 1 つだけテストすることもできます。
広告のテスト
このセクションで説明する広告インスペクタの広告テストは、ベース広告エクスペリエンスを検証するため、および単独の広告ソースのテストで使用するメディエーション設定を検証するための優れたツールです。
広告ユニットをテストする準備ができたら、広告インスペクタ画面の上部にある [テスト広告をリクエスト] ボタンをタップして、広告インスペクタの広告テストを開始します。テスト結果は、SDK リクエストログの [Requested from ad Inspector] ヘッダーの下に表示されます。
単一の広告ソースのテスト
広告インスペクタには、アプリ内の広告リクエストを、単一のまたはウォーターフォール メディエーションの広告ソースからの広告のみを配信するよう制限する機能があります。 Open Bidding これにより、サードパーティのアダプタが正しく実装されていることと、広告ソースが想定どおりに配信されていることを確認できます。
この機能を有効にするには、画面下部の [単独の広告ソースのテスト] スイッチを切り替えます。これにより、次の広告ソース選択ダイアログが表示されます。
単独の広告ソースのテストを使用するには、Google Mobile Ads SDK を初期化する必要があります。
ここで、テストする広告ソースを 1 つ選択できます。広告ソースを選択すると、次の画面が表示されます。
単独の広告ソースのテスト設定は、今後同じセッションで行われる広告リクエストに適用されます。ただし、そのセッションで以前にキャッシュに保存され、まだ表示されていない広告には適用されません。単一の広告ソースのテストを適用する際にアプリを強制的に再起動することをおすすめします。これにより、選択した広告ソースの代わりに配信可能なキャッシュされた広告が無効になります。
アプリを再起動すると、すべての広告ユニットのプレースメントには、選択したネットワークの広告のみが表示されるようになります。単独の広告ソースのテストがアクティブな状態で広告インスペクタを起動すると、有効なテスト広告ソースが表示されます。
単独の広告ソースのテストモードでは、リクエストされた広告ユニットの入札またはメディエーションの設定にかかわらず、すべての広告リクエストで選択した広告ソースの広告が配信されます。テスト対象の広告ソースが広告ユニットのメディエーション ウォーターフォールに含まれていない場合は、「広告掲載なし」というエラー メッセージが表示されます。
単独の広告ソースのテストでは、広告ユニットをタップして SDK リクエストログを表示できます。 これにより、単独の広告ソースのテストを有効にした後に発生した広告リクエストに対して、その広告ソースが広告を配信したかどうかを確認できます。広告ソースが広告の読み込みに失敗した場合は、エラーを説明するエラー メッセージが表示されます。
メディエーション ウォーターフォールに、選択した広告ソースの複数のインスタンスを追加した場合、広告が満たされるか、または広告が配信されずにウォーターフォールが終了するまで、ウォーターフォール内の広告ソースへの呼び出しの各インスタンスが表示されます。
単独の広告ソースのテストを停止する
テストを停止するには、スイッチをオフにします。
次の再起動画面に確認メッセージが表示されます。
テストを停止した後、アプリを強制的に再起動して、テストされた広告ソースのキャッシュされた広告を無効にすることをおすすめします。
デバッグ出力全体をコピーする
広告インスペクタでは、ツールからのデバッグ出力全体（アプリの詳細、アダプタの初期化ステータス、すべての広告ユニットのテスト結果など）を含む JSON 文字列のコピーがサポートされています。Ad Manager
これを行うには、「Copied ad Inspector JSON to clipboard」というメッセージが表示されるまで、アプリアイコンを 7 回タップします。