使用广告检查器,您可以:
- 检查您的广告单元
- 检查广告是否按预期填充
- 发现错误并查看有关如何修正错误的详细信息
- 查看每个请求中各个公开出价广告联盟的详细信息
- 查看每个请求中各个广告联盟的中介详情
- 测试单个第三方公开出价广告来源或广告瀑布流中介广告来源
- 确认您已针对公开出价功能正确配置了每个广告单元, 广告瀑布流中介
本指南将演示如何发布广告并使用各种不同功能 检查器。
前提条件
若要使用广告检查器,您需要:
- 完成入门指南。
- 使用 Google 移动广告 SDK 20.2.0 或更高版本。
- 启用测试 模式或链接 发送到 Ad Manager 广告检查器只能在测试设备或关联设备上启动。
启动广告检查器
您可以通过以下方式从应用中的任意位置启动广告检查器:
- 使用调试菜单中的“启动”按钮。
- 使用您在广告检查器设置中选择的手势。
- 使用提供的 API 以编程方式创建。
使用调试菜单启动
无需对应用进行任何更改,即可通过调试启动广告检查器 菜单;只需找到您的 Ad Manager 广告资源网投放的广告,轻触并按住 双指打开广告 调试菜单。然后,选择打开广告检查器。
如果您没有将 设备,系统可能会要求您 登录您的 Ad Manager 账号
您也可从调试设置中选择广告检查器设置,然后 选择日后无需前往即可打开广告检查器的手势 调试。
以编程方式启动
广告检查器也可以通过编程方式启动:
Java
MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
public void onAdInspectorClosed(@Nullable AdInspectorError error) {
// Error will be non-null if ad inspector closed due to an error.
}
});
Kotlin
MobileAds.openAdInspector(context) { error ->
// Error will be non-null if ad inspector closed due to an error.
}
此 API 适用于测试设备 已注册 以编程方式
查看广告单元并排查问题
启动后,系统会显示广告检查器主屏幕,其中包含所有广告的列表 单位 自此期间启用广告检查器以来,设备发出了广告请求 应用会话。该列表还包含已启用公开出价功能且按顺序排列的广告单元 按时间先后顺序显示最近完成的请求 没有已完成的广告请求(呈灰显状态):
我们建议您初始化 Google 移动广告 SDK 然后再使用广告检查器
查看广告单元的中介广告瀑布流详细信息
点按广告单元可查看其 SDK 请求日志,其中提供了有关 直到广告填充结束(或广告瀑布流)为止的中介广告瀑布流 (例如,在未填充广告的情况下结束投放)。
可以使用披露指示器展开每个请求以显示结果 以及所有错误和延迟时间 您请求的数据
对于第三方广告来源,错误消息会直接从 广告来源。如需了解详情,请咨询您的第三方广告来源。
查看广告单元的出价详情
如果您刚开始接触公开出价,请阅读公开出价简介 出价。
在 SDK 请求日志中,您可以查看 Open Bidding 广告来源 所调用的代码点按 SDK 请求日志中的广告单元即可查看 竞价中每个广告来源的 Open Bidding 详细信息。
对 Open Bidding 结果进行排序,以便 更靠近列表顶部的可操作项:
顶部是赢得竞价的广告联盟。
接下来是有问题的广告联盟。您可以遵循 问题的问题排查步骤 。 Open Bidding
然后是未返回广告或未出价的广告联盟。这个 这可能表明广告来源存在许多不同的问题 因为其设置或决策的原因可能没有出价。您可以参阅这则广告 来源的设置指南或 如需了解详情,请参阅公开出价常见问题解答 联系。
最后,列表底部是 Open Bidding 竞价。
中介广告瀑布流可以将胜出的广告来源 Open Bidding 竞价。
中介广告瀑布流是多个收益组竞争 相同的广告资源您最多可向单个发布商添加 10 个第三方收益合作伙伴 收益组,包括公开出价收益合作伙伴和移动中介 应用收益合作伙伴
高级广告单元调试
对广告单元进行问题排查时,深入了解广告请求会很有帮助 和响应,以确定出现故障的地方,或与 Google 分享 有助于调试的支持。点按瀑布顶部的菜单图标 链接,然后选择共享广告请求和响应,以导出完整的广告请求 和响应。这样您就无需在 自己的应用。
此外,您还可以查看已解码的第三方出价参数,只需点按 请求所在菜单中的第三方出价参数选项 字符串。这可提供有关哪些第三方出价参数 帮助您调试应用或验证网络是否 成功收集其信号
查看可用的适配器
点击适配器标签页,查看所有关联的第三方适配器的列表。 与您应用中出价或中介配置中的广告来源相关联。 然后,展开卡片以查看其初始化状态和 SDK 版本。 除了受支持的第三方适配器之外,您还可以查看自定义事件 适配器。 利用自定义事件 发布商使用的广告网络 Ad Manager 不支持。自定义事件有别于标准第三方 按其唯一类名称显示适配器列表。除了 提供类名称和状态信息,广告检查器还会显示 分配给这些自定义事件的标签 Ad Manager 网页界面。
如果未找到适配器或初始化失败,请参阅 检查移动应用广告投放 。
测试广告单元
如果您想测试自己的广告单元,而不用进入 应用的界面中,广告检查器可直接从广告单元详情屏幕中支持此操作。 此外,您还可以一次测试多个广告单元,异步加载 和查看您的测试广告请求,甚至执行单一广告来源测试。
广告测试
本部分介绍的广告检查器广告测试是 验证您的基本广告体验和验证您的中介 配置。
准备好测试广告单元后,请点按请求测试广告按钮(位于 广告检查器屏幕的顶部,触发广告检查器的广告测试。测试 之后,在 SDK 请求日志中 Requested 从广告检查器中检索出来。
了解如何在 应用单一广告来源测试
广告检查器具有一项功能,可让您限制应用中的广告请求仅投放 单个广告或瀑布流中介广告 Open Bidding 来源。这样,您就可以验证是否已正确实现了 并且广告来源按预期投放。
要启用此功能,请切换至单个广告来源测试开关, 屏幕底部。系统会显示以下广告来源选择对话框:
您必须先将Google 移动广告初始化 SDK 然后才能使用单一广告来源测试。
然后,您可以选择单个广告来源进行测试。选择广告来源后 系统会显示以下屏幕:
单一广告来源测试设置适用于今后通过 同一个会话但是,它不会应用于该域内以前缓存过的广告。 尚未显示的会话建议强制重启应用 来使任何缓存广告失效 而不是您选择的广告来源来接收请求。
重新启动应用后,所有广告单元展示位置都会尝试展示来自 。在检测到单个广告来源测试时启动广告检查器 有效测试广告来源:
在单一广告来源测试模式下,所有广告请求都会尝试使用所选 无论相应广告来源是针对出价还是 针对所请求广告单元的中介。如果您要测试的广告来源不在该范围内 广告单元的中介广告瀑布流,您会收到“未填充”错误消息。
在单一广告来源测试中,您可以点按某个广告单元来查看其 SDK 请求日志。 通过这项数据,您可以了解广告来源是否填充了 单一广告来源测试如果广告来源未能加载广告 系统会显示一条错误消息,说明错误。
如果您已将所选广告来源的多个实例添加到某个中介 广告瀑布流,您会看到 直到广告填充完毕或广告瀑布流以无任何广告填充而结束为止。
停止单个广告来源测试
如需停止测试,请关闭开关:
然后,以下重启屏幕上会显示确认消息:
我们建议您在停止测试后强制重启应用,以便 使被测广告来源的所有缓存广告失效。
复制整个调试输出
广告检查器支持复制包含整个调试内容的 JSON 字符串 输出包括您的 Ad Manager 应用、适配器初始化状态以及 测试结果
为此,请点按应用图标七次,直到您看到“已复制广告”消息 检查器 JSON 到剪贴板。