Format iklan native kustom jenis Display dan Pengukuran Terbuka

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

Prasyarat

Sebelum melanjutkan, lakukan hal berikut:

• Baca Pengukuran Terbuka dengan Mobile Ads SDK.
• Integrasikan format iklan native kustom.
• Konfigurasi penyedia data 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 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 display Anda disertifikasi oleh IAB, Anda harus disertifikasi 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 tampilan 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 tampilan. Menampilkan iklan Anda dibahas dalam Format Iklan Native Kustom.

Tata letak nativeAdViewContainer 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 sessionFinish IAB diaktifkan.

Dapatkan sertifikasi dari IAB

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