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:
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.
|