SDK टूल के लिए सहायता और उसके साथ काम करने वाले डिवाइसों की समीक्षा करना

प्लैटफ़ॉर्म चुनें: HTML5 Android iOS tvOS Cast Roku

इस पेज पर, IMA DAI के साथ काम करने वाले ब्राउज़र, वीडियो फ़ॉर्मैट, और प्लैटफ़ॉर्म के बारे में सामान्य जानकारी दी गई है.

काम करने वाले वीडियो फ़ॉर्मैट और ब्राउज़र

HTML5 अब भी एक नया स्टैंडर्ड है और इसे लगातार बेहतर बनाया जा रहा है. इस वजह से, अलग-अलग ब्राउज़र पर अलग-अलग सुविधाएं काम करती हैं. साथ ही, ऐसा कोई डिफ़ॉल्ट वीडियो फ़ॉर्मैट नहीं है जो सभी मुख्य ब्राउज़र पर काम करता हो. ज़्यादातर ब्राउज़र में इस्तेमाल किए जाने वाले तीन मुख्य वीडियो फ़ॉर्मैट ये हैं: H.264, HLS, और Dash.

वीएएसटी इवेंट के साथ काम करने की सुविधा

इस सेक्शन में, VAST इवेंट की सूची दी गई है. VAST रिस्पॉन्स में मिली जानकारी के आधार पर, ये इवेंट सर्वर को अपने-आप रिपोर्ट किए जाते हैं.

पूरी तरह से काम करता है

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (जब वीडियो को पीछे की ओर तेज़ी से खोजा जाता है, तब यह इवेंट ट्रिगर होता है), start, thirdQuartile.

आंशिक रूप से समर्थित

  • click

    Click इवेंट सिर्फ़ वीडियो विज्ञापनों के लिए भेजा जाता है. Android, iOS या डेस्कटॉप पर मौजूद नेटिव फ़ुलस्क्रीन प्लेयर पर क्लिक को कैप्चर नहीं किया जा सकता. हालांकि, वीडियो बंद होने पर, पेज में मौजूद क्लिक ट्रैकिंग एलिमेंट से क्लिक को कैप्चर किया जा सकता है. हालांकि, अगर वीडियो एलिमेंट में iPad के नेटिव कंट्रोल का इस्तेमाल किया जाता है, तो क्लिक कैप्चर नहीं किए जा सकते.

  • fullscreen

    IMA, सिम्युलेटेड फ़ुल स्क्रीन मोड के साथ काम करता है. इसमें वीडियो, ब्राउज़र की पूरी विंडो पर दिखता है. IMA किसी वीडियो को फ़ुल स्क्रीन मोड में तब मानता है, जब उसके offsetWidth और offsetHeight, दस्तावेज़ के मुख्य हिस्से के साइज़ के बराबर हों. यह मोड सभी ब्राउज़र पर काम करता है.

    iPhone और Android 3.0 से पहले के वर्शन वाले प्लैटफ़ॉर्म पर, वीडियो हमेशा फ़ुल स्क्रीन मोड में चलता है.

  • mute, unmute

    iOS और Android में ही वॉल्यूम को कंट्रोल करने की सुविधा होती है. इसलिए, IMA न तो आवाज़ का लेवल तय कर सकता है और न ही म्यूट करने की स्थिति का पता लगा सकता है. साथ ही, एसडीके को बदलावों के बारे में सूचना भी नहीं दी जाती है. यहां उन ब्राउज़र वर्शन की सूची दी गई है जिन पर mute और unmute काम करते हैं और जिन पर काम नहीं करते:

    • इनके साथ काम करता है: Firefox 3.5+, Chrome 8+, Safari 4+
    • काम नहीं करता है: iOS, Android

वीएएसटी विज्ञापन दिखाने के बारे में ज़्यादा जानकारी के लिए, IAB के दिशा-निर्देश देखें.

विज्ञापन के लिए ब्रेक को फिर से देखने पर विज्ञापन इवेंट

IMA, इन वजहों से विज्ञापन फिर से देखने पर विज्ञापन इवेंट ट्रिगर नहीं करता:

  • इवेंट यूआरएल को सिर्फ़ एक बार ट्रिगर किया जाना चाहिए. ऐसा न करने पर, इसे स्पैम वाली गतिविधि माना जा सकता है.
  • इससे उपयोगकर्ता, विज्ञापन ब्रेक के दौरान और उसके आस-पास के कॉन्टेंट पर जा सकते हैं. इससे उन्हें बेहतर अनुभव मिलता है.

विज्ञापन ब्रेक को फिर से देखने पर, सिर्फ़ ये इवेंट ट्रिगर होते हैं:

  • AD_PERIOD_STARTED
  • AD_PERIOD_ENDED

वीडियो प्लेयर के लिए उपलब्ध प्लैटफ़ॉर्म

Google IMA SDK, इन प्लैटफ़ॉर्म पर काम करते हैं:

प्लैटफ़ॉर्म वर्शन
HTML5 डेस्कटॉप: Chrome, Firefox, Safari, Edge, Opera
मोबाइल: Chrome/Android Browser (Android for phones and tablets), Safari and Chrome (iOS)
iOS iOS 10.0 या इसके बाद के वर्शन
Android Android 4.4+
Google Cast सभी कास्ट डिवाइस
tvOS tvOS 15+
Roku ऐसे सभी डिवाइसों के लिए जिन पर अब भी Roku से सॉफ़्टवेयर अपडेट मिल रहे हैं

वीडियो स्ट्रीम के फ़ॉर्मैट के साथ काम करने की सुविधा

IMA, अपने सभी SDK में HLS और DASH, दोनों के साथ काम करता है. एसडीके के कुछ प्लैटफ़ॉर्म पर सहायता पाने के लिए, यह टेबल देखें. स्ट्रीम को सही तरीके से चलाने के लिए, आपके वीडियो प्लेयर में इस्तेमाल की जा रही स्ट्रीम टाइप की सुविधा होनी चाहिए.

IMA SDK प्लैटफ़ॉर्म एचएलएस DASH
HTML5 चेकमार्क चेकमार्क
iOS चेकमार्क Red-X
Android चेकमार्क चेकमार्क
Google Cast चेकमार्क चेकमार्क
tvOS चेकमार्क Red-X
Roku चेकमार्क चेकमार्क

वीडियो की सुविधाएं और एसडीके के वर्शन

इन सुविधाओं के बारे में ज़्यादा जानने के लिए, वीडियो विज्ञापन की खास जानकारी पढ़ें.

IAB Video Suite सहायता
VAST 4 चेतावनी 1
VAST 3 चेतावनी 2
VAST 2 चेकमार्क
VPAID 2 Red-X
VMAP 1.0.1 चेतावनी 3
Ad Manager की वीडियो सुविधाएं सहायता
लीनियर विज्ञापन चेकमार्क
नॉन-लीनियर विज्ञापन (ओवरले) Red-X
सहभागी चेतावनी 4
VAST 3 के वैकल्पिक कंपैनियन विज्ञापन संसाधन Red-X
ऐक्टिव व्यू की मदद से विज्ञापन दिखने से जुड़े आंकड़े चेकमार्क
वीएएसटी रीडायरेक्ट चेकमार्क
डिसप्ले विज्ञापन के अनुरोध के साथ कंपैनियन बैकफ़िल Red-X
Google पब्लिशर टैग (GPT) के साथ काम करना Red-X
कॉन्टेंट के बारे में जानकारी Red-X
विज्ञापन के नियम चेकमार्क
पॉडिंग चेकमार्क
बंपर चेकमार्क
मल्टी-इवेंट ट्रैकिंग (एमईटी) की रिपोर्टिंग चेकमार्क
स्किप किए जा सकने वाले विज्ञापन (रिज़र्वेशन / नॉन-TrueView) चेतावनी 5
AdSense for Video की सुविधाएं 7 सहायता
TrueView InStream चेतावनी 6
InStream Select चेकमार्क
स्टैंडर्ड इनस्ट्रीम चेकमार्क
फ़ुल-स्लॉट Red-X
सहभागी चेतावनी 4
कंपैनियन बैकफ़िल Red-X
ओवरले Red-X
Ad Manager Ad Exchange की सुविधाएं सहायता
TrueView InStream चेतावनी 6
InStream Select चेकमार्क
स्टैंडर्ड इनस्ट्रीम चेकमार्क
फ़ुल-स्लॉट Red-X
सहभागी चेतावनी 4
कंपैनियन बैकफ़िल Red-X
ओवरले Red-X
ऐक्टिव व्यू की मदद से विज्ञापन दिखने से जुड़े आंकड़े चेकमार्क
यह विज्ञापन क्यों? चेतावनी 8

1 Google Ad Manager के साथ काम करने वाली VAST 4 की सुविधाओं में से, IMA इन सुविधाओं के साथ काम करता है:

  • VAST 4.2
  • VAST 4.0
    • विज्ञापन आईडी
    • मेज़ानिन फ़ाइल
    • VAST से जुड़ी गड़बड़ी के नए कोड
    • नए वीएएसटी मैक्रो
    • AdVerifications सहायता

2 VAST 3.0 की ये सुविधाएं अभी काम नहीं करती हैं:

  • कंपैनियन adSlotId
  • कंपेनियन विज्ञापन डिलीवरी के विकल्प
  • आइकॉन

3 वीएमएपी की ये सुविधाएं अभी काम नहीं करती हैं:

  • वीएमएपी के हिसाब से ट्रैकिंग इवेंट
  • VMAP से जुड़ी गड़बड़ियों के कोड
  • ओवरले विज्ञापन
  • hh:mm:ss या "start" और "end" के अलावा अन्य टाइम ऑफ़सेट
  • डिसप्ले breakType एट्रिब्यूट
  • repeatAfter एट्रिब्यूट

4 सिर्फ़ इमेज वाले कंपैनियन विज्ञापन दिखाए जा सकते हैं. इमेज कंपैनियन विज्ञापनों को दिखाने के लिए, कस्टम तरीके से लागू करने की ज़रूरत होती है. tvOS पर, कंपैनियन विज्ञापनों का इस्तेमाल नहीं किया जा सकता.

5 स्किप किए जा सकने वाले पारंपरिक विज्ञापन, सिर्फ़ IMA DAI SDK के इन वर्शन के साथ काम करते हैं: HTML5, iOS, tvOS, Roku, और Android (इसमें Android TV भी शामिल है). Cast SDK की मदद से, आपको StreamRequest.senderCanSkip का इस्तेमाल करके, स्किप करने की सुविधा के बारे में बताना होगा, ताकि स्किप किए जा सकने वाले पारंपरिक विज्ञापनों को दिखाया जा सके.

6 TrueView स्किप किए जा सकने वाले विज्ञापन, IMA DAI SDK में काम करते हैं. ये SDK, HTML5, iOS, tvOS, Roku, और Android (Android TV भी शामिल है) के लिए उपलब्ध हैं.

7 AdSense सुविधाएं, Cast SDK में काम नहीं करती हैं.

8 यह विज्ञापन क्यों दिखाया जा रहा है? सुविधा के लिए, StreamManager बनाते समय adUiElement पैरामीटर को पास करना ज़रूरी है. Cast SDK में, यह विज्ञापन क्यों दिख रहा है? सुविधा काम नहीं करती.

JavaScript फ़्रेमवर्क के लिए चेतावनियां

IMA HTML5 SDK टूल के साथ JavaScript फ़्रेमवर्क, जैसे कि React या AngularJS का इस्तेमाल करते समय कुछ बातों का ध्यान रखना होता है. ये फ़्रेमवर्क, अक्सर डीओएम के एलिमेंट को मूव करते हैं. इससे IMA SDK काम नहीं करता, क्योंकि SDK को शुरू करते समय डीओएम के स्टैटिक होने की ज़रूरत होती है. IMA SDK, JavaScript फ़्रेमवर्क के साथ काम करता है. हालांकि, इसके लिए यह ज़रूरी है कि SDK को तब शुरू किया जाए, जब फ़्रेमवर्क DOM एलिमेंट को ट्रांसफ़र कर चुका हो. खास तौर पर, StreamManager बनाते समय adUiElement आर्ग्युमेंट के तौर पर पास किए गए HTML5 एलिमेंट को इंस्टैंटिएट करने के बाद, मूव नहीं किया जाना चाहिए.

Apple AirPlay की सुविधा

IMA SDK, Apple AirPlay के साथ काम नहीं करता. AirPlay का पता चलने पर, AirPlay या विज्ञापन अनुरोधों को बंद करें.