Format Iklan Native Kustom jenis Display dan Pengukuran Terbuka

Panduan ini menjelaskan cara mengintegrasikan format iklan native khusus dengan pengukuran.

Prasyarat

• Google Mobile Ads SDK versi 18.1.1 atau yang lebih tinggi.
• Baca Pengukuran Terbuka dengan Iklan Seluler SDK.
• Mengintegrasikan iklan native kustom format file.
• Mengonfigurasi visibilitas cloud Anda dan menetapkannya ke item baris.
• Masukkan nama partner Anda saat membuat di UI Ad Manager.

Integrasi

Jika Anda berencana menggunakan pengukuran terbuka dengan format iklan native khusus yang tidak berisi aset video, Anda akan bertanggung jawab untuk memanggil Measurement API sendiri. Pengukuran terbuka untuk iklan native kustom jenis tampilan format ini 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 ikuti panduan ini; Mobile Ads SDK melacak visibilitas aset video di untuk Anda.

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

Memuat iklan

Pemuatan iklan itu sama, baik Anda menggunakan pengukuran terbuka maupun tidak. Berikut metode yang menunjukkan cara meminta NativeCustomFormatAd:

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

Mendaftarkan tampilan dan mulai mengukur

Untuk mengaktifkan pengukuran terbuka pada NativeCustomFormatAd, daftarkan pengukuran kustom tampilan iklan dengan objek DisplayOpenMeasurement yang terkait dengan NativeCustomFormatAd. Objek DisplayOpenMeasurement menyediakan setView() untuk mendaftarkan tampilan penampung dengan pengukuran terbuka.

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

Berikut ini tampilannya:

public void  registerOpenMeasurementAndShowAd(NativeCustomFormatAd ad) {

...
// Show ad
...
displayCustomFormatAd(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 Anda. Menampilkan iklan Anda tercakup dalam Iklan Native Kustom Format.

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

Penting: Pastikan Anda memanggil destroy() pada NativeCustomFormatAd saat Anda selesai dengan iklan, misalnya, setelah dereferensi objek atau mengakhiri aktivitas. Tindakan ini memastikan bahwa peristiwa sessionFinish IAB diaktifkan.

Dapatkan sertifikasi dengan IAB

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