Android के लिए IMA SDK में, ओपन मेज़रमेंट (ओएम) SDK शामिल है. यह इंडस्ट्री का एक स्टैंडर्ड है. इसे Interactive Advertising Bureau (IAB) ने बनाया है. इसकी मदद से, तीसरे पक्ष के विज्ञापन दिखने से जुड़े आंकड़ों और पुष्टि के मेज़रमेंट को चालू किया जा सकता है. Android के लिए IMA SDK का इस्तेमाल करते समय, इसमें शामिल ओएम एसडीके, वीएएसटी विज्ञापन टैग में मौजूद <AdVerifications> टैग को अपने-आप पार्स कर लेता है. साथ ही, ओएमआईडी एपीआई का इस्तेमाल करके, विज्ञापन दिखने से जुड़े आंकड़ों को तय किए गए मेज़रमेंट वेंडर को भेज देता है. IMA SDK, ओएम एसडीके के 1.6 वर्शन, वीएएसटी 2+ पर GAM AdVerifications एक्सटेंशन, और वीएएसटी 4+ पर AdVerifications नोड के साथ काम करता है.ओपन मेज़रमेंट का फ़ायदा लेने के लिए, इन बातों का ध्यान रखें:
ओपन मेज़रमेंट का इस्तेमाल करने के लिए, आपके पास Android के लिए IMA SDK का 3.11.0 या उससे नया वर्शन होना चाहिए. हालांकि, इस गाइड में दिया गया सैंपल, एसडीके के नए वर्शन के लिए डिज़ाइन किया गया है. इसमें 3.16.5 वर्शन में शामिल किए गए एपीआई भी शामिल हैं.
अगर वीएएसटी 4.1 या उससे नया वर्शन इस्तेमाल किया जा रहा है, तो यह ज़रूरी है कि विज्ञापनों को वीएएसटी 4.1 की खास जानकारी के मुताबिक, उनके वीएएसटी में
<AdVerifications>को ट्रैफ़िक करने के लिए कॉन्फ़िगर किया जाए. ऐसा न करने पर,<Extension type="AdVerifications">का इस्तेमाल किया जाना चाहिए.AdDisplayContainerको किसी भी ओवरले (पारदर्शी या अपारदर्शी) से कवर न करें. ऐसा करने पर, ओएम एसडीके इन्हें रुकावट के तौर पर फ़्लैग करेगा और विज्ञापन दिखने की दर कम हो जाएगी.
ज़रूरी शर्तें
- अगर आपके विज्ञापनों को Ad Manager के ज़रिए ट्रैफ़िक किया जाता है, तो विज्ञापन दिखने से जुड़े आंकड़े उपलब्ध कराने वाला कोई वेंडर अपने Ad Manager नेटवर्क के लिए कॉन्फ़िगर करें और उस वेंडर को अपनी लाइन आइटम असाइन करें.
टेस्ट करना
IMA SDK का इस्तेमाल करके, ओपन मेज़रमेंट को टेस्ट करने के लिए, IMA के ऐसे वर्शन का इस्तेमाल करें जो ओएम एसडीके के साथ काम करता हो. इसके अलावा, टेस्ट विज्ञापन टैग का भी इस्तेमाल करें.
आपको अपने वीएएसटी जवाब में, <AdVerifications> दिखना चाहिए.
वीडियो कंट्रोल के ओवरले में आने वाली रुकावटों को रजिस्टर करना
वीडियो कंट्रोल, जैसे कि 'रोकें' बटन या प्रोग्रेस बार, लोगों को वीडियो चलाने से जुड़ी ज़रूरी जानकारी और कार्रवाइयां उपलब्ध कराते हैं. मोबाइल पर, सटीक तरीके से टैप न कर पाने और लोगों की उम्मीदों की वजह से, मीडिया एलिमेंट पर बड़े और टच-फ़्रेंडली कंट्रोल रेंडर करना आम बात हो गई है. ये कंट्रोल, आम तौर पर किसी उपयोगकर्ता के टैप करने पर फ़ेड इन और आउट होते हैं. साथ ही, वीडियो चलाने के ज़्यादातर समय के दौरान ये नहीं दिखते.
वीडियो कंट्रोल को ओवरले करने के उदाहरण के लिए, YouTube ऐप्लिकेशन पर कंट्रोल रेंडर करने वाली यह इमेज देखें:
IMA SDK का इस्तेमाल करते समय, ज़्यादातर पब्लिशर इन कंट्रोल को, विज्ञापन दिखाने वाले कंटेनर के ऊपर एक व्यू जोड़कर लागू करते हैं. यह व्यू ज़्यादातर पारदर्शी होता है. आम तौर पर, कंट्रोल इस व्यू के चाइल्ड एलिमेंट होते हैं. ये एलिमेंट, वीडियो प्लेयर को पूरी तरह से कवर कर लेते हैं. टैप इवेंट कैप्चर करने के लिए, इस पारदर्शी ओवरले का इस्तेमाल किया जाता है. इसके बाद, टैप करने पर लोगों को कंट्रोल रेंडर किए जाते हैं.
ओपन मेज़रमेंट एसडीके का इस्तेमाल करके, विज्ञापन दिखने से जुड़े आंकड़ों का हिसाब लगाते समय, मीडिया एलिमेंट को ओवरले करने वाले सभी व्यू को रुकावटें माना जाता है. इससे, विज्ञापन दिखने की दर कम हो जाती है. अगर कोई पारदर्शी टैप ओवरले, विज्ञापन दिखाने वाले पूरे कंटेनर के ऊपर मौजूद है, तो इन्वेंट्री को पूरी तरह से न दिखने वाला बताया जा सकता है.
ओपन मेज़रमेंट एसडीके में, वीडियो कंट्रोल को "काम की" रुकावटें माना जाता है. ये रुकावटें, लोगों के अनुभव के लिए ज़रूरी होती हैं. काम की रुकावटों के तौर पर रजिस्टर होने के बाद, इन कंट्रोल को विज्ञापन दिखने से जुड़े आंकड़ों के मेज़रमेंट से बाहर रखा जाता है.
IAB और MRC की मदद से, IMA 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);
}
इन रुकावटों को हटाने के लिए, यह तरीका अपनाएं:
private void unregisterFriendlyObstructions(AdDisplayContainer adDisplayContainer) {
adDisplayContainer.unregisterAllFriendlyObstructions();
}