本指南介绍了如何将自定义原生广告格式与 Open 衡量。
前提条件
- Google 移动广告 SDK 18.1.1 或更高版本。
- 请参阅针对移动广告进行开放式衡量 SDK。
- 集成自定义原生广告 格式。
- 配置可见度 提供商 并将其分配给订单项
- 创建自定义合作伙伴时,输入您的合作伙伴名称 格式。
集成
如果您打算将开放式衡量与 未包含视频素材资源,则需要调用 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 认证流程。