广告素材预览和投放工具

本指南介绍了如何使用应用内预览和 Ad Manager 投放工具调试广告投放。

借助应用内预览，您可以检查在移动应用中呈现的自己的广告素材。如果您的广告素材与应用互动、具有独特行为或依赖应用来进行某些呈现（包括原生广告素材和 MRAID），此预览功能尤为有用。

通过 Ad Manager 投放工具，您可以了解系统投放了哪些广告；因此，当投放了意料之外的广告时，可以使用投放工具查明原因。

前提条件

  • Google 移动广告 SDK 10.2.0 或更高版本。
  • 拥有 Google Ad Manager 账号的访问权限。
  • 完成入门指南。

准备应用

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

Java

public class MainActivity extends AppCompatActivity {

  ...

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this);
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  public void openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID");
  }
}

Kotlin

class MainActivity : AppCompatActivity() {

  ...

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    // Initialize the Mobile Ads SDK.
    MobileAds.initialize(this)
  }

  ...

  // Opens a debug menu. Call this method based on a user action.
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  fun openDebugMenu() {
    MobileAds.openDebugMenu(this, "YOUR_AD_UNIT_ID")
  }
}

只要您的 Ad Manager 账号中有任何有效的广告单元，您就可以打开调试选项菜单。

另一种打开菜单的方法是用两指长按广告素材，但此方法不适用于所有广告格式（例如原生广告），并且您在尝试滑动时必须小心，不要点击广告。调用上述方法会更加稳健。

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

选择广告素材预览以关联您的设备。系统会打开一个浏览器，并自动将您引导至供您登录 Ad Manager 的浏览器。登录后，请为您的设备命名，以便向您的 Ad Manager 账号注册该设备。然后点击验证。

此时，您可以在 Ad Manager 界面中验证设备是否已关联。您还可以让他人使用您的设备。

应用内预览

按照相应步骤将广告素材推送到关联的设备。请确保推送的广告素材属于某个有效订单项（定位到您要投放该广告素材的广告位）。

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

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

交付工具

请按照在 Ad Manager 中检查投放情况中的步骤排查广告投放问题。如果您成功完成了上述步骤，请求会显示在 Ad Manager 界面中，您可以查看有关投放的广告的更多信息。