ओपन मेज़रमेंट की सुविधा चालू करना

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

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

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

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

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

• अगर आपके विज्ञापनों को Ad Manager के ज़रिए ट्रैफ़िक किया जाता है, तो अपने Ad Manager नेटवर्क के लिए, विज्ञापन दिखने से जुड़े आंकड़ों को मेज़र करने की सुविधा देने वाला कोई वेंडर कॉन्फ़िगर करें . साथ ही, उस वेंडर को अपनी लाइन आइटम असाइन करें.

टेस्ट करना

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

आपको अपने वीएएसटी जवाब में <AdVerifications> दिखना चाहिए.

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

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

वीडियो कंट्रोल को ओवरले करने के उदाहरण के लिए, YouTube ऐप्लिकेशन पर कंट्रोल रेंडर करने वाली यह इमेज देखें:

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

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

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

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

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

private void registerFriendlyObstructions(
    AdDisplayContainer adDisplayContainer, View transparentTapOverlay, View pauseButton) {
  ImaSdkFactory imaSdkFactory = ImaSdkFactory.getInstance();
  // Make sure to register all friendly obstructions before ad playback starts.
  FriendlyObstruction overlayObstruction =
      imaSdkFactory.createFriendlyObstruction(
          transparentTapOverlay,
          FriendlyObstructionPurpose.NOT_VISIBLE,
          "This overlay is transparent");
  FriendlyObstruction pauseButtonObstruction =
      imaSdkFactory.createFriendlyObstruction(
          pauseButton,
          FriendlyObstructionPurpose.VIDEO_CONTROLS,
          "This is the video player pause button");

  adDisplayContainer.registerFriendlyObstruction(overlayObstruction);
  adDisplayContainer.registerFriendlyObstruction(pauseButtonObstruction);
}
OpenMeasurementSnippets.java

इन रुकावटों को हटाने के लिए, यह तरीका अपनाएं:

private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
  adDisplayContainer.unregisterAllFriendlyObstructions();
}
OpenMeasurementSnippets.java