google. इमेज. AdsRequest
क्लास, जिसमें विज्ञापन अनुरोध की प्रॉपर्टी की जानकारी दी जाती है.
निर्माता
विज्ञापन अनुरोध
नया AdsRequest()
- लागू करना
- google.ima.AdsRequestInterface
प्रॉपर्टी
adTagUrl
स्ट्रिंग
उस विज्ञापन टैग के यूआरएल के बारे में बताता है जिसका अनुरोध विज्ञापन सर्वर से किया गया है. विज्ञापन टैग का यूआरएल बनाने की जानकारी पाने के लिए, मैन्युअल तरीके से मुख्य विज्ञापन वीडियो टैग बनाना देखें.
यह पैरामीटर ज़रूरी है.
adsResponse
(शून्य, स्ट्रिंग या गैर-शून्य दस्तावेज़)
इससे, विज्ञापन टैग के यूआरएल के ज़रिए अनुरोध करने के बजाय, विज्ञापन के रिस्पॉन्स के तौर पर इस्तेमाल करने के लिए, VAST 2.0 दस्तावेज़ के बारे में पता चलता है. यह डीबग करने में मददगार हो सकता है. साथ ही, यह ऐसी स्थितियों में भी मददगार हो सकता है जहां VAST से जुड़ा जवाब पहले से उपलब्ध हो.
यह पैरामीटर ज़रूरी नहीं है.
कॉन्टेंट का कुल समय
(शून्य या संख्या)
सेकंड में दिखाए जाने वाले कॉन्टेंट की अवधि के बारे में बताता है. इसका इस्तेमाल दो मामलों में किया जाता है: 1) AdX विज्ञापन टारगेटिंग और 2) तय करना कि VMAP पोस्टरोल को पहले से लोड कब करना है.
यह पैरामीटर ज़रूरी नहीं है.
कॉन्टेंट कीवर्ड
(स्ट्रिंग का शून्य या शून्य शून्य)
यह उन कीवर्ड की जानकारी देता है जिनका इस्तेमाल करके दिखाए जाने वाले कॉन्टेंट के बारे में बताया जाता है. AdX अनुरोधों में इस्तेमाल किया गया है.
यह पैरामीटर ज़रूरी नहीं है.
कॉन्टेंट का शीर्षक
(शून्य या स्ट्रिंग)
इससे, दिखाए जाने वाले कॉन्टेंट के शीर्षक के बारे में पता चलता है. AdX अनुरोधों में इस्तेमाल किया गया.
यह पैरामीटर ज़रूरी नहीं है.
forceनॉनलीनियरफ़ुलस्लॉट
बूलियन
गैर-लीनियर AdSense विज्ञापनों को लीनियर फ़ुल स्लॉट के रूप में रेंडर करने के लिए मजबूर करता है. अगर इस नीति को सेट किया जाता है, तो कॉन्टेंट वीडियो को रोक दिया जाएगा और बिना टेक्स्ट वाले टेक्स्ट या इमेज वाले विज्ञापन को फ़ुल स्लॉट के तौर पर रेंडर किया जाएगा. विज्ञापन के छोड़े जाने या बंद हो जाने पर, वीडियो का कॉन्टेंट फिर से शुरू हो जाएगा.
LineAdAdSlotHeight
नंबर
आयताकार क्षेत्र की ऊंचाई के बारे में बताता है, जिसमें एक लीनियर विज्ञापन दिखाया जाता है. इस वैल्यू का इस्तेमाल, विज्ञापन चुनने की शर्त में से एक के तौर पर किया जाता है. इस मान का विज्ञापन की ऊंचाई से मेल खाना ज़रूरी नहीं है.
यह पैरामीटर ज़रूरी है.
LineAdAdSlotWidth
नंबर
आयताकार जगह की चौड़ाई तय करता है, जिसमें एक लीनियर विज्ञापन दिखाया जाता है. इस वैल्यू का इस्तेमाल, विज्ञापन चुनने की शर्त में से एक के तौर पर किया जाता है. इस मान का विज्ञापन की चौड़ाई से मेल खाना ज़रूरी नहीं है.
यह पैरामीटर ज़रूरी है.
लाइवस्ट्रीम लाइव-प्री-सेकंड
नंबर
इससे यह तय होता है कि विज्ञापन टैग के यूआरएल का अनुरोध करने से पहले, कितने सेकंड तक इंतज़ार करना होगा. इसका इस्तेमाल, लाइव स्ट्रीम इवेंट के दौरान, बहुत ज़्यादा अनुरोधों को रोकने के लिए किया जा सकता है. इससे, अनुरोधों की संख्या में बढ़ोतरी को कम किया जा सकता है.
nonLinearAdSlotHeight
नंबर
आयताकार जगह की ऊंचाई के बारे में बताता है, जिसमें एक नॉन-लीनियर विज्ञापन दिखाया जाता है. इस वैल्यू का इस्तेमाल, विज्ञापनों को चुनने की एक शर्त के तौर पर किया जाता है. इस मान का विज्ञापन की ऊंचाई से मेल खाना ज़रूरी नहीं है.
यह पैरामीटर ज़रूरी है.
nonLinearAdSlotWidth
नंबर
आयताकार क्षेत्र की चौड़ाई तय करता है, जिसमें एक नॉन-लीनियर विज्ञापन दिखाया जाता है. इस वैल्यू का इस्तेमाल, विज्ञापनों को चुनने की एक शर्त के तौर पर किया जाता है. इस मान का विज्ञापन की चौड़ाई से मेल खाना ज़रूरी नहीं है.
यह पैरामीटर ज़रूरी है.
omidAccessModeRules
स्ट्रिंग प्रॉपर्टी के साथ शून्य नहीं है
OMID ऐक्सेस मोड में पुष्टि करने वाले वेंडर को मैप करने के लिए सेटिंग ऑब्जेक्ट. कुंजियां, google.ima.OmidVerifyविक्रेता की वैल्यू होनी चाहिए और वैल्यू google.ima.OmidAccessMode में होनी चाहिए.
पुष्टि करने वाली स्क्रिप्ट के यूआरएल, अंदरूनी तौर पर वेंडर से मैच किए जाते हैं. ऐसा इसलिए किया जाता है, ताकि Omidपुष्टिविक्रेता की कुंजी का समाधान करने के लिए, रेगुलर एक्सप्रेशन का इस्तेमाल किया जा सके. इसके बाद, IMA, इस ऑब्जेक्ट का इस्तेमाल करके, दिए गए वेंडर के लिए ऐक्सेस मोड को खोजता है.
अगर किसी स्क्रिप्ट का कोई जानी-पहचानी कंपनी नहीं है, तो स्क्रिप्ट यूआरएल के लिए या फिर इस ऑब्जेक्ट में OmidVerifyविक्रेता के मुहैया नहीं कराए गए टेंप्लेट के लिए, IMA कोड, OmidVerifyविक्रेता के लिए दिए गए ऐक्सेस मोड का इस्तेमाल करेगा.OTHER. अगर OmidVerifySeller.OTHER नहीं दिया गया है, तो सीमित ऐक्सेस वाला मोड इस्तेमाल किया जाएगा.
pageUrl
(शून्य या स्ट्रिंग)
इससे उस पेज का पूरा यूआरएल पता चलता है जिसे टारगेटिंग के लिए, Google विज्ञापन अनुरोध में शामिल किया जाएगा. यूआरएल एक मान्य यूआरएल होना चाहिए. अगर बताया गया हो, तो [PAGEURL] VAST मैक्रो के लिए इस वैल्यू का इस्तेमाल किया जाएगा.
यह पैरामीटर ज़रूरी नहीं है.
VASTLoadTimeout
नंबर
एक रैपर के लिए मिलीसेकंड में डिफ़ॉल्ट VAST लोड टाइम आउट के लिए ओवरराइड करें. टाइम आउट की डिफ़ॉल्ट अवधि 5000 मि॰से॰ है.
यह पैरामीटर ज़रूरी नहीं है.
तरीके
विज्ञापन दिखाया गया ऑटोप्ले खेलें
setAd WillAutoPlay(autoPlay) से जुड़े नतीजे नहीं दिखाए जाते
SDK टूल को यह बताता है कि प्लेयर, उपयोगकर्ता की कार्रवाई के जवाब में कॉन्टेंट और विज्ञापन को शुरू करने का इरादा है या नहीं या यह अपने-आप चलेगा या नहीं. इस सेटिंग को बदलने से, विज्ञापन चलाने की सुविधा पर कोई असर नहीं पड़ेगा.
पैरामीटर |
|
---|---|
ऑटोप्ले |
बूलियन क्या वीडियो और विज्ञापन अपने-आप चलने लगेगा या यह उपयोगकर्ता की कार्रवाई से शुरू होगा या नहीं. |
- एक्सप्रेशन से मिलने वाला नतीजा
-
void
setAd WillPlayम्यूट किया गया
setAd WillPlayम्यूट किया गया(म्यूट किया गया) रिटर्न मौजूद नहीं है
SDK टूल को यह बताता है कि म्यूट किए जाने के दौरान प्लेयर विज्ञापन दिखाना चाहता है या नहीं. इस सेटिंग को बदलने से, विज्ञापन प्लेबैक पर कोई असर नहीं पड़ेगा. हालांकि, इससे विज्ञापन अनुरोध में सही सिग्नल भेजा जाएगा, ताकि खरीदार म्यूट की गई इन्वेंट्री पर बोली लगा सकें.
पैरामीटर |
|
---|---|
म्यूट किया गया |
बूलियन म्यूट होने पर विज्ञापन दिखाया जाएगा या नहीं. |
- एक्सप्रेशन से मिलने वाला नतीजा
-
void
setContinuePlayback सेट करना
setcompletePlayback(continusPlayback) से मिलने वाले रिटर्न की कोई वैल्यू नहीं है
इससे, SDK टूल को यह पता चलता है कि प्लेयर, टीवी ब्रॉडकास्ट के बाद एक-दूसरे से कॉन्टेंट वाले वीडियो लगातार चलाना चाहता है या नहीं. इस सेटिंग में बदलाव करने से विज्ञापन चलाने पर कोई असर नहीं पड़ेगा. हालांकि, इससे विज्ञापन अनुरोध में सही सिग्नल भेजा जाएगा, ताकि खरीदार विज्ञापन इन्वेंट्री के टाइप पर बोली लगा सकें.
पैरामीटर |
|
---|---|
continuousPlayback |
बूलियन कॉन्टेंट वाला वीडियो, एक के बाद एक लगातार चलाया जाता है या नहीं. |
- एक्सप्रेशन से मिलने वाला नतीजा
-
void