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 sürümü 17.0.0 olmalıdır.
  • Ö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:

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, /21775744923/example/rewarded ödüllü reklamlar için.

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ş olur.
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.