सहायता और साथ काम करना

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

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

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

इस्तेमाल किए जा सकने वाले वीडियो प्लेयर

IMA की ज़्यादातर सुविधाएं, सामान्य HTML5 वीडियो प्लेयर पर काम करती हैं. इनमें एचटीएमएल <video> टैग भी शामिल है. IMA SDK के साथ काम करने वाले वीडियो प्लेयर की सूची देखने के लिए, वीडियो टेक्नोलॉजी पार्टनर कार्यक्रम देखें.

VAST इवेंट के साथ काम करता है

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

पूरी तरह से काम करने वाला

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (पीछे की दिशा में कोई खास स्टेपिंग होने पर फ़ायर होता है), start, thirdQuartile.

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

  • click

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

  • fullscreen

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

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

  • mute और unmute

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

    • काम करता है: Firefox 3.5+, Chrome 8+, Safari 4+
    • मौजूद नहीं: iOS, Android

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

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

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

Apple AirPlay सहायता

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

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

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

प्लैटफ़ॉर्म वर्शन विज्ञापन का टाइप
HTML5 डेस्कटॉप: Chrome, Firefox, Safari, Edge, Opera
मोबाइल: Chrome/Android ब्राउज़र (फ़ोन और टैबलेट के लिए Android), Safari और Chrome (iOS)
लीनियर, नॉन-लीनियर, और साथ-साथ चलने वाले विज्ञापन, Ad Manager वीडियो सलूशन, Ad Exchange वीडियो, और AFV विज्ञापन
iOS iOS 10.0 और उसके बाद के वर्शन लीनियर और साथ-साथ चलने वाले विज्ञापन, Ad Manager वीडियो, Ad Exchange वीडियो, और AFV विज्ञापन
Android Android 4.4+ लीनियर और साथ-साथ चलने वाले विज्ञापन, Ad Manager वीडियो, Ad Exchange वीडियो, और AFV विज्ञापन
tvOS टीवीओएस 14 और उसके बाद वाले वर्शन लीनियर विज्ञापन, Ad Manager वीडियो, और Ad Exchange वीडियो

वीडियो से जुड़ी सुविधाएं और SDK टूल के वर्शन

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

HTML5 v3 iOS v3 Android वर्शन 3 tvOS
IAB वीडियो सुइट
VAST (वीडियो विज्ञापन देने के लिए टेम्प्लेट) 4 चेतावनी 9 चेतावनी 9 चेतावनी 9 चेतावनी 9
VAST 3 चेकमार्क चेतावनी 1 चेतावनी 1 चेतावनी 1
VAST 2 चेकमार्क चेकमार्क चेकमार्क चेकमार्क
सिमआईडी 1.0 चेकमार्क चेकमार्क चेकमार्क लाल-X
WRAP 2 (HTML5) चेकमार्क लाल-X लाल-X लाल-X
वीएमएपी 1.0.1 चेतावनी 2 3 चेतावनी 2 चेतावनी 2 चेतावनी 2
ओएम SDK 1.3 चेकमार्क चेकमार्क चेकमार्क लाल-X
Ad Manager वीडियो की सुविधाएं
लीनियर विज्ञापन चेकमार्क चेकमार्क चेकमार्क चेकमार्क
YouTube पर होस्ट की गई ऐसेट चेतावनी 4 लाल-X लाल-X लाल-X
नॉन-लीनियर विज्ञापन (ओवरले) चेतावनी 5 लाल-X लाल-X लाल-X
सहभागी चेकमार्क चेकमार्क चेकमार्क लाल-X
VAST 3 वैकल्पिक कंपैनियन विज्ञापन संसाधन चेकमार्क चेकमार्क लाल-X लाल-X
एक्टिव व्यू विज्ञापन दिखने से जुड़े आंकड़े चेकमार्क चेकमार्क चेकमार्क लाल-X
ऑडियो विज्ञापन चेकमार्क चेकमार्क चेकमार्क चेकमार्क
VAST रीडायरेक्ट चेकमार्क चेकमार्क चेकमार्क चेकमार्क
डिसप्ले अनुरोध के साथ साथी बैकफ़िल चेकमार्क चेकमार्क चेकमार्क लाल-X
Google पब्लिशर टैग (GPT) के साथ काम करता है चेकमार्क लाल-X लाल-X लाल-X
कॉन्टेंट जागरूकता चेकमार्क चेकमार्क चेकमार्क चेकमार्क
विज्ञापन के नियम चेतावनी 3 चेकमार्क चेकमार्क चेकमार्क
विज्ञापन के नियमों में मैन्युअल रूप से दिखाए जाने वाले विज्ञापन की जगह तय करना चेकमार्क लाल-X लाल-X लाल-X
फ़्रीक्वेंसी कैप 6 चेकमार्क चेकमार्क चेकमार्क चेकमार्क
बाहर रखे गए प्रतिस्पर्धी (स्ट्रीम) चेकमार्क चेकमार्क चेकमार्क चेकमार्क
प्रतिस्पर्धी एक्सक्लूज़न (पॉड) चेकमार्क चेकमार्क चेकमार्क चेकमार्क
बाहर रखे गए प्रतिस्पर्धी (पूरा पेज) चेकमार्क लाल-X लाल-X लाल-X
पोडिंग चेतावनी 3 चेकमार्क चेकमार्क चेकमार्क
बंपर विज्ञापन चेकमार्क चेकमार्क चेकमार्क चेकमार्क
कई इवेंट की ट्रैकिंग (MET) के बारे में रिपोर्टिंग चेकमार्क चेकमार्क चेकमार्क चेकमार्क
डाइनैमिक आवंटन (वीडियो के लिए AdSense, Ad Manager Ad Exchange) चेकमार्क चेकमार्क चेकमार्क चेकमार्क
स्किप किए जा सकने वाले (नॉन-TrueView) 8 चेतावनी 5 चेकमार्क चेकमार्क चेकमार्क
इन-स्ट्रीम चुनें चेकमार्क लाल-X लाल-X लाल-X
एसेट पहले से लोड करना चेतावनी 7 लाल-X चेकमार्क लाल-X
'वीडियो के लिए AdSense' की सुविधाएं
TrueView इनस्ट्रीम चेतावनी 5 चेकमार्क चेकमार्क लाल-X
इन-स्ट्रीम चुनें चेकमार्क चेकमार्क चेकमार्क लाल-X
मानक इनस्ट्रीम चेकमार्क चेकमार्क चेकमार्क चेकमार्क
फ़ुल-स्लॉट चेकमार्क लाल-X लाल-X लाल-X
सहभागी चेकमार्क चेकमार्क चेकमार्क लाल-X
कंपैनियन बैकफ़िल लाल-X चेकमार्क चेकमार्क लाल-X
ओवरले चेतावनी 5 लाल-X लाल-X लाल-X
एसेट पहले से लोड करना चेतावनी 7 लाल-X चेकमार्क लाल-X
Ad Manager Ad Exchange की सुविधाएं
TrueView इनस्ट्रीम चेतावनी 5 चेकमार्क चेकमार्क लाल-X
इन-स्ट्रीम चुनें चेकमार्क चेकमार्क चेकमार्क लाल-X
मानक इनस्ट्रीम चेकमार्क चेकमार्क चेकमार्क चेकमार्क
फ़ुल-स्लॉट चेकमार्क लाल-X लाल-X लाल-X
सहभागी चेकमार्क चेकमार्क चेकमार्क लाल-X
कंपैनियन बैकफ़िल लाल-X चेकमार्क चेकमार्क लाल-X
ओवरले चेतावनी 5 लाल-X लाल-X लाल-X
एक्टिव व्यू विज्ञापन दिखने से जुड़े आंकड़े चेकमार्क चेकमार्क चेकमार्क लाल-X
एसेट पहले से लोड करना चेतावनी 7 लाल-X चेकमार्क लाल-X
यह विज्ञापन क्यों? चेकमार्क चेकमार्क चेकमार्क चेकमार्क

1 नीचे दी गई VAST 3.0 सुविधाएं, अभी तक बिना HTML5 SDK टूल में काम नहीं करतीं:

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

2 नीचे दी गई VMAP सुविधाएं अभी तक काम नहीं करतीं:

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

3 iPhone पर VMAP और विज्ञापन नियमों के काम करने के लिए, पसंद के मुताबिक विज्ञापन चलाना ज़रूरी है.

4 YouTube पर होस्ट किए गए क्रिएटिव, डेस्कटॉप पर काम करते हैं, मोबाइल वेब पर नहीं.

5 अगर playsinline का इस्तेमाल किया गया है , तो नॉन-लीनियर विज्ञापन (ओवरले), स्किप किए जा सकने वाले (नॉन-TrueView), और TrueView इन-स्ट्रीम विज्ञापन, iOS 10+ पर HTML5 मोबाइल वेब पर काम करते हैं.

6 विज्ञापन के नियमों के लिए, फ़्रीक्वेंसी कैप और बाहर रखे गए प्लेसमेंट के लिए कुकी या पीपीआईडी की ज़रूरत होती है.

7 नेटिव एसेट पहले से लोड करने की सुविधा इनके साथ काम नहीं करती:

  • iOS डिवाइसों पर मोबाइल वेब
  • Android pre-4.0 पर मोबाइल वेब
  • TrueView फ़ॉर्मैट के साथ, YouTube पर होस्ट किए गए विज्ञापन
  • IMA मैन्युअल ब्रेक के वीडियो को चलाने की सुविधा (कोई भी ऐसा लागू जो AD_BREAK_READY इवेंट पर निर्भर करता है)

8 SDK टूल में, स्किप किए जा सकने वाले ऐसे विज्ञापन इस्तेमाल नहीं किए जा सकते जो आठ सेकंड से कम लंबे होते हैं. तय की गई कम से कम अवधि से छोटे विज्ञापन चलाने पर, अभी नहीं बटन नहीं दिखता.

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