広告インスペクタ

広告インスペクタ は、承認済みのデバイスにおいて、モバイルアプリ内でテスト広告リクエストを直接分析できるアプリ内オーバーレイです。 コーディングなしでご利用いただけます。

Mobile Ads Unity 7.0.0 以降の場合は、次のことが可能です。

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

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

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

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

前提条件

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

  • Mobile Ads Unity プラグイン バージョン 7.0.0 以降をインストールします。

広告インスペクタを起動

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

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

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

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

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

プログラムから起動する

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

public void OnButtonClick() {
  MobileAds.OpenAdInspector((AdInspectorError error) =>
  {
    // Error will be set if there was an issue and the inspector was not displayed.
  });
}

この API は、プログラム経由または AdMob 管理画面から登録されたテストデバイスで動作します。

広告ユニットを表示してトラブルシューティングする

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

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

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

広告ユニットをタップして、その SDK リクエストログを表示します。このログには、最新の広告リクエストで広告が配信された（または配信できなかった）時点までのメディエーション ウォーターフォールの詳細が表示されます。

Disclosure Indicator を使って各リクエストを展開すると、そのリクエストのメディエーション ウォーターフォールの結果が表示され、そのリクエストでエラーや遅延があった場合はその情報も確認できます。

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

広告ユニットの入札の詳細を表示する

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

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

入札結果の項目は、実施可能な順に表示されるように並べ替えられています。

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

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

  • 続いて、広告が返されなかった広告ネットワークや入札しなかった広告ネットワークが表示されます。こうした広告ネットワークは、その広告ソースの設定や判断材料が原因で入札単価が設定されなかった場合があり、さまざまな問題を示唆している可能性があります。詳しくは、広告ソースの設定ガイドを確認するか、広告ソースに直接お問い合わせください。

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

メディエーション ウォーターフォールでは、入札オークションで落札した広告ソースを eCPM 値に基づいて配置できます。

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

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

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

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

Android
iOS

利用可能なアダプタを確認する

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

アダプタが見つからない、または初期化できない場合は、広告インスペクタを使って発見された問題のトラブルシューティングを行うをご覧ください。

Android
iOS

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

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

広告テスト

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

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

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

単一の広告ソースをテストする

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

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

Android
iOS

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

ここで、テストする単独の広告ソースを選択できます。広告ソースを選択すると、次の画面が表示されます。

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

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

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

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

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

単独の広告ソースのテストを停止する

テストを停止するには、スイッチをオフにします。

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

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

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

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

コピーするには、アプリアイコンを 7 回タップして、[広告インスペクタの JSON がクリップボードにコピーされました] というメッセージが表示されるまで待ちます。