Saat tayangan terjadi, Google Mobile Ads SDK akan memberikan data pendapatan iklan yang terkait dengan tayangan tersebut. Anda dapat menggunakan data untuk menghitung nilai umur pengguna, atau meneruskan downstream data ke sistem lain yang relevan.
Panduan ini ditujukan untuk membantu Anda menerapkan pengambilan data pendapatan iklan tingkat tayangan iklan di project Unity Anda.
Prasyarat
- Pastikan Anda telah mengaktifkan fitur pendapatan iklan tingkat tayangan di UI AdMob.
- Plugin Unity 5.0.0 atau yang lebih tinggi.
- Selesaikan Mulai. Aplikasi Unity Anda harus sudah mengimpor plugin Google Mobile Ads Unity.
Sebelum dapat menerima data pendapatan iklan tingkat tayangan, Anda harus menerapkan setidaknya satu format iklan:
Mengimplementasikan pengendali peristiwa berbayar
Setiap format iklan memiliki peristiwa OnPaidEvent
. Selama siklus proses peristiwa iklan, Google Mobile Ads SDK memantau peristiwa tayangan dan memanggil pengendali dengan nilai yang diperoleh.
Kode di bawah menunjukkan cara menangani peristiwa berbayar untuk iklan reward:
RewardedAd rewardedAd; private void RequestRewardedAd() { rewardedAd = new RewardedAd("AD_UNIT_ID"); rewardedAd.OnPaidEvent += this.HandleAdPaidEvent; AdRequest adRequest = new AdRequest(); rewardedAd.LoadAd(adRequest); } public void HandleAdPaidEvent(object sender, AdValueEventArgs args) { // TODO: Send the impression-level ad revenue information to your // preferred analytics server directly within this callback. AdValue adValue = args.AdValue; long valueMicros = adValue.Value; string currencyCode = adValue.CurrencyCode; PrecisionType precision = adValue.Precision; ResponseInfo responseInfo = rewardedAd.GetResponseInfo(); string responseId = responseInfo.GetResponseId(); AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo(); string adSourceId = loadedAdapterResponseInfo.AdSourceId; string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId; string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName; string adSourceName = loadedAdapterResponseInfo.AdSourceName; string adapterClassName = loadedAdapterResponseInfo.AdapterClassName; long latencyMillis = loadedAdapterResponseInfo.LatencyMillis; Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping; Dictionary<string, string> extras = responseInfo.GetResponseExtras(); string mediationGroupName = extras["mediation_group_name"]; string mediationABTestName = extras["mediation_ab_test_name"]; string mediationABTestVariant = extras["mediation_ab_test_variant"]; }
Untuk informasi selengkapnya tentang sumber iklan pemenang, lihat mengambil Informasi tentang respons iklan.
Berintegrasi dengan Partner Atribusi Aplikasi (AAP)
Untuk mengetahui detail selengkapnya tentang penerusan data pendapatan iklan ke platform analisis, lihat panduan partner:
SDK Partner |
---|
Adjust |
AppsFlyer |
Singular |
Tenjin |
Praktik terbaik penerapan
- Tetapkan peristiwa
OnPaidEvent
segera setelah Anda membuat atau mendapatkan akses ke objek iklan, dan pastinya sebelum menampilkan iklan. Hal ini memastikan bahwa Anda tidak melewatkan callback apa pun. - Kirim informasi pendapatan iklan tingkat tayangan ke server analisis pilihan Anda segera di pengendali
OnPaidEvent
. Hal ini memastikan bahwa Anda tidak melepaskan callback secara tidak sengaja dan menghindari perbedaan data.
AdValue
AdValue
adalah class yang mewakili nilai uang yang diperoleh untuk sebuah iklan,
termasuk kode mata uang nilai dan jenis presisinya yang dienkode seperti di bawah ini.
AdValue.PrecisionType |
Deskripsi |
---|---|
Unknown |
Nilai iklan yang tidak diketahui. Nilai ini ditampilkan saat pingback LTV diaktifkan, tetapi data yang tersedia tidak cukup. |
Estimated |
Estimasi nilai iklan dari data gabungan. |
PublisherProvided |
Nilai iklan yang diberikan penayang, seperti CPM manual dalam grup mediasi. |
Precise |
Nilai yang tepat dari iklan ini. |
Dalam kasus mediasi, AdMob mencoba memberikan nilai ESTIMATED
untuk sumber iklan yang dioptimalkan. Untuk sumber iklan yang tidak dioptimalkan, atau jika data gabungan tidak memadai untuk melaporkan estimasi yang bermakna, nilai PUBLISHER_PROVIDED
akan ditampilkan.