Ürünlerimiz hakkında görüşlerinizi paylaşmak ve geri bildirimde bulunmak için Google Advertising and Measurement Community sunucusundaki resmi Ad Manager Discord kanalına katılın.
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:
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.
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.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-24 UTC."],[[["This guide explains how to integrate Ad Metadata with the Google Mobile Ads SDK for Android in publisher apps, requiring minimum SDK version 17.0.0 and completed Rewarded Video integration."],["Publishers can access ad metadata, such as ad ID, title, and duration, by implementing an `AdMetadataListener` and retrieving the metadata bundle via `RewardedVideo.getAdMetadata()`."],["`onAdMetadataChanged()` is triggered when an ad loads or its metadata changes, and it's recommended to wait for this callback before accessing ad metadata as it might not be immediately available."],["VAST video ads provide specific metadata keys, including AdId, AdTitle, CreativeDurationMs, TraffickingParameters, DealId, AdSystem, CreativeId, MediaURL, and Wrappers, which offer details about the served ad."],["The `Wrappers` key is exclusively present in VAST Wrapper ads and contains information about the ad's wrapper chain, while VAST Inline ads lack this key."]]],["Publishers using Google Mobile Ads SDK (min. v17.0.0) can access ad metadata for rewarded video ads. Implement `AdMetadataListener` with `RewardedVideoAd.setAdMetadataListener()` to track metadata changes. `onAdMetadataChanged()` triggers when metadata is available, use `RewardedVideo.getAdMetadata()` to access. This returns a Bundle, which for VAST ads contains keys like `AdId`, `AdTitle`, `CreativeDurationMs`, and others. Wrapper ads include a `Wrappers` array with details on each wrapper.\n"]]