google. आईएमए
google.ima
नेमस्पेस, SDK टूल की क्लास, इंटरफ़ेस, गिनती, और प्रॉपर्टी का ऐक्सेस देता है.
क्लास
विज्ञापन
ऐसी विज्ञापन क्लास जो अलग-अलग तरह के विज्ञापनों को दिखाने वाली क्लास के ज़रिए बढ़ाई जाती है.
AdCuePoints
क्यू पॉइंट सूची विज्ञापन ब्रेक के समय का शेड्यूल दिखाती है. ध्यान दें कि विज्ञापन ब्रेक में, अलग-अलग विज्ञापनों को शेड्यूल में शामिल नहीं किया जाता है.
AdDisplayContainer
यह क्लास, विज्ञापन दिखाने वाले कंटेनर को दिखाती है. वीडियो और ओवरले विज्ञापनों को रखने के लिए, SDK टूल ContainerElement पैरामीटर के अंदर अपने आप स्ट्रक्चर बनाएगा.
जब इस क्लास का कोई इंस्टेंस बनाया जाता है, तो
कंटेनर एलिमेंट में एक IFRAME बन जाता है और SDK टूल लोड होता है. SDK टूल ठीक से काम कर सके, इसके लिए इस IFRAME को सुरक्षित रखना चाहिए. सभी विज्ञापनों के चलने और
SDK टूल की ज़रूरत न होने पर, SDK टूल को अनलोड करने के लिए
destroy()
तरीके का इस्तेमाल करें.
CONTAINERElement पैरामीटर, ऐसा एलिमेंट होना चाहिए जो DOM का हिस्सा हो. विज्ञापनों को सही तरीके से दिखाने के लिए, ContainerElement को सही तरीके से रखना ज़रूरी है. हमारा सुझाव है कि आप इसे कॉन्टेंट वीडियो प्लेयर के ऊपर रखें और पूरे वीडियो प्लेयर को कवर करने के लिए इसका साइज़ बदलें. लागू करने के सुझाए गए तरीकों के बारे में जानने के लिए, SDK टूल के दस्तावेज़ देखें.
ध्यान दें: कोड में initialize()
तरीके को कॉल करना हमेशा ज़रूरी होता है जिसे उपयोगकर्ता की कार्रवाई (जैसे कि क्लिक या टैप) से सीधे तौर पर शुरू किया गया हो.
विज्ञापन से जुड़ी गड़बड़ी
गड़बड़ी की जानकारी से उपयोगकर्ता को यह पता चलता है कि विज्ञापन लोड होने या उसे चलाने के दौरान कोई गड़बड़ी हुई है या नहीं. errorType ऐक्सेसर इस बारे में जानकारी देता है कि विज्ञापन लोड करते समय या विज्ञापन चलने के दौरान गड़बड़ी हुई या नहीं.
AdErrorEvent
जब Google या DoubleClick सर्वर से विज्ञापन लोड करते समय कोई गड़बड़ी होती है, तब यह इवेंट बढ़ जाता है. इवेंट लोड करने के लिए, AdsLoader और AdsManager में इस्तेमाल किए जा सकते हैं.
विज्ञापन इवेंट
इस तरह के इवेंट को विज्ञापन तब दिखाता है, जब विज्ञापन की स्थिति में बदलाव होता है और जब उपयोगकर्ता विज्ञापन से इंटरैक्ट करते हैं. उदाहरण के लिए, जब विज्ञापन चलना शुरू होता है, तो उस पर क्लिक वगैरह किया जाता है. Ads Manager पर, स्थिति में बदलाव करने वाले अलग-अलग इवेंट के लिए रजिस्टर किया जा सकता है.
Adमेटाडेटाइवेंट
यह क्लास अब काम नहीं करती. AdsManager.getCuePoints() एपीआई का इस्तेमाल करें. मेटाडेटा वाला खास विज्ञापन इवेंट.
AdPodInfo
कोई विज्ञापन, विज्ञापनों के पॉड का हिस्सा हो सकता है. यह ऑब्जेक्ट उस पॉड से जुड़ा मेटाडेटा दिखाता है, जैसे कि पॉड में विज्ञापनों की संख्या और पॉड के अंदर विज्ञापन की स्थिति.
इस ऑब्जेक्ट में शामिल getTotalAds
एपीआई अक्सर सही होता है. हालांकि, कुछ मामलों में यह SDK टूल के सबसे सही अनुमान के बारे में बताता है. ज़्यादा जानकारी के लिए,
उस तरीके का दस्तावेज़ देखें.
AdProgressData
यह ऑब्जेक्ट, विज्ञापन दिखाए जाने की मौजूदा स्थिति की जानकारी दिखाता है.
AdsLoader
AdsLoader, क्लाइंट को विज्ञापन सर्वर से विज्ञापनों का अनुरोध करने की अनुमति देता है. ऐसा करने के लिए, उपयोगकर्ताओं को AdsManagerLoadedEvent इवेंट के लिए रजिस्टर करना होगा और फिर विज्ञापनों का अनुरोध करना होगा.
AdsManager
पब्लिशर को आउटर पब्लिक एपीआई देता है और विज्ञापन मैनेजर के अंदरूनी इंस्टेंस से संपर्क करता है.
AdsManagerLoadedEvent
यह इवेंट तब बढ़ता है, जब Google या DoubleClick विज्ञापन सर्वर से किसी AdsLoader के ज़रिए विज्ञापन लोड हो जाते हैं. इस इवेंट के लिए, AdsLoader पर रजिस्टर किया जा सकता है.
विज्ञापन रेंडरिंग की सेटिंग
उन पैरामीटर के बारे में बताता है जो विज्ञापनों की रेंडरिंग को कंट्रोल करते हैं.
विज्ञापन अनुरोध
क्लास, जिसमें विज्ञापन अनुरोध की प्रॉपर्टी की जानकारी दी जाती है.
कंपैनियन विज्ञापन
कंपैनियन मोड वाला विज्ञापन दिखाता है.
CompanionAdSelectionसेटिंग
CompanionAdSelectionSettings ऑब्जेक्ट का इस्तेमाल ima.Ad.getCompanionAds फ़ंक्शन को कॉल करते समय, चुनने की शर्त तय करने के लिए किया जाता है.
ImaSdkSettings
इस कक्षा में, पूरे SDK टूल की सेटिंग शामिल हैं.
UniversalAdIdInfo
यह ऑब्जेक्ट, विज्ञापन से जुड़े यूनिवर्सल विज्ञापन आईडी की जानकारी दिखाता है. इसमें विज्ञापन आईडी वैल्यू और विज्ञापन आईडी रजिस्ट्री भी शामिल हैं.
गिनती
OmidAccessMode
स्ट्रिंग
वेब के लिए OMID के लिए उपलब्ध ऐक्सेस मोड, जो यह कंट्रोल करते हैं कि पुष्टि करने वाली स्क्रिप्ट कितनी फ़ाइल ऐक्सेस कर सकती है.
वैल्यू |
|
---|---|
सीमित |
पुष्टि करने की स्क्रिप्ट को सैंडबॉक्स किया गया हो. साथ ही, यह क्रिएटिव या पब्लिशर के पेज को ऐक्सेस नहीं कर सकता. साथ ही, इस बात की सीधे तौर पर पुष्टि नहीं कर सकता कि यह किस पब्लिशर डोमेन पर है. |
डोमेन |
पुष्टि स्क्रिप्ट को सैंडबॉक्स किया गया है और यह क्रिएटिव या पब्लिशर पेज को ऐक्सेस नहीं कर सकती. हालांकि, स्क्रिप्ट को इस तरह लोड किया जाता है कि वह सीधे पब्लिशर के डोमेन की पुष्टि कर सके. |
फ़ुल |
पुष्टि स्क्रिप्ट के पास क्रिएटिव और पब्लिशर पेज का सीधा ऐक्सेस होता है. |
Omid(पुष्टि करने वाला) वेंडर
नंबर
OMID पुष्टि करने वाले वेंडर की पहचान करता है. वेंडर को अंग्रेज़ी वर्णमाला के क्रम में लगाया गया है.
वैल्यू |
|
---|---|
स्कोर |
|
डबल-पुष्टि करें |
|
|
|
इंटीग्रल_AD_SCIENCE |
|
Meet ऐप्लिकेशन |
|
MOAT |
|
नीलसेन |
|
पिक्सलेट |
|
अन्य |
जब डिफ़ॉल्ट रूप से, स्क्रिप्ट का यूआरएल किसी दूसरे वेंडर से मेल नहीं खाता, तो इसका इस्तेमाल किया जा सकता है. |
UiElements
स्ट्रिंग
ऐसे अलग-अलग यूज़र इंटरफ़ेस (यूआई) एलिमेंट की जानकारी देना जिन्हें कॉन्फ़िगर करने या दिखाने के लिए कॉन्फ़िगर किया जा सकता है. AdSense और ADX विज्ञापनों के लिए, इन सेटिंग को अनदेखा किया जा सकता है.
वैल्यू |
|
---|---|
विज्ञापन से जुड़ी जानकारी |
विज्ञापन यूज़र इंटरफ़ेस (यूआई) में "विज्ञापन" टेक्स्ट दिखाता है. काउंटडाउन टाइमर दिखाने के लिए मौजूद होना ज़रूरी है. |
COUNTDOWN |
काउंटडाउन टाइमर दिखाने के लिए, विज्ञापन एट्रिब्यूशन ज़रूरी है. |
व्यू मोड
स्ट्रिंग
Enum, विज्ञापनों के लिए VPAID के अलग-अलग व्यू मोड के बारे में बताती है.
वैल्यू |
|
---|---|
सामान्य |
सामान्य विज्ञापन दृश्य मोड. |
फ़ुलस्क्रीन |
फ़ुलस्क्रीन विज्ञापन व्यू मोड. इससे विज्ञापन मैनेजर को पता चलता है कि पब्लिशर, AdDisplayContainer के मौजूदा क्रम को फ़ुलस्क्रीन के तौर पर देखता है. उदाहरण के लिए, सिम्युलेट किया गया फ़ुलस्क्रीन. इससे, विज्ञापन मैनेजर फ़ुलस्क्रीन में नहीं जाता. |
- बहिष्कृत
प्रॉपर्टी
OmidAccessMode
स्ट्रिंग
वेब के लिए OMID के लिए उपलब्ध ऐक्सेस मोड, जो यह कंट्रोल करते हैं कि पुष्टि करने वाली स्क्रिप्ट कितनी फ़ाइल ऐक्सेस कर सकती है.
वैल्यू |
|
---|---|
सीमित |
पुष्टि करने की स्क्रिप्ट को सैंडबॉक्स किया गया हो. साथ ही, यह क्रिएटिव या पब्लिशर के पेज को ऐक्सेस नहीं कर सकता. साथ ही, इस बात की सीधे तौर पर पुष्टि नहीं कर सकता कि यह किस पब्लिशर डोमेन पर है. |
डोमेन |
पुष्टि स्क्रिप्ट को सैंडबॉक्स किया गया है और यह क्रिएटिव या पब्लिशर पेज को ऐक्सेस नहीं कर सकती. हालांकि, स्क्रिप्ट को इस तरह लोड किया जाता है कि वह सीधे पब्लिशर के डोमेन की पुष्टि कर सके. |
फ़ुल |
पुष्टि स्क्रिप्ट के पास क्रिएटिव और पब्लिशर पेज का सीधा ऐक्सेस होता है. |
Omid(पुष्टि करने वाला) वेंडर
नंबर
OMID पुष्टि करने वाले वेंडर की पहचान करता है. वेंडर को अंग्रेज़ी वर्णमाला के क्रम में लगाया गया है.
वैल्यू |
|
---|---|
स्कोर |
|
डबल-पुष्टि करें |
|
|
|
इंटीग्रल_AD_SCIENCE |
|
Meet ऐप्लिकेशन |
|
MOAT |
|
नीलसेन |
|
पिक्सलेट |
|
अन्य |
जब डिफ़ॉल्ट रूप से, स्क्रिप्ट का यूआरएल किसी दूसरे वेंडर से मेल नहीं खाता, तो इसका इस्तेमाल किया जा सकता है. |
UiElements
स्ट्रिंग
ऐसे अलग-अलग यूज़र इंटरफ़ेस (यूआई) एलिमेंट की जानकारी देना जिन्हें कॉन्फ़िगर करने या दिखाने के लिए कॉन्फ़िगर किया जा सकता है. AdSense और ADX विज्ञापनों के लिए, इन सेटिंग को अनदेखा किया जा सकता है.
वैल्यू |
|
---|---|
विज्ञापन से जुड़ी जानकारी |
विज्ञापन यूज़र इंटरफ़ेस (यूआई) में "विज्ञापन" टेक्स्ट दिखाता है. काउंटडाउन टाइमर दिखाने के लिए मौजूद होना ज़रूरी है. |
COUNTDOWN |
काउंटडाउन टाइमर दिखाने के लिए, विज्ञापन एट्रिब्यूशन ज़रूरी है. |
व्यू मोड
स्ट्रिंग
Enum, विज्ञापनों के लिए VPAID के अलग-अलग व्यू मोड के बारे में बताती है.
वैल्यू |
|
---|---|
सामान्य |
सामान्य विज्ञापन दृश्य मोड. |
फ़ुलस्क्रीन |
फ़ुलस्क्रीन विज्ञापन व्यू मोड. इससे विज्ञापन मैनेजर को पता चलता है कि पब्लिशर, AdDisplayContainer के मौजूदा क्रम को फ़ुलस्क्रीन के तौर पर देखता है. उदाहरण के लिए, सिम्युलेट किया गया फ़ुलस्क्रीन. इससे, विज्ञापन मैनेजर फ़ुलस्क्रीन में नहीं जाता. |
- बहिष्कृत
सेटिंग
गैर-शून्य ImaSdkSettings
ग्लोबल सिंगलटन सेटिंग इंस्टेंस.