Google Mobile Ads SDK dalam mode pemeliharaan. Untuk mendapatkan update dan fitur terbaru, migrate dan siapkan GMA Next-Gen SDK.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Metadata iklan

Pilih platform: Android

Android iOS

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 saat iklan dimuat, jadi sebaiknya tunggu callback ini sebelum mengakses metadata iklan.

Berikut contoh kode yang menunjukkan cara mengambil metadata iklan:

Java

RewardedAd.load(this, "/21775744923/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, "/21775744923/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 Paket untuk kunci yang Anda inginkan. Jenis iklan yang berbeda mungkin memiliki kunci metadata iklan yang berbeda. 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 tidak 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 hingga iklan wrapper terluar. 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.