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

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

必要條件

繼續操作前，請先執行下列工作：

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

整合

如果您打算搭配使用開放式評估和不含影片素材資源的自訂原生廣告格式，請自行呼叫 Open Measurement API。

如果您使用含有影片素材資源的自訂原生廣告格式，則不必按照本指南操作，Mobile Ads SDK 會代您追蹤影片素材資源的可視度。

重點： 如要讓多媒體廣告類型的原生自訂廣告評估結果通過 IAB 認證，您必須先向 IAB Tech Lab 取得評估服務供應商認證。

註冊檢視畫面並開始評估

如要在自訂原生廣告上啟用開放式評估，請先顯示廣告，然後使用與自訂原生廣告相關聯的 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()
  }
}

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();
  }
}

請注意，您應先顯示廣告，再註冊觀看次數。如要瞭解如何顯示廣告，請參閱自訂原生廣告格式。

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

重要事項： 完成自訂原生廣告後，請務必呼叫 destroy()，例如在取消參照物件或終止活動後。確保 IAB sessionFinish 事件已觸發。

透過 IAB 認證

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