मोबाइल रिच मीडिया विज्ञापन

Google Mobile Ads SDK में अब MRAID v3 के लिए बीटा वर्शन की सुविधा उपलब्ध है. यह सुविधा MRAID v2 के लिए पहले से मौजूद सहायता पर आधारित है. इसकी मदद से विज्ञापन देने वाले, Ad Manager पब्लिशर को MRAID v3 क्रिएटिव उपलब्ध करा सकते हैं. इस गाइड में MRAID लागू करने की उस जानकारी की साफ़ तौर पर बताई गई है जो साफ़ नहीं है और जिसे MRAID v3 की खास जानकारी में समझा जा सकता है. इसकी ऑडियंस MRAID v3 क्रिएटिव लेखक हैं.

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

पब्लिशर को:

• MRAID v3 के लिए Google Play services का 15.0.0 या इसके बाद का वर्शन
• MRAID v2 वर्शन के लिए Google Play services का 7.8 या उसके बाद का वर्शन

मददगार प्राइमर

अगर आपको MRAID के बारे में नहीं पता है, तो IAB MRAID पेज पर जाकर इस बारे में ज़्यादा जानें. एमआरएआईडी v3 परिभाषाएं दस्तावेज़ भी डाउनलोड किया जा सकता है, जिसमें नीचे बताए गए सभी पैरामीटर के बारे में जानकारी दी गई है. साथ ही, एमआरएआईडी v3 पर IAB की ब्लॉग पोस्ट भी डाउनलोड की जा सकती है.

MRAID v3 (बीटा) को लागू करने के बारे में जानकारी

विज्ञापन दिखने से जुड़े आंकड़े - एक्सपोज़र बदलने का इवेंट

यह इवेंट काम करता है. हमारा सुझाव है कि आप अब काम नहीं कर रहे viewableChange इवेंट के बजाय नए exposureChange इवेंट के लिए, लिसनर का इस्तेमाल करें. mraid.isViewable() वाला तरीका अब काम नहीं करता. हालांकि, काम न करने वाले ये तरीके, पुराने सिस्टम के साथ काम करते रहेंगे.

विज्ञापन व्यू में बदलाव होने पर, exposureChange इवेंट की परिभाषा भेज दी जाती है. SDK टूल में पोल कराने की सुविधा मौजूद है, ताकि ज़्यादा इवेंट जनरेट होने से रोका जा सके. विज्ञापन की ओर से लिसनर को रजिस्टर करने के बाद, शुरुआती स्थिति एसिंक्रोनस रूप से भेजी जाती है. कॉलबैक में exposed_percentage पैरामीटर शामिल होता है, जो 0.0 और 100.0 के बीच का फ़्लोटिंग-पॉइंट नंबर होता है.

सैंपल के इस्तेमाल के लिए, MRAID v3 की खास बातें देखें.

MRAID की पहचान और शुरू करने की प्रक्रिया और MRAID_ENV एट्रिब्यूट

SDK टूल, MRAID v3 स्पेसिफ़िकेशन में बताए गए इनिशलाइज़ेशन प्रोटोकॉल के मुताबिक है.

MRAID_ENV ऑब्जेक्ट में, SDK टूल IDFA, limitAdTracking, ऐप्लिकेशन आईडी या कोपा (जो ज़रूरी नहीं है) नहीं भेजता. यह MRAID_ENV ऑब्जेक्ट में सभी ज़रूरी वैरिएबल देता है. इनमें MRAID वर्शन, SDK टूल का नाम, और SDK वर्शन शामिल है.

ऑडिबिलिटी मेज़रमेंट

एक नया इवेंट (audioVolumeChange) लॉन्च किया गया है, ताकि यह पता लगाया जा सके कि ऑडियो सुना जा सकता है या नहीं और वॉल्यूम में बदलाव कब होता है.

audioVolumeChange इवेंट में एक पैरामीटर है: volume_percentage. यह वैल्यू, ऑडियो चलाने की सबसे ज़्यादा आवाज़ का प्रतिशत होती है. यह 0.0 और 100.0 (वीडियो चलाने की अनुमति न होने पर 0.0) के बीच का फ़्लोटिंग-पॉइंट नंबर होता है. वॉल्यूम का पता न लगने पर, यह null के बीच होता है.

सैंपल के इस्तेमाल के लिए, MRAID v3 की खास बातें देखें.

mraid.getLocation()

mraid.getLocation() काम नहीं करता, इसलिए यह हमेशा -1 दिखाता है.

mraid.unload()

इस तरीके को कभी भी इस्तेमाल किया जा सकता है. साथ ही, SDK टूल जब चाहे, विज्ञापन को खारिज करता है, संसाधनों को दिखाता है, और उसके बाद वेबव्यू हटा देता है या उसे किसी दूसरे दस्तावेज़ या नए विज्ञापन से बदलता है.

जब क्रिएटिव unload() को कॉल करता है, तो नेटिव लेयर अलग-अलग क्रिएटिव टाइप के लिए इस तरह से जवाब देती है:

टाइप	Unload() व्यवहार
बैनर	मौजूदा विज्ञापन के अनुरोध पैरामीटर वाले ही विज्ञापन अनुरोध करें.
अचानक दिखने वाला (इंटरस्टीशियल) विज्ञापन	पेज पर अचानक दिखने वाला विज्ञापन बंद करें.

gclid (वीडियो प्लेयर विज्ञापन इंटरफ़ेस की परिभाषा)

Google Mobile Ads SDK, CONTENT के साथ काम नहीं करता. mraid.supports('vpaid') 'गलत' दिखाता है.

mraid.useCustomClose()

फ़ॉर्मैट और क्रिएटिव टाइप के आधार पर, हो सकता है कि mraid.useCustomClose() काम न करे.

MRAID v2 को लागू करने के बारे में जानकारी

mraid.getVersion()

जब तक क्रिएटिव लोड नहीं हो जाता, तब तक mraid.getVersion() 2.0 नहीं दिखाता. जब mraid.getState(), loading दिखाता है, तब MRAID वर्शन की जांच न करें.

mraid.resize()

जब mraid.resize() को कॉल किया जाता है, तो ओरिजनल बैनर को बैनर की स्क्रीनशॉट इमेज से बदल दिया जाता है. अगर बदले गए साइज़ वाले विज्ञापन में, ओरिजनल विज्ञापन स्पेस नहीं है, तो यह साफ़ तौर पर दिखेगा.

साइज़ किए गए विज्ञापन, ओरिजनल बैनर फ़्रेम के साथ भी नहीं दिखते हैं. अगर स्क्रोल करने वाले व्यू में कोई बैनर रखा जाता है, तो साइज़ बदला गया विज्ञापन, बैनर के साथ स्क्रोल नहीं करता.

अहम जानकारी: mraid.resize() और ऐसे ही दूसरे फ़ंक्शन का तब तक कोई असर नहीं होगा, जब तक कि विज्ञापन पर क्लिक नहीं किया जाता. यह नुकसान पहुंचाने वाले क्रिएटिव को, अपने-आप साइज़ बदलने और पूरी स्क्रीन पर जगह लेने से रोकता है.

mraid.setResizeProperties()

mraid.setResizeProperties() को किए जाने वाले सभी कॉल में ज़रूरी प्रॉपर्टी की पूरी सूची होनी चाहिए. अगर साइज़ बदलने वाली प्रॉपर्टी अमान्य हैं, तो उन्हें वापस डिफ़ॉल्ट पर सेट कर दिया जाएगा. साथ ही, mraid.resize() के बाद किए जाने वाले सभी कॉल तब तक काम नहीं करेंगे, जब तक mraid.setResizeProperties() को मान्य पैरामीटर के साथ फिर से कॉल नहीं किया जाता.

mraid.getMaxSize()

mraid.getMaxSize() का इस्तेमाल सिर्फ़ ऐसे विज्ञापनों का ज़्यादा से ज़्यादा साइज़ तय करने के लिए किया जाना चाहिए जिनका साइज़ बदला गया हो. बड़े होने वाले विज्ञापन का साइज़ तय करने के लिए, mraid.getScreenSize() का इस्तेमाल करें.

mraid.setOrientationProperties()

allowOrientationChange प्रॉपर्टी को true पर सेट करके, mraid.setOrientationProperties() को कॉल करने पर, forceOrientation प्रॉपर्टी को सेट करने से कोई असर नहीं पड़ेगा. ऐसे क्रिएटिव जो ओरिएंटेशन को लागू करना चाहते हैं, उन्हें allowOrientationChange को false पर सेट करना चाहिए.

mraid.isViewable()

अगर व्यू में किसी दूसरे दिखने वाले विज्ञापन को कवर कर लिया जाता है, तो mraid.isViewable() फिर भी true दिखाएगा. ऐप्लिकेशन के कॉन्टेंट में दिखने वाले विज्ञापन शामिल नहीं होने चाहिए.

mraid.getCurrentPosition()

जब टू-पीस बड़ा किया जा सकने वाला विज्ञापन बड़ा किया जा रहा होता है, तो पहले हिस्से पर mraid.getCurrentPosition() को कॉल करने पर, स्क्रीन का साइज़ दिखेगा.

mraid.storePicture()

किसी ऐप्लिकेशन में mraid.storePicture() के साथ काम करने के लिए, आपको android.permission.WRITE_EXTERNAL_STORAGE की अनुमति शामिल करनी होगी.