Panduan ini ditujukan untuk 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 di Video Reward.
Mengambil metadata iklan
Untuk mengetahui lebih lanjut iklan yang ditayangkan, dengarkan perubahan metadata iklan pada iklan video reward.
onAdMetadataChanged() dipanggil tepat setelah iklan dimuat atau saat metadatanya berubah secara asinkron setelah dimuat. Metadata iklan tidak dijamin 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:
Kotlin
RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
override fun onAdLoaded(ad: RewardedAd) {
...
ad.adEventCallback = object : RewardedAdEventCallback {
override fun onAdMetadataChanged() {
val metadata = ad.adMetadata
val adId = metadata.getString("AdId")
}
}
}
})
Java
RewardedAd.load(
new AdRequest.Builder("AD_UNIT_ID").build(),
new AdLoadCallback<RewardedAd>() {
@Override
public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
Rewarded.this.rewardedAd = rewardedAd;
...
rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
@Override
public void onAdMetadataChanged() {
Bundle metadata = rewardedAd.getAdMetadata();
String adId = metadata.getString("AdId");
}
});
};
};
);
Ganti unit iklan AD_UNIT_ID. Misalnya, /21775744923/example/rewarded untuk iklan reward.
Setelah mengambil metadata, Anda dapat memeriksa Paket untuk kunci yang penting bagi Anda. Berbagai jenis iklan mungkin memiliki kunci metadata iklan yang berbeda-beda. 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 penayangan, kosong jika tidak tersedia. |
DealId |
String | ID transaksi pertama yang ada dalam rantai wrapper untuk iklan saat ini, dimulai dari yang teratas--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
(dekat dengan iklan inline) yang bergerak ke luar menuju iklan wrapper terluar. Setiap
elemen dalam array adalah kamus yang berisi kunci dan
nilai berikut.
|