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

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

必要條件

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

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

整合

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

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

註冊檢視畫面並開始評估

如要在自訂原生廣告上啟用開放式評估，請先顯示廣告，然後向與自訂原生廣告相關聯的 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版面配置是自訂原生廣告的廣告容器，且必須包含檢視區塊邊界方塊內的所有素材資源。

透過 IAB 認證

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