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 नोड के साथ काम करता है. ओपन मेज़रमेंट का फ़ायदा पाने के लिए, इन बातों का ध्यान रखें:

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

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

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

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

टेस्ट करना

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

आपको अपने वीएएसटी (वीडियो विज्ञापन देने के लिए टेंप्लेट) जवाब में <AdVerifications> दिखना चाहिए.

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

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

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

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

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

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

IAB और MRC की मदद से, IMA SDK इन्हें रजिस्टर करने के लिए एक एपीआई उपलब्ध कराता है ओपन मेज़रमेंट 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();