Reklam meta verileri

Bu kılavuz, reklam meta verilerini Android için Google Mobile Ads SDK'sıyla entegre eden yayıncılar için hazırlanmıştır.

Ön koşullar

  • Google Mobile Ads SDK'sının minimum 17.0.0 sürümü.
  • Ödüllü Video bölümündeki adımları tamamlayın.

Reklam meta verileri getiriliyor

Yayınlanan reklamlar hakkında daha fazla bilgi edinmek için ödüllü video reklamlardaki reklam meta verisi değişikliklerini dinleyin.

onAdMetadataChanged(), bir reklam yüklendikten hemen sonra veya yüklendikten sonra meta verileri eşzamansız olarak değiştiğinde çağrılır. Reklam yüklendiğinde reklamın meta verilerinin kullanılabilir olacağı garanti edilmez. Bu nedenle, reklamın meta verilerine erişmeden önce bu geri çağırmayı beklemenizi öneririz.

Reklam meta verilerinin nasıl alınacağını gösteren bir kod örneği aşağıda verilmiştir:

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");
            }
        });
      };
    };
  );

AD_UNIT_ID reklam birimini değiştirin. Örneğin, ödüllü reklamlar için /21775744923/example/rewarded.

Meta verileri aldıktan sonra Bundle'da ilgilendiğiniz anahtarları kontrol edebilirsiniz. Farklı reklam türleriyle ilişkili farklı reklam meta veri anahtarları olabilir. VAST video reklamlar aşağıdaki anahtarlara sahiptir:

Key Tür Açıklama
AdId Dize Reklamın kimliği (mevcut değilse boş bırakılır).
AdTitle Dize Başlık. Belirtilmezse boş bırakılır.
CreativeDurationMs Tamsayı Milisaniye cinsinden seçilen reklam öğesi süresi, doğrusal değilse -1.
TraffickingParameters Dize Trafik işlemleri parametreleri (mevcut değilse boş bırakılır).
DealId Dize Geçerli reklam için sarmalayıcı zincirinde bulunan ilk anlaşma kimliği, en üstten başlar. Yoksa boştur.
AdSystem Dize Reklamın kaynak reklam sunucusu. Yoksa boş bırakılır.
CreativeId Dize Reklam için seçilen reklam öğesinin kimliği (mevcut değilse boş bırakılır).
MediaURL Dize Seçilen medyanın URL'si.
Wrappers Dizi Dizi, en içteki sarmalayıcı reklamdan (satır içi reklama yakın) başlayıp en dıştaki sarmalayıcı reklama doğru ilerleyen öğelerle doldurulur. Dizideki her öğe, aşağıdaki anahtarları ve değerleri içeren bir sözlüktür.
AdId
Dize. Sarmalayıcı reklam için kullanılan reklam kimliği. Yoksa boş bırakılır.
AdSystem
Dize. Sarmalayıcı reklam için kullanılan reklam sistemi. Yoksa boştur.
CreativeId
Dize. Sarmalayıcı reklam için kullanılan reklam öğesi kimliği. Yoksa boş bırakılır.