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

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

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

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

दिखाए गए विज्ञापनों के बारे में ज़्यादा जानने के लिए, इनाम वाले वीडियो विज्ञापनों पर विज्ञापन के मेटाडेटा में होने वाले बदलावों को सुनें.

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

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

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 विज्ञापन यूनिट को बदलें. उदाहरण के लिए, /21775744923/example/rewarded इनाम वाले विज्ञापनों के लिए.

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

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