广告素材预览和投放检查器

本指南介绍了如何使用应用内预览和投放检查器调试广告投放。

借助应用内预览 ，您可以在移动应用中查看自己广告素材的呈现效果。 对于广告素材与应用互动、具有独特行为或依赖应用 进行部分呈现（包括原生广告素材和 MRAID 广告素材）的发布商，此预览功能尤其有用。

借助 投放 检查器 ，您可以了解系统投放了哪些广告。如果投放的广告与预期不符，请使用投放检查器查明原因。

前提条件

  • Google Mobile Ads SDK 7.13.1 或更高版本
  • 有权访问 Google Ad Manager 账号
  • 完成入门指南的学习

准备应用

调试需要与 SDK 的调试选项菜单互动。 建议您在应用中添加以下函数，并根据用户操作触发该函数，以打开该菜单：

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = DebugOptionsViewController(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];
}

您 Ad Manager 账号中的任何有效广告单元都足以打开调试选项菜单。

在调试菜单关闭时收到通知

以编程方式打开调试选项菜单时，您可以选择实现 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.");
}

添加打开调试选项菜单的功能后，运行您的应用并触发上述函数。系统会打开以下菜单：

选择Creative Preview 以关联您的设备。系统会打开一个浏览器，并自动将您转到浏览器以登录 Ad Manager。成功登录后，为您的设备命名，以便将其注册到您的 Ad Manager 账号，然后点击验证 。

您已成功关联设备！此时，您可以在 Ad Manager 前端中看到已关联的设备。您还可以允许其他人访问您的 设备。

应用内预览

按照相关步骤将广告素材推送到关联的设备。 请确保推送的广告素材属于以您希望看到该广告素材的广告位为定位目标的有效订单项。

从前端推送广告素材后，请再次在设备上触发调试选项菜单，然后再次选择Creative Preview 。通过此步骤，SDK 可以再次检查 Ad Manager，以验证设备关联是否成功，并获取有关您推送的广告素材的一些信息。如果之前设备关联成功，调试菜单会立即关闭。如果关联失败，系统会提示您再次关联账号。

最后，为要预览的广告位加载广告，以查看您的广告素材！

投放检查器

按照开始应用问题排查 中的步骤对应用进行问题排查。如果您成功完成这些步骤， 请求将显示在 Ad Manager 前端中，并且您可以查看有关所投放广告的 更多信息。