Reklam Meta Verileri

Bu kılavuz, reklam meta verilerini Android için Google Mobile Ads SDK'sı ile entegre eden yayıncılara yöneliktir.

Ön koşullar

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

Reklam meta verilerini getirme

Bazı uygulamalar, yayınlanan reklamlar hakkında daha fazla bilgi edinmek isteyebilir. AdMetadataListener uygulamasını kullanarak RewardedVideoAd.setAdMetadataListener()'ü çağırarak ödüllü video reklamlardaki reklam meta veri değişikliklerini dinleyebilirsiniz. AdMetadataListener.onAdMetadataChanged() çağrıldıktan sonra, bir reklamın meta verilerini RewardedVideo.getAdMetadata() üzerinden kontrol edebilirsiniz.

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üklenirken kullanılabileceği garanti edilmez. Bu nedenle, bir reklamın meta verilerine erişmeden önce bu geri çağırma işlevini 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ürlerinin 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ş).
AdTitle Dize Başlık. Belirtilmemişse boş olur.
CreativeDurationMs Tamsayı Seçilen reklam öğesi süresi (milisaniye cinsinden). Doğrusal olmayan reklam öğeleri için -1.
TraffickingParameters Dize Trafik parametreleri (mevcut değilse boş).
DealId Dize Mevcut reklamın sarmalayıcı zincirinde en üstten başlayan ilk anlaşma kimliği (mevcutsa boş).
AdSystem Dize Reklamın kaynak reklam sunucusu. Mevcut değilse boştur.
CreativeId Dize Reklam için seçilen reklam öğesinin kimliği (mevcut değilse boş).
MediaURL Dize Seçilen medyanın URL'si.
Wrappers Dizi Dizi, en içteki sarmalayıcı reklamdan (satır içi reklamın yakınında) başlayıp en dıştaki sarmalayıcı reklama doğru dışa doğru hareket eden öğ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. Mevcut değilse boş olur.
AdSystem
Dize. Sarmalayıcı reklam için kullanılan reklam sistemi. Mevcut değilse boştur.
CreativeId
Dize. Sarmalayıcı reklam için kullanılan reklam öğesi kimliği. Mevcut değilse boş olur.