本指南說明如何整合自訂原生廣告格式與開放式評估功能。
必要條件
- Google Mobile Ads SDK 18.1.1 以上版本。
- 參閱「使用行動廣告 SDK 進行 Open Measurement」一文。
- 整合自訂原生廣告格式。
- 設定可視度評估服務供應商，並指派給委刊項。
- 在 Ad Manager UI 中建立自訂格式時，輸入合作夥伴名稱。
整合
如果您打算在不含影片素材資源的自訂原生廣告格式中使用開放評估功能，就必須自行呼叫 Open Measurement API。多媒體廣告類型自訂原生廣告格式的開放式評估僅適用於 Mobile Ads SDK 18.1.1 以上版本。
如果您的自訂原生廣告格式含有影片素材資源，就不需要遵循本指南的說明；Mobile Ads SDK 會代替您追蹤影片素材資源的可視度。
一起來看看如何透過 NativeCustomTemplateAd 使用開放式評估。一般來說，您需要在要開始評估可視度並登錄自訂廣告檢視畫面時，向 Mobile Ads 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() 方法，可透過開放式測量來註冊容器檢視畫面。
您也需要明確指示 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 認證程序，資料才能通過認證。