广告检查器

广告检查器 是一种应用内叠加层,可让获得授权的设备直接在移动应用内对测试广告请求进行实时分析。它包含在 Google 移动广告 SDK 7.68.0 及更高版本中,无需编写任何代码即可启用。

在移动广告 SDK 7.68.0 至 8.5.0 版本中使用广告检查器,您可以执行以下操作:

  • 检查您的广告单元
  • 检查广告是否按预期填充
  • 发现错误并详细了解如何修正错误
  • 查看每个请求中各个广告联盟的中介详细信息
  • 测试单个第三方中介广告来源
  • 检查是否针对广告瀑布流中介正确配置了每个广告单元

对于移动广告 SDK 8.5.0 及更高版本,您还可以执行以下操作:

  • 查看每个请求中各个广告联盟的出价详细信息
  • 查看每个请求中各个广告联盟的出价和瀑布流中介详细信息
  • 测试单个第三方出价来源或广告瀑布流中介广告来源
  • 确认您已针对出价和广告瀑布流中介正确配置了每个广告单元

本指南演示了如何启动和使用广告检查器中的不同广告功能。

前提条件

要使用广告检查器,您需要:

  • 通读入门指南

  • 使用 Google 移动广告 SDK 7.68.0 或更高版本。

启动广告检查器

广告检查器可以从应用中的任何位置启动。启动广告检查器的方法有两种。

  1. 使用注册测试设备时在 AdMob 界面中选择的手势。

  2. 使用提供的 API 以编程方式启动。

  3. 使用调试菜单中的“启动”按钮。

使用手势启动

使用手势启动广告检查器,无需对应用进行任何更改。只需执行您在 AdMob 中为该测试设备配置的手势(轻弹两下或摇晃)。了解详情

在 AdMob 界面中设置手势后(等待 15 分钟使其生效),您的应用需要向 Google 移动广告 SDK 发出广告请求,以了解您的手势设置。如果指定的手势不起作用,请尝试加载广告,重启应用,然后再次测试手势。

以编程方式启动

广告检查器也可以编程方式启动:

[GADMobileAds.sharedInstance presentInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

此 API 适用于通过下列方式注册的测试设备:以编程方式或在 AdMob 界面中注册。

确保传递到此 API 的视图控制器已完全在屏幕上可见(已调用 viewDidAppear:)。如果传递的视图控制器正处于显示过程中(例如,如果在视图控制器的 viewDidLoad 函数中调用上述 API),那么将无法显示广告检查器。

按广告单元查看近期广告请求结果

启动后,系统会显示广告检查器主屏幕,列出 AdMob 界面中与您的 AdMob 应用 ID 相关联的所有具有出价或中介配置的广告单元:

广告单元按时间先后顺序排列,最近完成的请求排在最前面。如上所示,未完成任何请求的已知广告单元会变暗。

我们建议您在使用广告检查器之前先初始化 Google 移动广告 SDK

查看广告单元的bidding详情

前提条件:Google 移动广告 SDK 8.5.0 或更高版本

如果您还不熟悉出价功能,请参阅出价概览

在 SDK 请求日志中,您可以看到广告请求中调用的bidding广告来源。点按 SDK 请求日志中的某个广告单元,即可查看bidding竞价中每个广告来源的详细信息。

点按链接查看所有出价方,即可查看为相应广告单元配置的所有bidding广告联盟。bidding结果的排列顺序为,可操作项更靠近列表顶部:

  • 最上面是在竞价中胜出的广告联盟。

  • 接下来是有问题的广告联盟。您可以按照相应问题的排查步骤操作。

  • 然后是未返回任何广告或未出价的广告联盟。这可能意味着该广告来源存在问题。此类问题有很多种,因为没有出价可能是由于设置或决策原因。您可以参考广告来源的设置指南或直接与广告来源联系以寻求支持

  • 最后,列表底部是bidding竞价失败的广告联盟。

中介广告瀑布流可以根据广告来源的有效每千次展示费用 (eCPM) 值来放置bidding竞价中获胜的广告来源。

在中介广告瀑布流中调用该广告来源时,广告来源便会投放该广告。要详细了解出价如何与中介广告瀑布流协同运作,请参阅中介组中出价和广告瀑布流广告来源的示例 2 和示例 3

查看广告单元的中介广告瀑布流详细信息

点按某个广告单元可查看其 SDK 请求日志,其中详细记录了在系统响应最新广告请求将广告填充到该广告单元之前(或在广告瀑布流以无任何广告填充而结束之前)的中介广告瀑布流。

使用披露指示器可以展开每个请求,以显示该请求的中介广告瀑布流的结果,以及与该请求相关的任何错误和延迟。

对于第三方广告来源,错误消息会直接从广告来源发送。如需了解详情,请咨询您的第三方广告来源。

执行单个广告来源测试

广告检查器具有一项功能,可让您限制应用中的广告请求,以便仅投放来自单个bidding或广告瀑布流中介广告来源的广告。这样,您便可以验证是否已正确实现了第三方适配器,以及广告来源是否按预期投放。

要启用此功能,请开启屏幕底部的单一广告来源测试开关。开启后会显示以下广告来源选择对话框:

您必须先初始化 Google 移动广告 SDK,然后才能使用单一广告来源测试。

然后,您可以选择一个广告来源进行测试。选择广告来源后,系统会显示以下屏幕:

单一广告来源测试设置适用于今后在同一会话中发出的所有广告请求。但不会应用于该会话中尚未显示之前已缓存的任何广告。我们建议您在应用单一广告来源测试时强制重启您的应用,以便使可能会投放的缓存广告失效,这些广告并非来自您所选的接收广告请求的广告来源。

重启应用后,所有广告单元展示位置都将仅展示来自所选广告联盟的广告。当单一广告来源测试处于有效状态时启动广告检查器,即会显示有效的测试广告来源:

在单一广告来源测试模式下,所有广告请求都会尝试从所选广告来源填充广告,无论是否针对请求的广告单元的出价或中介配置了该广告来源。这意味着,如果您要测试的广告来源不在某广告单元的中介广告瀑布流中,您会看到一条“未填充”错误消息。

在单一广告来源测试中,您可以点按广告单元来查看其 SDK 请求日志。 这样您就可以了解,所选广告来源是否填充了在启用单一广告来源测试后发出的广告请求。如果广告来源未能加载广告,则系统会显示一条错误消息,说明相应错误。

如果您向某个中介广告瀑布流多次添加了所选广告来源,则会在广告瀑布流中看到在有广告填充之前(或在广告瀑布流以无任何广告填充而结束之前)对该广告来源的每一次调用。

单一广告来源测试不支持自定义事件。

停止单个广告来源测试

如需停止测试,请关闭开关:

以下重启屏幕上随后会显示确认消息:

我们建议在停止测试后强制重启应用,以便使接受测试的广告来源的缓存广告无效。