Panduan ini ditujukan bagi penayang yang mengintegrasikan Metadata Iklan dengan Google Mobile Ads SDK untuk Android.
Prasyarat
- Google Mobile Ads SDK versi minimum 17.0.0.
- Selesaikan langkah-langkah dalam Video Reward.
Mengambil metadata iklan
Beberapa aplikasi mungkin ingin mengetahui lebih lanjut tentang iklan yang ditayangkan. Anda dapat
memproses perubahan metadata iklan pada iklan video reward dengan memanggil
RewardedVideoAd.setAdMetadataListener()
melalui penerapan
AdMetadataListener
. Setelah AdMetadataListener.onAdMetadataChanged()
dipanggil,
Anda dapat memeriksa RewardedVideo.getAdMetadata()
untuk metadata iklan.
onAdMetadataChanged()
dipanggil tepat setelah iklan dimuat atau saat
metadatanya berubah secara asinkron setelah dimuat. Tidak ada jaminan bahwa
metadata iklan akan tersedia pada saat iklan
dimuat. Jadi, sebaiknya tunggu callback ini sebelum mengakses metadata
iklan.
Berikut adalah contoh kode yang menunjukkan cara mengambil metadata iklan:
Java
RewardedAd.load(this, "/6499/example/rewarded", new AdManagerAdRequest.Builder().build(), new RewardedAdLoadCallback() { @Override public void onAdLoaded(@NonNull RewardedAd rewardedAd) { mRewardedAd = rewardedAd; rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() { @Override public void onAdMetadataChanged() { Bundle metadata = rewardedAd.getAdMetadata(); String adId = metadata.getString("AdId"); } }); } });
Kotlin
RewardedAd.load(this, "/6499/example/rewarded", AdManagerAdRequest.Builder().build(), object : RewardedAdLoadCallback() { override fun onAdLoaded(rewardedAd: RewardedAd) { mRewardedAd = rewardedAd rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener { val metadata = rewardedAd.adMetadata val adId = metadata.getString("AdId") } } })
Setelah mengambil metadata, Anda dapat memeriksa Bundle untuk kunci yang penting bagi Anda. Berbagai jenis iklan mungkin memiliki kunci metadata iklan yang berbeda dengan kunci tersebut. Iklan video VAST memiliki kunci berikut:
Key |
Jenis | Deskripsi |
---|---|---|
AdId |
String | ID iklan, kosong jika tidak tersedia. |
AdTitle |
String | Judul, kosong jika tidak ditentukan. |
CreativeDurationMs |
Bilangan Bulat | Durasi materi iklan yang dipilih dalam milidetik, -1 jika non-linear. |
TraffickingParameters |
String | Parameter proses iklan, kosong jika tidak tersedia. |
DealId |
String | ID transaksi pertama yang ada dalam rantai wrapper untuk iklan saat ini, dimulai dari bagian atas--kosong jika tidak tersedia. |
AdSystem |
String | Server iklan sumber iklan, kosong jika tidak tersedia. |
CreativeId |
String | ID materi iklan yang dipilih untuk iklan, kosong jika tidak tersedia. |
MediaURL |
String | URL media yang dipilih. |
Wrappers |
Array |
Array diisi dengan elemen yang dimulai dari iklan wrapper terdalam
(mendekati iklan inline) yang bergerak keluar ke iklan wrapper terluar. Setiap elemen dalam array adalah kamus yang berisi kunci dan nilai berikut.
|