展示类型的自定义原生广告格式和开放式衡量

本指南介绍了如何将自定义原生广告格式与开放式衡量集成。

前提条件

在继续之前，请先完成以下事项：

• 请参阅利用移动广告 SDK 进行开放式衡量。
• 集成自定义原生广告格式。
• 配置可见度提供商并将其分配给订单项。
• 在 Ad Manager 界面中创建自定义格式时，输入合作伙伴名称。

集成

如果您计划将开放式衡量与不包含视频素材资源的自定义原生广告格式搭配使用，则需要自行调用开放式衡量 API。

如果您使用的是包含视频素材资源的自定义原生广告格式，则无需遵循本指南；移动广告 SDK 会代表您跟踪视频素材资源的可见性。

要点： 如需让 IAB 认证您的展示型原生自定义广告效果衡量结果，您必须获得 IAB Tech Lab 的“效果衡量服务提供商”认证。

注册观看并开始衡量

如需在自定义原生广告上启用开放式衡量，请先展示广告，然后向与自定义原生广告关联的 DisplayOpenMeasurement 对象注册自定义广告视图。DisplayOpenMeasurement 对象提供 setView() 方法，用于向 Open Measurement 注册容器视图。

您还需要明确告知 SDK 开始衡量广告。为此，请对自定义原生广告的 DisplayOpenMeasurement 对象调用 start() 方法。必须从主线程调用 start() 方法，后续调用无效。

外观如下：

Kotlin

@MainThread
private fun displayCustomNativeAd(
  customNativeAd: CustomNativeAd,
  nativeAdViewContainer: FrameLayout,
) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  val displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement()
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer)
    displayOpenMeasurement.start()
  }
}

Java

@MainThread
private void displayCustomNativeAd(
    CustomNativeAd customNativeAd, FrameLayout nativeAdViewContainer) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  DisplayOpenMeasurement displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer);
    displayOpenMeasurement.start();
  }
}

请注意，您应先展示广告，然后再注册视图。有关展示广告的说明，请参阅自定义原生广告格式。

nativeAdViewContainer布局是自定义原生广告的广告容器，必须包含视图边界框内的所有素材资源。

重要提示： 在您完成自定义原生广告的使用后（例如，在取消对对象的引用或销毁 activity 后），请务必对该广告调用 destroy()。这样可确保触发 IAB sessionFinish 事件。

通过 IAB 认证

发布应用后，您将开始接收衡量数据；不过，在您完成 IAB 认证流程之前，您的数据不会获得认证。