हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव/राय देने के लिए, Google विज्ञापन और मेज़रमेंट कम्यूनिटी सर्वर में Ad Manager के आधिकारिक Discord चैनल से जुड़ें.
दिखाए गए विज्ञापनों के बारे में ज़्यादा जानने के लिए, इनाम वाले वीडियो विज्ञापनों पर विज्ञापन के मेटाडेटा में होने वाले बदलावों को सुनें.
onAdMetadataChanged() को तब कॉल किया जाता है, जब कोई विज्ञापन लोड हो जाता है या जब लोड होने के बाद, उसके मेटाडेटा में एसिंक्रोनस तरीके से बदलाव होता है. इस बात की कोई गारंटी नहीं है कि विज्ञापन लोड होने के समय, विज्ञापन का मेटाडेटा उपलब्ध होगा. इसलिए, हमारा सुझाव है कि विज्ञापन के मेटाडेटा को ऐक्सेस करने से पहले, इस कॉलबैक का इंतज़ार करें.
यहां कोड का एक उदाहरण दिया गया है. इसमें विज्ञापन का मेटाडेटा वापस पाने का तरीका बताया गया है:
मेटाडेटा वापस पाने के बाद, उन कुंजियों के लिए बंडल की जांच की जा सकती है जिनके बारे में आपको जानकारी चाहिए. अलग-अलग तरह के विज्ञापनों से, विज्ञापन के मेटाडेटा की अलग-अलग कुंजियां जुड़ी हो सकती हैं. वीएएसटी वीडियो विज्ञापनों में ये कुंजियां होती हैं:
Key
टाइप
ब्यौरा
AdId
स्ट्रिंग
विज्ञापन का आईडी. अगर उपलब्ध नहीं है, तो यह फ़ील्ड खाली होता है.
AdTitle
स्ट्रिंग
टाइटल. अगर यह नहीं दिया गया है, तो यह खाली होता है.
CreativeDurationMs
पूर्णांक
चुने गए क्रिएटिव की अवधि मिलीसेकंड में. अगर क्रिएटिव नॉन-लीनियर है, तो -1.
TraffickingParameters
स्ट्रिंग
ट्रैफ़िक पैरामीटर. अगर उपलब्ध नहीं हैं, तो खाली होते हैं.
DealId
स्ट्रिंग
मौजूदा विज्ञापन के लिए, रैपर चेन में मौजूद पहला डील आईडी.
यह आईडी, सबसे ऊपर से शुरू होता है. अगर यह आईडी उपलब्ध नहीं है, तो यह खाली होता है.
AdSystem
स्ट्रिंग
विज्ञापन का सोर्स ऐड सर्वर. अगर यह उपलब्ध नहीं है, तो इसे खाली छोड़ दें.
CreativeId
स्ट्रिंग
विज्ञापन के लिए चुने गए क्रिएटिव का आईडी. अगर यह उपलब्ध नहीं है, तो यह खाली होता है.
MediaURL
स्ट्रिंग
चुने गए मीडिया का यूआरएल.
Wrappers
Array
इस कलेक्शन में, सबसे अंदर वाले रैपर विज्ञापन से लेकर सबसे बाहर वाले रैपर विज्ञापन तक के एलिमेंट शामिल होते हैं. सबसे अंदर वाला रैपर विज्ञापन, इनलाइन विज्ञापन के सबसे करीब होता है. कलेक्शन में मौजूद हर एलिमेंट एक डिक्शनरी होती है. इसमें ये कुंजियां और वैल्यू शामिल होती हैं.
AdId
String. रैपर विज्ञापन के लिए इस्तेमाल किया गया विज्ञापन आईडी. अगर यह उपलब्ध नहीं है, तो इसे खाली छोड़ दें.
AdSystem
String. रैपर विज्ञापन के लिए इस्तेमाल किया गया विज्ञापन सिस्टम. अगर यह उपलब्ध नहीं है, तो यह खाली होता है.
CreativeId
String. रैपर विज्ञापन के लिए इस्तेमाल किया गया क्रिएटिव आईडी. अगर यह उपलब्ध नहीं है, तो इसे खाली छोड़ दें.
[null,null,["आखिरी बार 2025-08-31 (UTC) को अपडेट किया गया."],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003ePublishers can access ad metadata, such as ad ID, title, and duration, by implementing an \u003ccode\u003eAdMetadataListener\u003c/code\u003e and retrieving the metadata bundle via \u003ccode\u003eRewardedVideo.getAdMetadata()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eonAdMetadataChanged()\u003c/code\u003e 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.\u003c/p\u003e\n"],["\u003cp\u003eVAST video ads provide specific metadata keys, including AdId, AdTitle, CreativeDurationMs, TraffickingParameters, DealId, AdSystem, CreativeId, MediaURL, and Wrappers, which offer details about the served ad.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eWrappers\u003c/code\u003e key is exclusively present in VAST Wrapper ads and contains information about the ad's wrapper chain, while VAST Inline ads lack this key.\u003c/p\u003e\n"]]],["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"],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/ad-metadata \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/ad-metadata \"View this page for the iOS platform docs.\")\n\n\u003cbr /\u003e\n\nThis guide is intended for publishers integrating Ad Metadata with the Google\nMobile Ads SDK for Android.\n\nPrerequisites\n\n- Minimum version 17.0.0 of the Google Mobile Ads SDK.\n- Complete the steps in [Rewarded Video](/ad-manager/mobile-ads-sdk/android/rewarded-video).\n\nFetching ad metadata\n\nTo know more about served ads, listen for ad metadata changes on rewarded video\nads.\n\n`onAdMetadataChanged()` is called just after an ad loads or when its\nmetadata changes asynchronously after it loads. It is not guaranteed\nthat an ad's metadata will be available at the time the ad is\nloaded, so we recommend waiting for this callback before accessing an ad's\nmetadata.\n\nHere is a code example showing how to retrieve the ad metadata: \n\nJava \n\n```java\nRewardedAd.load(this, \"/21775744923/example/rewarded\", new AdManagerAdRequest.Builder().build(),\n new RewardedAdLoadCallback() {\n @Override\n public void onAdLoaded(@NonNull RewardedAd rewardedAd) {\n mRewardedAd = rewardedAd;\n rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() {\n @Override\n public void onAdMetadataChanged() {\n Bundle metadata = rewardedAd.getAdMetadata();\n String adId = metadata.getString(\"AdId\");\n }\n });\n }\n });\n```\n\nKotlin \n\n```kotlin\nRewardedAd.load(this, \"/21775744923/example/rewarded\", AdManagerAdRequest.Builder().build(),\n object : RewardedAdLoadCallback() {\n override fun onAdLoaded(rewardedAd: RewardedAd) {\n mRewardedAd = rewardedAd\n rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener {\n val metadata = rewardedAd.adMetadata\n val adId = metadata.getString(\"AdId\")\n }\n }\n })\n```\n\nAfter retrieving the metadata, you can check the Bundle for the keys you care\nabout. Different types of ads may have different ad metadata keys associated\nwith them. VAST video ads have the following keys:\n\n| `Key` | Type | Description |\n|-------------------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `AdId` | String | The ID of the ad, empty if not available. |\n| `AdTitle` | String | The title, empty if not specified. |\n| `CreativeDurationMs` | Integer | The selected creative duration in milliseconds, -1 if non-linear. |\n| `TraffickingParameters` | String | Trafficking parameters, empty if not available. |\n| `DealId` | String | The first deal ID present in the wrapper chain for the current ad, starting from the top--empty if not available. |\n| `AdSystem` | String | The source ad server of the ad, empty if not available. |\n| `CreativeId` | String | The ID of the selected creative for the ad, empty if not available. |\n| `MediaURL` | String | The URL of the selected media. |\n| `Wrappers` | Array | The array is populated with elements beginning at the innermost wrapper ad (close to the inline ad) moving outwards to the outermost wrapper ad. Each element in the array is a dictionary that contains the following keys and values. `AdId` : *String*. Ad ID used for wrapper ad, empty if not available. `AdSystem` : *String*. Ad system used for wrapper ad, empty if not available. `CreativeId` : *String*. Creative ID used for wrapper ad, empty if not available. |\n\n| **Note:** Only VAST Wrapper ads will have `Wrappers` key in the ad metadata. VAST Inline ads do not contain `Wrappers` metadata."]]
