Creative Preview と配信ツール

このガイドでは、アプリ内プレビューとアド マネージャーの配信ツールを使用して、広告配信をデバッグする方法について説明します。

アプリ内プレビューでは、モバイルアプリ内でレンダリングされた独自のクリエイティブを調べることができます。アプリとやり取りするクリエイティブや、独自の動作があるクリエイティブ、レンダリングにアプリに依存しているクリエイティブ（ネイティブ クリエイティブや MRAID を含む）がある場合は、このプレビューが特に便利です。

配信された広告に関する情報は、アド マネージャーの配信ツールで確認できます。予期しない広告が配信された場合は、配信ツールを使用して原因を調べることができます。

前提条件

  • Google Mobile Ads SDK のバージョン 10.2.0 以降。
  • Google アド マネージャー アカウントへのアクセス権。
  • スタートガイドの手順を踏みます。

アプリの準備を整える

デバッグには、SDK のデバッグ オプション メニューで操作する必要があります。メニューを開くには、以下の関数をアプリに追加し、ユーザーの操作に応じてトリガーすることをおすすめします。

Java

public class MainActivity extends AppCompatActivity {

  ...

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this);
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  public void openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID");
  }
}

Kotlin

class MainActivity : AppCompatActivity() {

  ...

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this)
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  fun openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
  }
}

デバッグ オプション メニューを開くには、アド マネージャー アカウントで有効な広告ユニットがあれば十分です。

メニューを開くには、クリエイティブを 2 本指で長押ししますが、ネイティブ広告など、すべての広告フォーマットで機能するわけではありません。また、スワイプするときに広告をクリックしないよう注意する必要があります。上記のメソッドを呼び出す方が堅牢です。

デバッグ オプション メニューを開く機能を追加したら、アプリを実行して上記の関数をトリガーします。次のメニューが開きます。

[クリエイティブのプレビュー] を選択してデバイスをリンクします。ブラウザが開き、アド マネージャーにログインするためのブラウザが自動的に開きます。ログインしたら、デバイスに名前を付けて、アド マネージャー アカウントに登録します。その後、[確認] をクリックします。

この時点で、アド マネージャー UI でデバイスがリンクされていることを確認できます。他のユーザーがデバイスにアクセスできるように設定することもできます。

アプリ内プレビュー

手順に沿って、リンクされたデバイスにクリエイティブをプッシュします。プッシュされたクリエイティブが、そのクリエイティブが必要な広告スロットにターゲティングされている有効な広告申込情報の一部であることを確認します。

UI からクリエイティブをプッシュしたら、デバイスでもう一度デバッグ オプション メニューを表示し、[クリエイティブのプレビュー] を選択します。この手順により、SDK はアド マネージャーをチェックし、デバイスのリンクが正常に完了したことを検証し、プッシュしたクリエイティブに関する情報を取得します。以前にデバイスのリンクが成功していた場合、デバッグ メニューはすぐに閉じます。失敗した場合は、アカウントを再度リンクするよう求められます。

最後に、プレビューするスロットに広告を読み込み、クリエイティブを表示します。

デリバリー ツール

アド マネージャーで配信を検査するの手順に沿って、広告配信のトラブルシューティングを行います。上記の手順が正常に完了すると、アド マネージャーの UI にリクエストが表示され、配信された広告に関する詳細情報を確認できます。