Format iklan native kustom jenis Display dan Pengukuran Terbuka

Panduan ini menjelaskan cara mengintegrasikan format iklan native kustom dengan pengukuran terbuka.

Prasyarat

Sebelum Anda melanjutkan, lakukan hal berikut:

• Baca Open Measurement dengan Mobile Ads SDK.
• Mengintegrasikan format iklan native kustom.
• Konfigurasi penyedia visibilitas dan tetapkan ke item baris Anda.
• Masukkan nama partner Anda saat membuat format kustom di UI Ad Manager.

Integrasi

Jika Anda berencana menggunakan pengukuran terbuka dengan format iklan native kustom yang tidak berisi aset video, Anda akan bertanggung jawab untuk memanggil Open Measurement API sendiri.

Jika Anda menggunakan format iklan native kustom dengan aset video, Anda tidak perlu mengikuti panduan ini; Mobile Ads SDK melacak visibilitas aset video atas nama Anda.

Poin Penting: Agar hasil pengukuran iklan kustom native jenis tampilan Anda mendapatkan sertifikasi dari IAB, Anda harus mendapatkan sertifikasi sebagai Penyedia Pengukuran dengan IAB Tech Lab.

Daftarkan tampilan Anda dan mulai mengukur

Untuk mengaktifkan pengukuran terbuka pada iklan native kustom, tampilkan iklan terlebih dahulu, lalu daftarkan penayangan iklan kustom Anda dengan objek DisplayOpenMeasurement yang terkait dengan iklan native kustom. Objek DisplayOpenMeasurement menyediakan metode setView() untuk mendaftarkan tampilan penampung Anda dengan pengukuran terbuka.

Anda juga harus secara eksplisit memberi tahu SDK untuk mulai mengukur iklan Anda. Untuk melakukannya, panggil metode start() pada objek DisplayOpenMeasurement iklan native kustom Anda. Metode start() harus dipanggil dari thread utama, dan panggilan berikutnya tidak akan berpengaruh.

Berikut ini tampilannya:

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

Perhatikan bahwa Anda harus menampilkan iklan sebelum mendaftarkan penayangan. Menampilkan iklan Anda dibahas dalam Format Iklan Native Kustom.

nativeAdViewContainer Tata letak adalah penampung iklan untuk iklan native kustom dan harus berisi semua aset dalam kotak pembatas tampilan.

Penting: Pastikan Anda memanggil destroy() pada iklan native kustom saat Anda selesai menggunakan iklan, misalnya, setelah membatalkan referensi objek atau menghancurkan aktivitas. Hal ini memastikan bahwa peristiwa IAB sessionFinish dipicu.

Mendapatkan sertifikasi dari IAB

Setelah merilis aplikasi, Anda akan mulai menerima data pengukuran; namun, data Anda tidak akan disertifikasi hingga Anda menyelesaikan proses sertifikasi IAB.