Reklam Meta Verileri

Bu kılavuz, Android için Google Mobile Ads SDK'sı ile reklam meta verilerini 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 verilerini getirme

Sunulan reklamlar hakkında daha fazla bilgi edinmek için ödüllü video reklamlarındaki reklam meta verileri 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. Bir reklamın meta verilerinin, reklam yüklendiği sırada kullanılabilir olacağı garanti edilmez. Bu nedenle, bir reklamın meta verilerine erişmeden önce bu geri çağırma işleminin tamamlanmasını beklemenizi öneririz.

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

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

Meta verileri aldıktan sonra, ilgilendiğiniz anahtarlar için paketi kontrol edebilirsiniz. Farklı reklam türleriyle ilişkili farklı reklam meta verileri anahtarları olabilir. VAST video reklamlarında aşağıdaki anahtarlar bulunur:

Key Tür Açıklama
AdId Dize Reklamın kimliği. Kullanılamıyorsa boş.
AdTitle Dize Başlık, belirtilmemişse boş.
CreativeDurationMs Tamsayı Seçilen reklam öğesinin süresi (milisaniye cinsinden). Doğrusal olmayan reklam öğeleri için -1.
TraffickingParameters Dize Trafik oluşturma parametreleri (kullanılamıyorsa boş).
DealId Dize Geçerli reklam için sarmalayıcı zincirinde bulunan ilk anlaşma kimliği (en üstten başlayarak). Kullanılamıyorsa boş olur.
AdSystem Dize Reklamın kaynak reklam sunucusu. Kullanılamıyorsa boş olur.
CreativeId Dize Reklam için seçilen reklam öğesinin kimliği. Kullanılamıyorsa boş.
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. Sarmal reklam için kullanılan reklam kimliği. Kullanılamıyorsa boş bırakılır.
AdSystem
Dize. Sarmalayıcı reklam için kullanılan reklam sistemi. Kullanılamıyorsa boş.
CreativeId
Dize. Sarmalayıcı reklam için kullanılan reklam öğesi kimliği. Kullanılamıyorsa boş olur.