विज्ञापन का मेटाडेटा

यह गाइड उन पब्लिशर के लिए है जो Android के लिए, Google Mobile Ads SDK के साथ विज्ञापन मेटाडेटा को इंटिग्रेट कर रहे हैं.

ज़रूरी शर्तें

विज्ञापन का मेटाडेटा फ़ेच किया जा रहा है

कुछ ऐप्लिकेशन, दिखाए गए विज्ञापनों के बारे में ज़्यादा जानना चाहते हैं. AdMetadataListener लागू करने वाले RewardedVideoAd.setAdMetadataListener() को कॉल करके, इनाम वाले वीडियो विज्ञापनों के मेटाडेटा में हुए बदलावों के बारे में सुना जा सकता है. AdMetadataListener.onAdMetadataChanged() को कॉल करने के बाद, किसी विज्ञापन के मेटाडेटा के लिए RewardedVideo.getAdMetadata() की जांच की जा सकती है.

onAdMetadataChanged() को तब कॉल किया जाता है, जब कोई विज्ञापन लोड होता है या जब लोड होने के बाद उसका मेटाडेटा एसिंक्रोनस रूप से बदल जाता है. इस बात की कोई गारंटी नहीं है कि विज्ञापन लोड होते समय विज्ञापन का मेटाडेटा उपलब्ध होगा. इसलिए, हमारा सुझाव है कि विज्ञापन का मेटाडेटा ऐक्सेस करने से पहले, इस कॉलबैक का इंतज़ार करें.

यहां कोड का एक उदाहरण दिया गया है, जिसमें विज्ञापन मेटाडेटा को फिर से पाने का तरीका बताया गया है:

Java

RewardedAd.load(this, "/6499/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, "/6499/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")
        }
      }
    })

मेटाडेटा वापस पाने के बाद, उन कुंजियों के लिए बंडल देखा जा सकता है जो आपके लिए ज़रूरी हैं. अलग-अलग तरह के विज्ञापनों में, उनसे जुड़ी विज्ञापन मेटाडेटा की अलग-अलग कुंजियां हो सकती हैं. VAST वीडियो विज्ञापनों में ये कुंजियां होती हैं:

Key Type ब्यौरा
AdId String विज्ञापन का आईडी, उपलब्ध न होने पर खाली छोड़ा जा सकता है.
AdTitle String टाइटल, अगर बताया नहीं गया है, तो इसे खाली रखें.
CreativeDurationMs Integer चुनी गई क्रिएटिव अवधि मिलीसेकंड में. अगर लीनियर हो, तो -1.
TraffickingParameters String ट्रैफ़िकिंग पैरामीटर, अगर उपलब्ध न हों, तो खाली है.
DealId String मौजूदा विज्ञापन के लिए रैपर चेन में पहला डील आईडी मौजूद होता है. अगर यह आईडी उपलब्ध नहीं है, तो सबसे ऊपर से शुरू होता है. खाली हेडर भी होता है.
AdSystem String विज्ञापन का सोर्स विज्ञापन सर्वर, अगर उपलब्ध नहीं है, तो खाली होगा.
CreativeId String विज्ञापन के लिए चुने गए क्रिएटिव की आईडी, उपलब्ध न होने पर खाली है.
MediaURL String चुने गए मीडिया का यूआरएल.
Wrappers Array कलेक्शन में ऐसे एलिमेंट शामिल होते हैं जो सबसे बीच में रैपर विज्ञापन की शुरुआत से (इनलाइन विज्ञापन के पास) से शुरू होते हैं. कलेक्शन में मौजूद हर एलिमेंट एक डिक्शनरी है. इसमें, यहां दी गई कुंजियां और वैल्यू शामिल होती हैं.
AdId
स्ट्रिंग. रैपर विज्ञापन के लिए इस्तेमाल की गई विज्ञापन आईडी, उपलब्ध न होने पर खाली है.
AdSystem
स्ट्रिंग. रैपर विज्ञापन के लिए इस्तेमाल किया जाने वाला विज्ञापन सिस्टम, उपलब्ध न होने पर खाली होता है.
CreativeId
स्ट्रिंग. रैपर विज्ञापन के लिए इस्तेमाल किया गया क्रिएटिव आईडी, उपलब्ध न होने पर खाली होता है.