क्लास: AdDisplayContainer

google.ima.AdDisplayContainer

class static

यह क्लास, विज्ञापन दिखाने के कंटेनर का प्रतिनिधित्व करती है. SDK टूल, कंटेनर एलिमेंट पैरामीटर के अंदर अपने-आप स्ट्रक्चर बनाएगा, ताकि वीडियो और ओवरले विज्ञापन दिखाए जा सकें.

जब इस क्लास का कोई इंस्टेंस बनाया जाता है, तब यह componentsElement में एक IFRAME बनाता है और SDK टूल के कोर को लोड करता है. SDK टूल ठीक से काम कर सके, इसके लिए इस IFRAME को सुरक्षित रखें. जब सभी विज्ञापन चलाए जा चुके हों और SDK टूल की ज़रूरत न हो, तो SDK टूल को अनलोड करने के लिए destroy() तरीके का इस्तेमाल करें.

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

ध्यान दें: उपयोगकर्ता की कार्रवाई (जैसे कि क्लिक या टैप) से शुरू होने वाले कोड में, initialize() तरीके को कॉल करना हमेशा ज़रूरी होता है.

निर्माता

विज्ञापन प्रदर्शन कंटेनर

नया AdDisplayContainer(containerElement, videoElement, clickTrackingElement)

पैरामीटर
कंटेनर एलिमेंट	वह एलिमेंट जिसमें विज्ञापन दिखाने हैं. AdDisplayContainer बनाने से पहले, उस एलिमेंट को DOM में डाला जाना चाहिए. वैल्यू शून्य नहीं होनी चाहिए.
videoElement	ज़रूरी नहीं वीडियो विज्ञापन के दूसरे प्लेबैक एलिमेंट के बारे में बताता है. हमारा सुझाव है कि आप हमेशा अपने कॉन्टेंट के वीडियो प्लेयर को पास करें. वैल्यू शून्य नहीं होनी चाहिए.
clickTrackingElement	ज़रूरी नहीं इससे, वैकल्पिक वीडियो विज्ञापन पर क्लिक करने के एलिमेंट के बारे में पता चलता है. SDK टूल को क्लिक हैंडल करने की अनुमति देने के लिए, इस वैल्यू को शून्य पर सेट करें. भले ही, SDK टूल दिया गया हो, लेकिन कस्टम क्लिक ट्रैकिंग एलिमेंट का इस्तेमाल सिर्फ़ तब करेगा, जब गैर-AdSense या AdX क्रिएटिव, ऐसे प्लेयर में दिखाए गए हों जो वीडियो प्लेयर को ओवरले करने वाले यूज़र इंटरफ़ेस (यूआई) एलिमेंट के साथ काम नहीं करते. उदाहरण के लिए, iPhone या 4.0 से पहले का Android. पसंद के मुताबिक क्लिक ट्रैकिंग एलिमेंट को कभी भी वीडियो प्लेयर पर रेंडर नहीं किया जाना चाहिए, क्योंकि यह SDK टूल से रेंडर होने वाले यूज़र इंटरफ़ेस (यूआई) एलिमेंट पर होने वाले क्लिक को रोक सकता है. यह भी ध्यान रखें कि SDK टूल, कस्टम क्लिक ट्रैकिंग एलिमेंट के दिखने की सेटिंग में बदलाव नहीं करेगा. इसका मतलब यह है कि अगर कोई कस्टम क्लिक ट्रैकिंग एलिमेंट दिया गया है, तो उसे लीनियर विज्ञापन चलाते समय सही तरीके से दिखाया जाना चाहिए. आप ima.AdsManager.isCustomClickTrackingUse का इस्तेमाल करके ima.AdEvent.Type.STARTED इवेंट को चालू करके यह तय कर सकते हैं कि आपका कस्टम क्लिक ट्रैकिंग एलिमेंट दिखाया जाए या नहीं. अगर आपके यूज़र इंटरफ़ेस (यूआई) के लिए सही है, तो आपको ima.AdEvent.Type.CONTENT_RESUME_Request इवेंट के सक्रिय होने पर क्लिक ट्रैकिंग एलिमेंट को छिपाना चाहिए. वैल्यू शून्य नहीं होनी चाहिए.

तरीके

बंद करें

खत्म करें()

अंदरूनी स्थिति और पहले बनाए गए DOM एलिमेंट को खत्म करता है. IMA SDK अनलोड हो जाएगा और किसी भी एपीआई को कॉल नहीं किया जाएगा.

शुरू करें

इनिशियलाइज़ करें()

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

कुछ ब्राउज़र में, उपयोगकर्ता के इंटरैक्शन के बिना, वीडियो चलाने की सुविधा चालू हो जाती है. हालांकि, ऐसा तब होता है, जब वीडियो को म्यूट कर दिया गया हो. ऐसा करने के लिए, AdsRequest.setAdWillPlayMuted(true) का इस्तेमाल करें और AdsManager.start() से पहले इस तरीके से कॉल करें.