クリエイティブ プレビューと配信インスペクタ

このガイドでは、アプリ内プレビューと配信インスペクタを使用して広告配信をデバッグする方法を説明します。

アプリ内プレビューでは、モバイルアプリ内でレンダリングされた独自のクリエイティブを確認できます。このプレビューは、アプリと連動するクリエイティブ、独自の動作をするクリエイティブ、一部のレンダリング（ネイティブ クリエイティブや MRAID を含む）をアプリに依存しているパブリッシャーに対して特に有用です。

配信された広告に関する情報は、配信インスペクタで確認できます。予期しない広告が配信された場合は、配信インスペクタを使用して原因を確認してください。

前提条件

  • Google Mobile Ads SDK のバージョン 7.13.1 以降
  • Google アド マネージャー アカウントへのアクセス権
  • スタートガイドを完了する

アプリの準備を整える

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

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

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

デバッグ メニューが閉じたときに通知を受け取る

デバッグ オプションのメニューをプログラムで開く場合、GADDebugOptionsViewControllerDelegate を実装して、ビュー コントローラが閉じられたときに通知を受け取るようにすることもできます。そのためには、クラスを委譲に適合させます。

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

@import GoogleMobileAds;
 
@interface ViewController : UIViewController <GADDebugOptionsViewControllerDelegate> {
}
 
@end

GADDebugOptionsViewController でデリゲートを設定します。

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  debugOptionsViewController.delegate = self
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  debugOptionsViewController.delegate = self;
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

最後に、デリゲートを実装します。

Swift

func debugOptionsViewControllerDidDismiss(controller: GADDebugOptionsViewController) {
  print("Debug options view controller dismissed.")
}

Objective-C 

- (void)debugOptionsViewControllerDidDismiss:(GADDebugOptionsViewController *)controller {
  NSLog(@"Debug options view controller dismissed.");
}

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

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

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

アプリ内プレビュー

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

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

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

配信インスペクタ

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