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

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

必要條件

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

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

整合

如果您打算搭配不含影片素材資源的自訂原生廣告格式使用 Open Measurement，請自行呼叫 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()
  }
}
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 認證程序，資料才會獲得認證。