このページは Cloud Translation API によって翻訳されました。

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 本の指で長押しすることもできますが、ネイティブ広告など、すべての広告フォーマットで機能するわけではありません。また、スワイプする際に広告をクリックしないように注意する必要があります。上記のメソッドを呼び出す方がはるかに堅牢です。

デバイスをリンクする

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

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

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

アプリ内プレビュー

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

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

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

配信ツール

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