Pendapatan iklan di tingkat tayangan iklan

Saat tayangan iklan terjadi, Google Mobile Ads SDK for React Native akan memberikan data pendapatan iklan yang terkait dengan tayangan iklan tersebut. Gunakan data ini untuk menghitung nilai umur (LTV) pengguna, atau teruskan data ke platform analisis atau partner atribusi pihak ketiga.

Panduan ini membahas penerapan pengambilan data pendapatan iklan di tingkat tayangan iklan di aplikasi React Native Anda.

Prasyarat

Sebelum melanjutkan, lakukan hal berikut:

Setiap format iklan mendukung callback peristiwa onAdPaid. Selama siklus proses iklan, Google Mobile Ads SDK for React Native memantau peristiwa tayangan iklan dan memanggil pengendali dengan payload AdValue yang diperoleh.

Contoh berikut mendaftarkan pemroses peristiwa berbayar di iklan reward, mencatat data pendapatan iklan yang diperoleh, dan menampilkan iklan:

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

Sebaiknya lakukan hal berikut:

  • Untuk iklan layar penuh, tetapkan pemroses pada objek iklan setelah Anda memuat iklan dan sebelum menampilkan iklan. Untuk iklan banner dan native, teruskan callback onAdPaid sebagai properti ke komponen <BannerAdView /> atau <NativeAdView />. Proses ini memastikan Anda tidak melewatkan callback peristiwa berbayar.

  • Kirim informasi pendapatan iklan di tingkat tayangan iklan ke server analisis pilihan Anda saat Google Mobile Ads SDK for React Native memanggil callback onAdPaid. Proses ini memastikan Anda tidak melewatkan callback dan menjaga data Anda tetap konsisten.

Mempelajari integrasi AAP

Untuk mengetahui detail tentang cara meneruskan data pendapatan iklan ke platform analisis, lihat panduan Partner Atribusi Aplikasi (AAP) berikut:

Memahami objek AdValue

Objek AdValue mewakili nilai uang yang diperoleh untuk iklan, termasuk kode mata uang dan jenis presisi. Tabel berikut mencantumkan properti objek AdValue:

Properti Deskripsi
amountMicros Pendapatan iklan dalam unit mikro, dengan 1000000 mikro sama dengan satu unit mata uang, seperti US$1,00 atau €1,00.
currencyCode Kode mata uang ISO 4217 untuk nilai iklan, misalnya, USD atau EUR.
precision Tingkat presisi nilai iklan. Daftar berikut menjelaskan setiap tingkat presisi:
  • UNKNOWN: Nilai iklan yang tidak diketahui. Nilai ini ditampilkan saat pingback LTV diaktifkan tanpa data yang memadai.
  • ESTIMATED: Nilai iklan yang diperkirakan dari data gabungan.
  • PUBLISHER_PROVIDED: Nilai iklan yang diberikan penayang, seperti CPM manual dalam grup mediasi.
  • PRECISE: Nilai akurat yang dibayarkan untuk iklan.

Dalam Mediasi AdMob, AdMob berupaya memberikan nilai ESTIMATED untuk sumber iklan yang dioptimalkan. Untuk mengetahui detailnya, lihat Mengoptimalkan sumber iklan waterfall dalam mediasi. Jika sumber iklan tidak dioptimalkan, atau tidak memiliki cukup data gabungan untuk estimasi, Google Mobile Ads SDK for React Native akan menampilkan jenis presisi PUBLISHER_PROVIDED.

Menguji tayangan iklan dari sumber iklan bidding

Setelah peristiwa pendapatan iklan di tingkat tayangan iklan terjadi untuk sumber iklan bidding melalui permintaan pengujian, Anda hanya akan menerima nilai berikut:

  • UNKNOWN: menunjukkan jenis presisi.
  • 0: menunjukkan nilai iklan.

Untuk mengetahui detail tentang cara mengirim permintaan iklan pengujian, lihat Mengaktifkan perangkat pengujian.