多媒體廣告類型自訂原生廣告格式和 Open Measurement

本指南說明如何整合自訂原生廣告格式與開放式廣告 成效評估方式

必要條件

整合

如果您打算在沒有影片素材資源的自訂原生廣告格式中使用公開評估功能,就必須自行呼叫公開評估 API。對多媒體類型自訂原生廣告的開啟評估功能 只有 Mobile Ads SDK 18.1.1 以上版本支援廣告格式。

如果您使用含有影片資產的自訂原生廣告格式,則不必按照本指南操作;Mobile Ads 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 上啟用公開評估功能,請將自訂廣告檢視畫面註冊至與 NativeCustomFormatAd 相關聯的 DisplayOpenMeasurement 物件。DisplayOpenMeasurement 物件提供 註冊容器檢視畫面的 setView() 方法。

您也必須明確告知 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 認證程序