IMA डीएआई SDK टूल में मेज़रमेंट खोलें

Android के लिए IMA SDK में, ओपन मेज़रमेंट (OM) SDK टूल शामिल है. यह इंटरैक्टिव विज्ञापन ब्यूरो (IAB) ने बनाया है. यह इंडस्ट्री स्टैंडर्ड, तीसरे पक्ष के विज्ञापन दिखने से जुड़े आंकड़े और पुष्टि के मेज़रमेंट को चालू करने के लिए बनाया गया है.Androidके लिए IMA SDK का इस्तेमाल करते समय, शामिल किया गया OM SDK टूल, VAST विज्ञापन टैग में <AdVerifications> टैग को अपने-आप पार्स करता है और OMID API के ज़रिए तय मेज़रमेंट वेंडर को विज्ञापन दिखने से जुड़ा डेटा भेजता है.IMA SDK, OM SDK v, VAST 2+ पर GAM AdVERIFICATIONs एक्सटेंशन, और VAST 4+ पर Adverifications नोड का समर्थन करता है.ओपन मेज़रमेंट का फ़ायदा उठाने के लिए, इन बातों को ध्यान में रखें:

  • ओपन मेज़रमेंट का इस्तेमाल करने के लिए, आपके पासAndroid के लिए IMA SDK का 3.11.0 या उससे नया वर्शन. हालांकि, इस गाइड में दिया गया सैंपल, SDK टूल के सबसे नए वर्शन के लिए डिज़ाइन किया गया है. इसमें 3.16.5 वर्शन में पेश किए गए एपीआई भी शामिल हैं.

  • विज्ञापनों को उनके VAST (वीडियो विज्ञापन देने के लिए टेम्प्लेट) में <AdVerifications> ट्रैफ़िक के लिए कॉन्फ़िगर किया जाना चाहिए VAST 4.1 स्पेसिफ़िकेशन अगर VAST 4.1+ का इस्तेमाल किया जा रहा है; वरना, <Extension type="AdVerifications"> का इस्तेमाल किया जाना चाहिए.

  • AdDisplayContainer को किसी भी ओवरले (पारदर्शी या ओपेक) से न ढकें, क्योंकि इन्हें ओएम SDK टूल, विज्ञापनों में रुकावट के तौर पर फ़्लैग करता है और इससे विज्ञापन दिखने की संभावना कम हो जाती है.

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

टेस्ट करना

IMA SDK का इस्तेमाल करके, ओपन मेज़रमेंट की जांच करने के लिए, टेस्ट विज्ञापन टैग के साथ, ऊपर दिए गए SDK टूल के ज़रूरी वर्शन में से किसी एक का इस्तेमाल करें.

आपको अपने VAST जवाब में <AdVerifications> दिखेगा.

वीडियो कंट्रोल के ओवरले से जुड़ी रुकावटों को रजिस्टर करें

'रोकें' बटन या प्रोग्रेस बार जैसे वीडियो कंट्रोल से, वीडियो चलाने की ज़रूरी जानकारी मिलती है. साथ ही, उपयोगकर्ताओं को कार्रवाइयां भी की जा सकती हैं. मोबाइल पर, सटीक टैप और उपयोगकर्ता की उम्मीदों की वजह से, मीडिया एलिमेंट पर बड़े और टच-फ़्रेंडली कंट्रोल को रेंडर करना एक आम बात हो गई है. ये कंट्रोल आम तौर पर उपयोगकर्ता के टैप करने पर फ़ेड इन या आउट हो जाते हैं और ज़्यादातर वीडियो चलाने में ये नहीं दिखते.

YouTube ऐप्लिकेशन से रेंडर किए गए वीडियो कंट्रोल का एक उदाहरण यहां दिया गया है:

IMA SDK का इस्तेमाल करते समय, ज़्यादातर पब्लिशर इन कंट्रोल को लागू करने के लिए, विज्ञापन डिसप्ले कंटेनर के ऊपर एक ऐसा व्यू जोड़ते हैं जो ज़्यादातर पारदर्शी होता है. आम तौर पर, कंट्रोल इस व्यू के चाइल्ड एलिमेंट होते हैं, जो मौजूदा वीडियो प्लेयर पर पूरी तरह से शामिल होते हैं. इस पारदर्शी ओवरले का इस्तेमाल, टैप इवेंट को कैप्चर करने और फिर टैप करने पर उपयोगकर्ताओं को कंट्रोल रेंडर करने के लिए किया जाता है.

ओपन मेज़रमेंट SDK टूल की मदद से विज्ञापन दिखने से जुड़े आंकड़े कैलकुलेट करते समय, मीडिया एलिमेंट के ऊपर दिखने वाले सभी व्यू को रुकावट माना जाता है. इससे, विज्ञापन दिखने की दर कम हो जाती है. इस मामले में, जहां पारदर्शी टैप ओवरले, पूरे विज्ञापन डिसप्ले कंटेनर के ऊपर होता है, वहां इन्वेंट्री को 'पूरी तरह नहीं देखा जा सकता' के तौर पर मार्क किया जा सकता है.

ओपन मेज़रमेंट SDK टूल, वीडियो कंट्रोल के प्रावधानों को "काम की" बनाने वाली रुकावटों में से एक बनाता है, जो उपयोगकर्ता के अनुभव के लिए ज़रूरी हैं. 'फ़्रेंडली' के तौर पर रजिस्टर होने के बाद, इन कंट्रोल को विज्ञापन दिखने से जुड़े आंकड़ों के मेज़रमेंट से बाहर रखा जाता है.

IAB और MRC के साथ IMA SDK, इन ओवरले को ओपन मेज़रमेंट SDK के साथ रजिस्टर करने के लिए एक एपीआई उपलब्ध कराता है. ये नियंत्रण पूरी तरह से पारदर्शी होने चाहिए ओवरले या छोटे बटन होने चाहिए. कोई भी दूसरा व्यू, जो वीडियो के कंट्रोल से जुड़ा न हो, रजिस्टर नहीं होना चाहिए.

रजिस्टर करें रजिस्टर न करें
  • उपयोगकर्ता के टैप को कैप्चर करने के लिए पारदर्शी ओवरले
  • थोड़े समय के लिए बटन
    • रोकें
    • चलाएं
    • फ़ुलस्क्रीन
    • कास्ट/AirPlay
    • छोटा करें
    • प्रगति/आगे/पीछे जाना
    • प्लेबैक से जुड़ी दूसरी कार्रवाइयां
  • वॉटरमार्क
  • पॉप अप
  • डायलॉग
  • वे बटन जो अस्थायी तौर पर नहीं दिखते हैं
  • अन्य अस्पष्ट दृश्य

इस सैंपल कोड से, विज्ञापन डिसप्ले कंटेनर पर वीडियो कंट्रोल ओवरले को रजिस्टर करने का तरीका पता चलता है: 

myTransparentTapOverlay = (ViewGroup) rootView.findViewById(R.id.overlay);
myPauseButton = (ImageButton) rootView.findViewById(R.id.pauseButton);
// Substitute "myTransparentTapOverlay" and "myPauseButton" with the
// elements you want to register as video controls overlays.
// Make sure to register before ad playback starts.
overlayObstruction = ImaSdkFactory.createFriendlyObstruction(
  myTransparentTapOverlay,
  FriendlyObstructionPurpose.NOT_VISIBLE,
  "This overlay is transparent"
);
pauseButtonObstruction = ImaSdkFactory.createFriendlyObstruction(
  myPauseButton,
  FriendlyObstructionPurpose.VIDEO_CONTROLS,
  "This is the video player pause button"
);

displayContainer.registerFriendlyObstruction(overlayObstruction);
displayContainer.registerFriendlyObstruction(pauseButtonObstruction);

काम पूरा हो जाने के बाद, ये रुकावटें दूर हो सकती हैं. इसके लिए, यहां दिए गए तरीकों का इस्तेमाल करें: 

displayContainer.unregisterAllFriendlyObstructions();