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.
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.
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.