Format Iklan Native Kustom jenis Display dan Pengukuran Terbuka

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

Prasyarat

• Google Mobile Ads SDK versi 18.1.1 atau yang lebih tinggi.
• Baca Pengukuran Terbuka dengan Mobile Ads SDK.
• Integrasikan format iklan native kustom.
• Konfigurasikan penyedia visibilitas dan tetapkan ke item baris Anda.
• Masukkan nama partner Anda saat membuat format kustom di UI Ad Manager.

Integrasi

Jika berencana menggunakan pengukuran terbuka dengan format iklan native kustom yang tidak berisi aset video, Anda harus memanggil Open Measurement API sendiri. Pengukuran terbuka untuk format iklan native kustom jenis tampilan hanya didukung oleh Mobile Ads SDK versi 18.1.1 dan yang lebih baru.

Jika 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 kustom jenis tampilan Anda disertifikasi oleh IAB, Anda harus mendapatkan sertifikasi sebagai Penyedia Pengukuran dari IAB Tech Lab.

Sekarang, mari kita lihat cara menggunakan pengukuran terbuka dengan NativeCustomTemplateAd. Secara umum, Anda harus memberi tahu Mobile Ads SDK saat ingin memulai pengukuran visibilitas dan mendaftarkan tampilan iklan kustom.

Memuat iklan

Pemuatan iklan tetap sama terlepas dari apakah Anda menggunakan pengukuran terbuka atau tidak. Berikut adalah metode yang menunjukkan cara meminta NativeCustomTemplateAd:

public void loadAd() {
   AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
    .forCustomTemplateAd("YOUR-TEMPLATE-ID",
      new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
          @Override
          public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
              // Register your view and begin open measurement.
              // We will define this method below.
              MyActivity.this.registerOpenMeasurementAndShowAd(ad);
          }
      },
      new NativeCustomTemplateAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomTemplateAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();
}

Mendaftarkan tampilan Anda dan mulai mengukur

Untuk mengaktifkan pengukuran terbuka di NativeCustomTemplateAd, daftarkan tampilan iklan kustom Anda dengan objek DisplayOpenMeasurement yang terkait dengan NativeCustomTemplateAd. 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. Untuk melakukannya, panggil metode start() pada objek DisplayOpenMeasurement dari NativeCustomTemplateAd Anda. Metode start() harus dipanggil dari thread utama, dan panggilan berikutnya tidak akan berpengaruh.

Berikut ini tampilannya:

public void  registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {

...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();

}

Perhatikan bahwa Anda harus menampilkan iklan sebelum mendaftarkan tampilan tersebut. Menampilkan iklan tercakup dalam Format Iklan Bawaan Khusus.

Tata letak customTemplateAdFrame adalah penampung iklan untuk NativeCustomTemplateAd dan harus berisi semua aset dalam kotak pembatas tampilan.

Penting: Pastikan Anda memanggil destroy() di NativeCustomTemplateAd setelah selesai dengan iklan, misalnya, setelah menurunkan referensi objek atau menghancurkan aktivitas. Hal ini memastikan bahwa peristiwa sessionFinish IAB diaktifkan.

Dapatkan sertifikasi dengan IAB

Setelah merilis aplikasi, Anda akan mulai menerima data pengukuran. Namun, data tersebut tidak akan disertifikasi sampai Anda menyelesaikan proses sertifikasi IAB.