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

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

前提条件

集成

如果您打算将开放式衡量与 未包含视频素材资源，则需要调用 Open 自行衡量 API。针对“展示”类型的自定义原生广告的开放式衡量 格式只有移动广告 SDK 18.1.1 及更高版本支持。

如果您同时使用自定义原生广告格式和视频素材资源，则无需 遵循本指南；移动广告 SDK 会跟踪网站上 。

加载广告

无论您是否使用公开衡量，广告加载方式都是相同的。以下方法演示了如何请求 NativeCustomFormatAd：

public void loadAd() {
   AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
    .forCustomFormatAd("YOUR-TEMPLATE-ID",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
          @Override
          public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
              // Register your view and begin open measurement.
              // We will define this method below.
              MyActivity.this.registerOpenMeasurementAndShowAd(ad);
          }
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();
}

注册您的视图并开始衡量

如需在 NativeCustomFormatAd 上启用开放式衡量，请注册您的自定义 包含 DisplayOpenMeasurement 对象的广告视图，该对象与 NativeCustomFormatAd。DisplayOpenMeasurement 对象提供 setView() 方法，通过 Open Measurement 注册容器视图。

您还需要明确告知 SDK 开始衡量您的广告。操作步骤 对应用的 DisplayOpenMeasurement 对象调用 start() 方法， NativeCustomFormatAd。必须从主函数调用 start() 方法 且后续调用不会产生任何影响。

外观如下：

public void  registerOpenMeasurementAndShowAd(NativeCustomFormatAd ad) {

...
// Show ad
...
displayCustomFormatAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();

}

请注意，您应先展示广告，然后再注册视图。当前显示 您的广告将覆盖自定义原生广告 格式。

customTemplateAdFrame 布局是 NativeCustomFormatAd且必须包含 视图。

经过 IAB 认证

发布应用后，您便开始接收衡量数据；不过， 在您完成验证 IAB 认证流程。