Metadata Iklan

Panduan ini ditujukan bagi penayang yang mengintegrasikan Metadata Iklan dengan Google Mobile Ads SDK untuk Android.

Prasyarat

  • Versi minimum 17.0.0 Google Mobile Ads SDK.
  • Selesaikan langkah-langkah di Video Reward.

Mengambil metadata iklan

Untuk mengetahui lebih lanjut iklan yang ditayangkan, dengarkan perubahan metadata iklan di iklan video reward.

onAdMetadataChanged() dipanggil tepat setelah iklan dimuat atau saat metadata-nya 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 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");
            }
        });
      };
    };
  );

Mengganti unit iklan AD_UNIT_ID. Misalnya, /21775744923/example/rewarded untuk iklan reward.

Setelah mengambil metadata, Anda dapat memeriksa Bundle untuk kunci yang Anda inginkan. Berbagai jenis iklan mungkin memiliki kunci metadata iklan yang berbeda-beda yang terkait dengannya. 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 iklan, kosong jika tidak tersedia.
DealId String ID kesepakatan pertama yang ada di rantai wrapper untuk iklan saat ini, mulai dari 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 paling dalam (dekat dengan iklan inline) yang bergerak ke luar menuju iklan wrapper paling luar. Setiap elemen dalam array adalah kamus yang berisi kunci dan nilai berikut.
AdId
String. ID Iklan yang digunakan untuk iklan wrapper, kosong jika tidak tersedia.
AdSystem
String. Sistem iklan yang digunakan untuk iklan wrapper, kosong jika tidak tersedia.
CreativeId
String. ID materi iklan yang digunakan untuk iklan wrapper, kosong jika tidak tersedia.