IMA SDK में मेज़रमेंट खोलें

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

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

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

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

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

टेस्ट करना

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

आपको अपने VAST रिस्पॉन्स में <AdVerifications> दिखेगा.

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

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

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

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

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

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

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

DO register रजिस्टर न करें
  • उपयोगकर्ता के टैप को कैप्चर करने के लिए पारदर्शी ओवरले
  • कुछ समय के लिए दिखने वाले बटन
    • रोकें
    • चलाएं
    • फ़ुलस्क्रीन
    • कास्ट/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();