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

本指南說明如何整合自訂原生廣告格式與 Open Measurement。

必要條件

繼續操作前，請先完成下列事項：

• 請參閱「搭配使用 Open Measurement 與 Mobile Ads SDK」。
• 整合自訂原生廣告格式。
• 設定可視度評估服務供應商，並指派給委刊項。
• 在 Ad Manager 使用者介面建立自訂格式時，請輸入合作夥伴名稱。

整合

如果您打算搭配不含影片素材資源的自訂原生廣告格式使用 Open Measurement，則必須自行呼叫 Open Measurement API。

如果您使用自訂原生廣告格式搭配影片素材資源，就不需要遵循本指南，Mobile Ads SDK 會代您追蹤影片素材資源的可視度。

重點： 多媒體廣告類型的原生自訂廣告評估結果，必須通過 IAB 認證，因此您必須先取得互動廣告協會科技實驗室的評估服務供應商認證。

註冊檢視畫面並開始評估

如要在自訂原生廣告上啟用 Open Measurement，請先顯示廣告，然後向與自訂原生廣告相關聯的 DisplayOpenMeasurement 物件註冊自訂廣告檢視區塊。DisplayOpenMeasurement 物件提供 setView() 方法，可向 Open Measurement 註冊容器檢視區塊。

您也必須明確指示 SDK 開始評估廣告。方法是在自訂原生廣告的 DisplayOpenMeasurement 物件上呼叫 start() 方法。start() 方法必須從主執行緒呼叫，後續呼叫不會生效。

它的外觀如下：

Kotlin

@MainThread
private fun displayCustomNativeAd(
  customNativeAd: CustomNativeAd,
  nativeAdViewContainer: FrameLayout,
) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  val displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement()
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer)
    displayOpenMeasurement.start()
  }
}
OpenMeasurementSnippets.kt

Java

@MainThread
private void displayCustomNativeAd(
    CustomNativeAd customNativeAd, FrameLayout nativeAdViewContainer) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  DisplayOpenMeasurement displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer);
    displayOpenMeasurement.start();
  }
}
OpenMeasurementSnippets.java

請注意，您應先顯示廣告，再註冊檢視區塊。如要瞭解如何顯示廣告，請參閱「自訂原生廣告格式」一文。

nativeAdViewContainer 版面配置是自訂原生廣告的廣告容器，且必須包含檢視畫面定界框內的所有素材資源。

重要事項： 廣告使用完畢後 (例如取消參照物件或刪除活動)，請務必對自訂原生廣告呼叫 destroy()。這可確保系統會觸發 IAB sessionFinish 事件。

取得 IAB 認證

發布應用程式後，您就會開始收到評估資料，但必須完成 IAB 認證程序，資料才會獲得認證。