测试广告单元

选择平台： Android（Beta 版） Android iOS Unity Flutter

广告检查器支持以下两种测试：

• 上下文内测试：从应用中的广告单元加载广告。您 可以打开广告检查器，查看从广告单元发出的请求的详细信息。
• 上下文外测试：直接在广告检查器中测试广告单元 而无需前往应用界面。您可以同时测试多个广告单元、异步加载和查看测试广告请求，以及执行单一广告来源测试。

运行上下文外测试时，您的请求不会包含那些在应用界面中运行所需的参数，这包括面向儿童的内容配置、自定义定位、广告联盟额外信息和不同的尺寸。由于这些请求存在限制，我们建议您在应用界面中使用上下文内测试。

前提条件

在继续之前，请执行以下操作：

• 完成初始 前提条件中的所有项目，以创建 Ad Manager 经理账号、设置测试设备、初始化 Google Mobile Ads SDK， 并安装最新版本。
• 启动广告检查器。

请求测试广告

如需在广告检查器中请求测试广告，请完成以下步骤。如需了解详情，请参阅广告检查器（Beta 版）。

• 上下文内：

  1. 在测试设备上，前往应用界面并加载广告。
  2. 打开广告检查器。在 Ad unit （广告单元）标签页中，找到您加载广告的广告单元。
  3. 在 SDK request log（SDK 请求日志）中，查看您所请求测试广告的详细信息。

• Out-of-context:

  1. 在 Ad unit （广告单元）标签页中，点按您的广告单元，然后点击 Request test ad （请求测试广告）。
  2. 在 SDK request log（SDK 请求日志）中，查看您所请求测试广告的详细信息。

注意： 如需请求测试广告， 请使用 Google Mobile Ads SDK 上下文初始化 Activity。

如果广告单元格式显示为 Unknown（未知），您会看到 Request test ad（请求测试广告）显示为灰色 。如果您为单个广告单元请求多种格式，广告检查器会使用最后一个广告单元。

自定义测试广告

借助广告检查器，您可以通过 Configure custom ad request （配置自定义广告请求）页面构建自定义测试广告。此页面包含用于定义和请求自定义测试广告的参数。如需使用默认设置请求测试广告，请按照 请求测试广告中的步骤操作。

如需构建自定义测试广告，请执行以下操作：

1. 在 Ad unit （广告单元）标签页中，点按您要构建自定义测试广告的广告单元。

2. 点击 edit修改：

   

   系统会显示 Configure custom ad request （配置自定义广告请求）页面。以下示例展示了横幅广告的 Configure custom ad request （配置自定义广告请求）页面：

   

3. 在以下字段中输入广告请求和详细信息：

   • Ad Request（广告请求）：
     • Content 网址（内容网址）：周围内容的网址。如需了解详情，请参阅 内容网址。
     • 相邻内容网址：广告 前后显示的内容的网址。如需了解详情，请参阅 应用内容映射。
     • 类别排除：屏蔽来自特定广告客户、品牌、 或类别的广告。 如需了解详情，请参阅 类别排除。
     • 发布商提供的 ID：在频次上限和 基于受众群体的广告投放控制中设置标识符。如需了解详情，请参阅 发布商提供的 标识符。
   • 根据广告格式，输入以下广告详细信息：
     • Banner Ads（横幅广告）：输入广告的宽度和高度。如需了解详情，请参阅 横幅广告。
     • Native Ads（原生广告）：
       • Media Aspect Ratio（媒体宽高比）：选择您偏好的媒体宽高比。 如需了解详情，请参阅展示全屏原生广告。
       • Disable Image Loading（停用图片加载）：定义 Google Mobile Ads SDK 是否必须加载图片素材资源内容。如需了解详情，请参阅 图片下载控制。
       • Custom Mute This Ad（自定义版“不再显示该广告”）：定义是否使用自定义版“不再显示该广告”功能。如需了解详情，请参阅 setRequestCustomMuteThisAd。
       • Preferred Ad Choices Position（偏好的“广告选择”位置）：指明“广告选择”图标的偏好位置。如需了解详情，请参阅 “广告选项”展示位置。

   • Video Options（视频选项）：

     • 开始时静音：用于在开始时将内容静音的切换开关。 如需了解详情， 请参阅开始时静音行为。
     • Click to Expand Requested（请求点击展开）：定义所请求的视频 是否必须具有点击展开行为。 如需了解详情，请参阅 setClickToExpandRequested。
     注意： 如果广告服务器未返回视频广告，则不会应用视频选项。

4. 点击 Request custom test ad （请求自定义测试广告）。如果成功，您会在 SDK request log （SDK 请求日志）中看到自定义测试广告。

注意： 对于每个广告单元，广告检查器都会保存您最新定制广告请求的自定义测试广告设置。

测试单一广告来源

广告检查器可以限制应用中的广告请求，只投放来自单个出价广告来源或瀑布流广告来源的广告。通过这种方法，您可以验证是否已正确集成第三方适配器，以及该广告来源能否按预期投放广告。

如需测试单一广告来源，请完成以下步骤：

1. 在 Ad inspector（广告检查器）中，点击 Single ad source test（单一广告来源测试）切换开关。系统会显示 Single ad source test （单一广告来源测试）对话框：

   

2. 选择要测试的广告来源。之后，您会看到 Force restart app （强制重启应用）页面：

   

单一广告来源测试的设置适用于今后发出的所有广告请求。 此测试不适用于该会话中之前已缓存的广告。 我们建议您在采用单一广告来源测试时强制重启应用。这样可以使已缓存的广告失效，防止它们代替您所选的广告来源响应广告请求。

重启应用后，所有广告单元展示位置都会尝试展示来自所选广告来源的广告。在执行单一广告来源测试时，启动广告检查器即会显示当前测试的广告来源：

在单一广告来源测试模式下，所有广告请求都会尝试从所选广告来源填充广告，无论该广告来源配置为出价模式还是广告瀑布流模式。如果您要测试的广告来源未针对广告单元设置为出价模式或广告瀑布流模式，您会收到以下出错提示：

Ad Unit has no applicable adapter for single ad source testing on network: AD_SOURCE_ADAPTER_CLASS_NAME

如需验证广告来源是否在您开始单一广告来源测试后填充了广告请求，请点按某个广告单元以查看 SDK 请求日志。如果广告来源未能加载广告，系统会显示一条错误消息，说明错误原因，例如 Adapter failed to initialize。

如果您已将所选广告来源的多个实例添加到广告瀑布流中，您会看到对该广告来源的每个调用实例。此过程会持续进行，直到广告填充成功，或者广告瀑布流结束而无任何广告填充为止。

停止单一广告来源测试

如需停止测试，请完成以下步骤：

1. 在 Ad inspector（广告检查器）中，将 Single ad source test（单一广告来源测试） 切换为关闭状态。系统会显示 Stop single ad source test? （要停止单一广告来源测试吗？）对话框。

2. 点按 Stop test （停止测试）。

   

   如果成功，Force restart app（强制重启应用）上方会显示确认消息：

   

为了撤消所测试广告来源的缓存广告，我们建议您在停止测试后强制重启应用。