本指南介绍了如何将自定义原生广告格式与开放式衡量集成。
前提条件
- 使用 Google 移动广告 SDK 18.1.1 版或更高版本。
- 请参阅使用移动广告 SDK 进行 Open Measurement。
- 集成自定义原生广告格式。
- 配置可见度提供商并将其分配给订单项。
- 在 Ad Manager 界面中创建自定义格式时，输入您的合作伙伴名称。
集成
如果您计划对不包含视频素材资源的自定义原生广告格式使用开放式衡量，则需要自行调用 Open Measurement API。只有移动广告 SDK 18.1.1 及更高版本支持对“展示”类型的自定义原生广告格式进行开放式衡量。
如果您对视频素材资源使用自定义原生广告格式，则无需遵循本指南；移动广告 SDK 会代表您跟踪视频素材资源的可见度。
现在，我们来看看如何将开放式衡量与 NativeCustomTemplateAd 搭配使用。一般来说，如果您要开始衡量可见度并注册自定义广告视图，则需要提醒移动广告 SDK。
加载广告
无论您是否使用开放式衡量，加载广告的流程都是一样的。以下方法演示了如何请求 NativeCustomTemplateAd：
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomTemplateAd("YOUR-TEMPLATE-ID",
new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
@Override
public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomTemplateAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomTemplateAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
注册视图并开始测量
若要针对 NativeCustomTemplateAd 启用开放式衡量，请使用与 NativeCustomTemplateAd 关联的 DisplayOpenMeasurement 对象注册自定义广告视图。DisplayOpenMeasurement 对象提供了 setView() 方法，用于向 Open Measurement 注册您的容器视图。
您还需要明确指示 SDK 开始衡量您的广告。为此，请对 NativeCustomTemplateAd 的 DisplayOpenMeasurement 对象调用 start() 方法。必须从主线程调用 start() 方法，后续调用将不起作用。
外观如下：
public void registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {
...
// Show ad
...
displayCustomTemplateAd(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 布局是 NativeCustomTemplateAd 的广告容器，必须包含视图的边界框内的所有素材资源。
通过 IAB 认证
发布应用后，您将开始接收衡量数据；不过，您的数据只有在完成 IAB 认证流程之后才能获得认证。