रेफ़रंस

पैरामीटर

पेज लेवल के पैरामीटर की जानकारी

आपको हर पेज में सिर्फ़ एक बार ये पैरामीटर डालने होंगे. इनका असर पेज की सभी यूनिट पर होता है.

ज़रूरी है

पैरामीटर ब्यौरा और उदाहरण
adPage यह तब ज़रूरी होता है, जब उपयोगकर्ता नतीजों वाले अगले या पिछले पेज पर जाता है.

adPage पैरामीटर से नतीजों के उस पेज की जानकारी मिलती है जिस पर विज्ञापन दिखाए जा रहे हैं. इस पैरामीटर का इस्तेमाल तब किया जाता है, जब उपयोगकर्ता खोज के नतीजों के पहले पेज से आगे बढ़ते हैं. उदाहरण के लिए, अगर पांच विज्ञापनों का अनुरोध किया जाता है और adPage पैरामीटर को 2 पर सेट किया गया है, तो दिखाए गए विज्ञापन, पांच विज्ञापनों वाले सेट के दूसरे पेज पर मौजूद होंगे.

pubId ज़रूरी है
यह आपका AdSense Client-ID है. आपका pubId, Client-ID का हिस्सा होता है. यह 'partner-' के बाद आता है. उदाहरण के लिए, अगर आपका Client-ID 'partner-test-property' है, तो आपका pubId, 'test-property' है. यह सीएसए के लिए स्टैंडर्ड प्रोटोकॉल है.

उदाहरण:

'pubId' : 'test-property'
query कॉन्टेंट पेजों पर मिलती-जुलती खोज की सुविधा के लिए, यह ज़रूरी नहीं है.
यह सर्च क्वेरी उपयोगकर्ता की तरफ़ से डाली गई है. क्वेरी पैरामीटर की वैल्यू को कोड में नहीं बदला जाना चाहिए.

ध्यान दें: कॉन्टेंट वाले पेजों पर मिलती-जुलती खोज के लिए इस पैरामीटर का इस्तेमाल करने पर, अनचाहे नतीजे दिख सकते हैं.

उदाहरण:

'query' : 'flowers'
'query' : 'black & decker'
'query' : myQuery // myQuery is a variable containing the search query
resultsPageBaseUrl इसकी तब ज़रूरत होती है, जब पेज पर मिलती-जुलती खोज यूनिट हों.
इससे खोज नतीजों के उस पेज के यूआरएल का पता चलता है जहां सर्च क्वेरी, वह मिलता-जुलता शब्द है जिस पर उपयोगकर्ता ने क्लिक किया है. resultsPageBaseUrl में इसके खुद के पैरामीटर शामिल हो सकते हैं. हालांकि, इसमें सर्च क्वेरी शामिल नहीं होगी. यह अपने-आप जुड़ जाएगी.

उदाहरण:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
relatedSearchTargeting इसकी तब ज़रूरत होती है, जब पेज पर मिलती-जुलती खोज यूनिट हों.
मिलती-जुलती खोज यूनिट का अनुरोध करने पर, इस पैरामीटर को शामिल करना ज़रूरी है. यह कुकी, पेज के कॉन्टेक्स्ट के आधार पर यह कंट्रोल करती है कि मिलती-जुलती खोज के नतीजे किस तरह से दिखाए जाएं:
  • 'content' इस विकल्प का इस्तेमाल, कॉन्टेंट वाले पेजों (जैसे कि लेख, ब्लॉग पोस्ट) पर मिलती-जुलती खोज के लिए करें.
  • 'query' इस विकल्प का इस्तेमाल, खोज नतीजों के पेजों पर मिलती-जुलती खोज के लिए सिर्फ़ करें.

ध्यान दें:relatedSearchTargeting पेज पैरामीटर की वैल्यू, डिफ़ॉल्ट रूप से 'query' पर सेट होती है. हालांकि, यह ध्यान रखना ज़रूरी है कि यह डिफ़ॉल्ट वैल्यू, खोज के नतीजों वाले पेजों के लिए ही डिज़ाइन की गई है (Search पर मिलती-जुलती खोज). अगर किसी दूसरे तरह के पेज (जैसे, लेख, ब्लॉग पोस्ट) पर मिलती-जुलती खोज का इस्तेमाल किया जा रहा है, तो आपको पैरामीटर को 'content' पर सेट करना होगा.

ध्यान दें: इस पैरामीटर का इस्तेमाल करने के लिए, यहां दिए गए दिशा-निर्देश लागू होते हैं:

  • इस पेज पैरामीटर की वैल्यू के आधार पर, मिलती-जुलती खोज की कुछ सुविधाएं चालू या बंद की जा सकती हैं.
  • पेज के टाइप के बारे में गलत जानकारी देना या खोज नतीजों के अलावा अन्य पेजों पर relatedSearchTargeting पैरामीटर के लिए डिफ़ॉल्ट 'query' सेटिंग का इस्तेमाल करना, इन निर्देशों का उल्लंघन माना जाता है.
  • Google समय-समय पर इस वैल्यू की पुष्टि कर सकता है. भले ही, इसे मैन्युअल तरीके से सेट किया गया हो या डिफ़ॉल्ट वैल्यू का इस्तेमाल करके सेट किया गया हो.

उदाहरण:

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
styleId ज़रूरी है
इससे पसंद के मुताबिक सर्च स्टाइल के उस आईडी का पता चलता है जो पेज पर मौजूद विज्ञापन या मिलती-जुलती खोज यूनिट पर लागू होता है. कस्टम सर्च स्टाइल इस्तेमाल करने के बारे में ज़्यादा जानें. ध्यान दें कि किसी अनुरोध के लिए styleId सेट किए जाने पर, विज्ञापन या मिलती-जुलती खोजें, नए स्टाइल के साथ रेंडर होंगी. पुराने स्टाइल पैरामीटर को अनदेखा कर दिया जाएगा. अगर अनुरोध में styleId का ज़िक्र नहीं है, तो सिस्टम डिफ़ॉल्ट स्टाइल रेंडर की जाएगी.

उदाहरण:

'styleId': '1234567890'

वैकल्पिक

पैरामीटर ब्यौरा और उदाहरण
linkTarget ज़रूरी नहीं
इससे पता चलता है कि किसी विज्ञापन पर क्लिक करने से वह पुरानी विंडो में खुलेगा या नई विंडो में. डिफ़ॉल्ट वैल्यू '_top' होती है. इस पैरामीटर का इस्तेमाल यूनिट लेवल पर भी किया जा सकता है.
  • '_top' इसी विंडो में खुलता है.
  • '_blank' नई विंडो में खुलता है.

उदाहरण:

'linkTarget' : '_blank'
referrerAdCreative ज़रूरी नहीं
अगर कोई उपयोगकर्ता किसी दूसरी वेबसाइट पर दिए गए लिंक या विज्ञापन (जिस पर आपका कंट्रोल है) पर क्लिक करके, आपके उस कॉन्टेंट पेज पर जाता है जिसमें कॉन्टेंट यूनिट के लिए मिलती-जुलती खोज मौजूद है, तो यह पैरामीटर उस विज्ञापन के क्रिएटिव टेक्स्ट या लिंक के हिसाब से सेट होना चाहिए.

इस पैरामीटर का इस्तेमाल करने के लिए, यहां दिए गए दिशा-निर्देश लागू होते हैं:

  • यह पैरामीटर सिर्फ़ मिलते-जुलते कॉन्टेंट के लिए की गई खोज के अनुरोध पर ही उपलब्ध कराया जाना चाहिए. इसे बाकी सभी अनुरोधों के लिए अनदेखा कर दिया जाएगा.
  • इसका इस्तेमाल सिर्फ़ उस ट्रैफ़िक पर किया जाना चाहिए जो जान-बूझकर दूसरी वेबसाइटों से लिया गया है. ऑर्गैनिक ट्रैफ़िक पर इसका इस्तेमाल नहीं किया जाना चाहिए.
  • इसमें विज्ञापन या लिंक क्रिएटिव में मौजूद टाइटल लाइन, ब्यौरा, और/या कोई अन्य शब्द शामिल होना चाहिए.
  • विज्ञापन या लिंक क्रिएटिव से वैल्यू हटाना या अतिरिक्त वैल्यू शामिल करना, लिखित निर्देशों का उल्लंघन माना जाता है.
  • यह केस-इनसेंसिटिव है.
  • यह सही तरह से UTF-8 कोड में बदले गए वर्ण को स्वीकार करता है. यूनिकोड वर्ण / मात्राओं का इस्तेमाल किया जा सकता है.
  • Google, आपकी तरफ़ से सबमिट किए गए पैरामीटर का इस्तेमाल या उन्हें अनदेखा कर सकता है. इस्तेमाल किए जाने पर, यह कीवर्ड के चुनाव और उनकी रैंकिंग पर असर डाल सकता है.

ध्यान दें: terms पैरामीटर का इस्तेमाल करते समय, यह पैरामीटर ज़रूरी है.

उदाहरण:

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam ज़रूरी नहीं
इससे खोज नतीजों के पेज पर मौजूद सर्च क्वेरी के यूआरएल पैरामीटर के नाम का पता चलता है. अगर कुछ नहीं बताया गया है, तो डिफ़ॉल्ट वैल्यू 'q' होती है.

उदाहरण:

'resultsPageQueryParam' : 'query'
terms ज़रूरी नहीं
इस पैरामीटर की मदद से, खोज के लिए इस्तेमाल किए गए शब्दों की वह सूची उपलब्ध कराई जा सकती है जो कॉमा लगाकर अलग की गई है. इससे मिलते-जुलते खोज अनुरोध के साथ इन शब्दों का इस्तेमाल किया जा सकता है. हालांकि, हो सकता है कि Google इन शब्दों का इस्तेमाल करे या न करे.

ध्यान दें: इस पैरामीटर का इस्तेमाल करते समय, referrerAdCreative भी ज़रूरी है. साथ ही, relatedSearchTargeting भी ज़रूरी है और इसे 'content' पर सेट किया जाना चाहिए.

उदाहरण:

'terms' : 'cars rental, flight ticket'
ignoredPageParams ज़रूरी नहीं
इससे कॉन्टेंट पेज के लिए यूआरएल पैरामीटर की सूची का पता चलता है. इस पेज पर, कॉन्टेंट से मिलती-जुलती खोज वाली यूनिट मौजूद होती है. इन पैरामीटर को अनदेखा किया जा सकता है. इससे मुख्य कॉन्टेंट या उपयोगकर्ता अनुभव पर कोई असर नहीं पड़ता.

ध्यान दें: आपकी साइट पर खोज के लिए मिलते-जुलते शब्द दिखाने से पहले, Google आपके पेजों को क्रॉल करता है. इससे वह मिलते-जुलते शब्दों के सुझाव जनरेट करता है जो कॉन्टेक्स्ट के हिसाब से काम के हों. अगर किसी पेज को AdSense क्रॉलर ने अब तक क्रॉल नहीं किया है या उसे क्रॉल करने से ब्लॉक किया गया है (जैसे, robots.txt फ़ाइल का इस्तेमाल करके), तो हम Google को दिए गए मिलते-जुलते खोज शब्दों के सुझाव नहीं दिखाएंगे.

कॉन्टेंट पर मिलती-जुलती खोज की सुविधा, Google के कॉन्टेंट क्रॉलिंग सिस्टम पर निर्भर करती है. यह सिस्टम, पेजों को इंडेक्स करता है और खोज के लिए काम के शब्द जनरेट करता है. ट्रैकिंग वैरिएबल, यूज़र आईडी, सेशन आईडी या दूसरे डाइनैमिक आइडेंटिफ़ायर जैसे क्वेरी पैरामीटर वाले कॉन्टेंट पेज के यूआरएल, क्रॉलर की किसी पेज के मुख्य कॉन्टेंट का आकलन करने की क्षमता पर असर डाल सकते हैं. इससे खोज से जुड़े गलत या काम के न रहने वाले शब्द मिल सकते हैं. यह पेज पैरामीटर, Google के क्रॉलर को इन गैर-ज़रूरी पैरामीटर को अनदेखा करने का निर्देश देता है. इससे कॉन्टेंट को सही तरीके से इंडेक्स किया जा सकता है और क्रॉल करने के लिए गैर-ज़रूरी लोड को कम किया जा सकता है. इससे Google को यह पहचानने में मदद मिलती है कि किसी पेज को पहले ही क्रॉल किया जा चुका है. साथ ही, वह सुझाए गए शब्दों (Google और पार्टनर, दोनों के) को दिखाना शुरू कर सकता है. हालांकि, इसके लिए ज़रूरी है कि पार्टनर की साइट, ज़रूरी शर्तें पूरी करती हो.

इस पैरामीटर का इस्तेमाल करने के लिए, यहां दिए गए दिशा-निर्देश लागू होते हैं:

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

उदाहरण:
कोई उपयोगकर्ता किसी कॉन्टेंट पेज पर जाता है. इस पेज का यूआरएल यह है:

http://example.com/content?utm_medium=social&page_id=123&click_id=456
इन यूआरएल पैरामीटर को अनदेखा किया जा सकता है:
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
कॉन्टेंट पेज के यूआरएल को इस तरह से ट्रीट करेगा:
http://example.com/content?page_id=123

कॉन्फ़िगरेशन सेटिंग

पैरामीटर ब्यौरा और उदाहरण
adsafe ज़रूरी नहीं है
इससे फ़िल्टर करने के उन नियमों की जानकारी मिलती है जिन्हें Google को सर्च क्वेरी से मेल खाने वाले विज्ञापनों पर लागू करना है. यहां adsafe के लिए मान्य सेटिंग दी गई हैं और नतीजों में दिखने वाले विज्ञापन पर हर वैल्यू के असर के बारे में बताया गया है:
  • 'high' परिवार के साथ देखने लायक विज्ञापन दिखाता है. परिवार के साथ नहीं देखने लायक या सेक्शुअल कॉन्टेंट वाले विज्ञापन नहीं दिखते.
  • 'medium' परिवार के साथ देखने लायक और परिवार के साथ नहीं देखने लायक, दोनों तरह के विज्ञापन दिखाता है. सेक्शुअल कॉन्टेंट वाले विज्ञापन नहीं दिखते.
  • 'low' इससे सभी तरह के विज्ञापन दिखते हैं.

adsafe को डिफ़ॉल्ट रूप से 'high' पर सेट किया गया है.

उदाहरण:

'adsafe': 'medium'
adtest ज़रूरी नहीं
adtest पैरामीटर का इस्तेमाल करके यह बताया जाता है कि विज्ञापनों के लिए किया गया अनुरोध एक टेस्ट है. जब adtest पैरामीटर की वैल्यू on होती है, तब Google उस अनुरोध को टेस्ट मानता है. साथ ही, इसे न तो विज्ञापन इंप्रेशन के तौर पर गिना जाता है और न ही क्लिकथ्रू नतीजों के तौर पर ट्रैक किया जाता है.

जब adtest पैरामीटर की वैल्यू on होती है, तब रेवेन्यू जनरेट नहीं होता.

जब विज्ञापन टेस्ट किए जा रहे हों यानी adtest पैरामीटर को on पर सेट किया गया हो, तब दिखाए जाने वाले विज्ञापनों पर "टेस्ट विज्ञापन" ओवरले दिखाया जाएगा और उन पर क्लिक नहीं किया जा सकेगा. हालांकि, ऐसा उन विज्ञापन अनुरोध के लिए विज्ञापन दिखाते समय किया जाएगा जो ऐसे डोमेन से किए गए हैं जिसे अब तक साइट टैब में मंज़ूरी नहीं मिली है.

इस पैरामीटर का इस्तेमाल अपने विज्ञापन टेस्ट करते समय करें, लेकिन प्रोडक्शन सिस्टम में इस्तेमाल न करें. अगर ऐसा किया जाता है, तो दिखाए गए विज्ञापनों के लिए आपको पेमेंट नहीं किया जाएगा.

adtest की डिफ़ॉल्ट वैल्यू off होती है.

उदाहरण:

'adtest' : 'on'
channel ज़रूरी नहीं
अलग-अलग पेजों की परफ़ॉर्मेंस को ट्रैक करने के लिए, AdSense for Search चैनल को शामिल किया जा सकता है. उस यूनीक चैनल आईडी का इस्तेमाल करें जिसे आपने अपने AdSense खाते में बनाया है या आपके टेक्निकल खाता मैनेजर ने बनाया है. चैनलों के बारे में ज़्यादा जानने के लिए, यहां जाएं.

एक से ज़्यादा चैनल को '+' के निशान से अलग करना चाहिए.

उदाहरण:

'channel' :  'testA'  
'channel' :  'testA+testB'  
hl ज़रूरी नहीं
यह पैरामीटर उस भाषा की पहचान करता है जिसे अनुरोध किए गए विज्ञापनों या मिलती-जुलती खोजों को टारगेट करना चाहिए. डिफ़ॉल्ट वैल्यू en होती है.

Google में सभी AdWords API भाषा कोड इस्तेमाल किए जा सकते हैं.

ध्यान दें: विज्ञापन देने वाले लोगों या कंपनियों को उन भाषाओं की जानकारी देनी होती है जिन्हें उनके विज्ञापन टारगेट करते हैं. अगर आपने अनुरोध में इस पैरामीटर को शामिल किया है, तो Google सिर्फ़ उसी भाषा या सभी भाषाओं को टारगेट करने वाले विज्ञापन दिखाता है. हालांकि, इस बात की गारंटी नहीं है कि विज्ञापन टेक्स्ट आपकी बताई गई भाषा में ही होगा.

आम तौर पर, आपको उस पेज की मुख्य भाषा के लिए hl पैरामीटर सेट करना चाहिए जिससे पैरामीटर भेजा जाता है.

उदाहरण:

'hl' : 'es'
ie ज़रूरी नहीं है

ie पैरामीटर, कैरेक्टर एन्कोडिंग की वह स्कीम सेट करता है जिसे क्वेरी स्ट्रिंग को समझने के लिए इस्तेमाल किया जाना चाहिए.

ie की डिफ़ॉल्ट वैल्यू utf-8 होती है.

मान स्टैंडर्ड नाम इन भाषाओं में इस्तेमाल किया जा सकता है
latin1 ISO-8859-1 पश्चिमी यूरोपीय (कैटलन, डेनिश, डच, अंग्रेज़ी, फ़िनिश, फ़्रेंच, जर्मन, इंडोनेशियाई, इतालवी, नार्वेजियन, पुर्तगाली, स्पेनिश, स्वीडिश)
latin2 ISO-8859-2 पूर्वी यूरोपीय (क्रोएशियन, चेक, हंगेरियन, पोलिश, रोमानियन, सर्बियन, स्लोवाक, स्लोवेनियन)
latin3 ISO-8859-3  
latin4 ISO-8859-4 बाल्टिक (एस्टोनियन, लातवियन, लिथुआनियन)
cyrillic ISO-8859-5 बल्गेरियन, रशियन
ऐरेबिक ISO-8859-6  
ग्रीक ISO-8859-7 ग्रीक
हिब्रू ISO-8859-8 हिब्रू
latin5 ISO-8859-9  
latin6 ISO-8859-10 आइसलैंडिक
euc-jp EUC-JP जापानी
euc-kr EUC-KR कोरियाई
sjis Shift_JIS जापानी
big5 Big5 ट्रेडिशनल चाइनीज़
gb GB2312 सिंप्लिफ़ाइड चाइनीज़
utf-8 UTF-8 सभी
oe ज़रूरी नहीं है

oe पैरामीटर ऐसी कैरेक्टर एन्कोडिंग स्कीम सेट करता है जिसका इस्तेमाल करके Google, विज्ञापनों के टेक्स्ट का कोड बदलता है. तकनीकी तौर पर, इस पैरामीटर का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, इसके लिए वैल्यू पास करना बेहतर होता है.

oe की डिफ़ॉल्ट वैल्यू utf-8 होती है.

मान स्टैंडर्ड नाम इन भाषाओं में इस्तेमाल किया जा सकता है
latin1 ISO-8859-1 पश्चिमी यूरोपीय (कैटलन, डेनिश, डच, अंग्रेज़ी, फ़िनिश, फ़्रेंच, जर्मन, इंडोनेशियाई, इतालवी, नार्वेजियन, पुर्तगाली, स्पेनिश, स्वीडिश)
latin2 ISO-8859-2 पूर्वी यूरोपीय (क्रोएशियन, चेक, हंगेरियन, पोलिश, रोमानियन, सर्बियन, स्लोवाक, स्लोवेनियन)
latin3 ISO-8859-3  
latin4 ISO-8859-4 बाल्टिक (एस्टोनियन, लातवियन, लिथुआनियन)
cyrillic ISO-8859-5 बल्गेरियन, रशियन
ऐरेबिक ISO-8859-6  
ग्रीक ISO-8859-7 ग्रीक
हिब्रू ISO-8859-8 हिब्रू
latin5 ISO-8859-9  
latin6 ISO-8859-10 आइसलैंडिक
euc-jp EUC-JP जापानी
euc-kr EUC-KR कोरियाई
sjis Shift_JIS जापानी
gb GB2312 सिंप्लिफ़ाइड चाइनीज़
utf-8 UTF-8 सभी
ivt ज़रूरी नहीं
इस पैरामीटर की मदद से, एक बूलियन वैल्यू दी जा सकती है. इससे Google को यह पता चलता है कि आपको ऐसे विज्ञापनों को अनुमति देनी है जो सहमति देने वाले और सहमति न देने वाले, दोनों तरह के ट्रैफ़िक के लिए, अमान्य ट्रैफ़िक का पता लगाने वाली कुकी और लोकल स्टोरेज का इस्तेमाल करते हैं.
  • true अगर यह पैरामीटर मौजूद नहीं है या आपने इसे "true" पर सेट किया है, तो हम अमान्य ट्रैफ़िक का पता लगाने वाली कुकी सेट करेंगे. साथ ही, सहमति देने वाले उपयोगकर्ता से मिले ट्रैफ़िक के लिए ही लोकल स्टोरेज का इस्तेमाल करेंगे.
  • false इस पैरामीटर को "false" पर सेट करने पर, हम अमान्य ट्रैफ़िक का पता लगाने वाली कुकी सेट करेंगे. साथ ही, सहमति देने वाले और सहमति न देने वाले, दोनों तरह के ट्रैफ़िक के लिए लोकल स्टोरेज का इस्तेमाल करेंगे.

डिफ़ॉल्ट रूप से, IVT को सही पर सेट किया जाता है.

उदाहरण:

'ivt': false

यूनिट लेवल के पैरामीटर की जानकारी

इन पैरामीटर का असर, उपयोगकर्ता को किसी पेज पर अलग-अलग विज्ञापन यूनिट दिखाने के तरीके पर पड़ता है. हर पैरामीटर को हर विज्ञापन यूनिट के हिसाब से अलग-अलग सेट किया जा सकता है.

ज़रूरी है

पैरामीटर ब्यौरा और उदाहरण
container ज़रूरी है
उस खाली विज्ञापन कंटेनर का आईडी <div> जहां विज्ञापन दिखाना है.

उदाहरण:

'container' : 'afscontainer1'
maxTop इसकी तब ज़रूरत होती है, जब विज्ञापन यूनिट, खोज नतीजों के ऊपर हो.

इस पैरामीटर का इस्तेमाल यह बताने के लिए किया जाता है कि सबसे ऊपर की विज्ञापन यूनिट पर कितने विज्ञापन दिखाने हैं.

ध्यान दें: इस पैरामीटर का इस्तेमाल 'number' पैरामीटर की जगह किया जाता है. यह विज्ञापन यूनिट इतनी चौड़ी होनी चाहिए कि इससे विज्ञापनों की पहली लाइन न छिपे. पेज के किसी दूसरे प्लेसमेंट पर maxTop पैरामीटर का इस्तेमाल करने से नीति का उल्लंघन होता है.

उदाहरण:

'maxTop' : 4
width ज़रूरी है
इससे विज्ञापन या मिलती-जुलती खोज यूनिट की चौड़ाई की जानकारी पिक्सल में मिलती है.

उदाहरण:

'width' : '700px'
'width' : 700

कॉन्फ़िगरेशन सेटिंग

पैरामीटर ब्यौरा और उदाहरण
adLoadedCallback ज़रूरी नहीं
इससे JavaScript के उस फ़ंक्शन के बारे में पता चलता है जिसे कॉल करना है. यह तब किया जाता है, जब विज्ञापन या मिलती-जुलती खोज लोड होती है या कोई भी विज्ञापन या मिलती-जुलती खोज नहीं दिखाई जाती है. पैरामीटर को लागू किए गए JavaScript के उस कॉलबैक फ़ंक्शन पर सेट किया जाना चाहिए जिसे आपने विज्ञापन कॉल पूरा होने पर कार्रवाई करने के लिए सेट किया है.

कॉलबैक फ़ंक्शन इन पैरामीटर का इस्तेमाल करता है:

containerName विज्ञापन या मिलती-जुलती खोज यूनिट के कंटेनर का नाम.
adsLoaded जब दिखाने के लिए कम से कम एक विज्ञापन या मिलती-जुलती खोज से जुड़ा एक शब्द हो, तब इसे true पर सेट करें. साथ ही, दिखाने के लिए विज्ञापन या उससे जुड़ी कोई खोज न होने पर, false पर सेट करें.
isExperimentVariant अगर पसंदीदा स्टाइल वाला एक्सपेरिमेंट चल रहा हो और विज्ञापनों को रेंडर करने के लिए एक्सपेरिमेंट का वैरिएंट चुना जाता हो, तो true पर सेट करें.
callbackOptions यह एक JSON ऑब्जेक्ट है, जिसमें ये फ़ील्ड शामिल हैं:
termPositions: किसी मिलते-जुलते खोज ब्लॉक के लिए, पब्लिशर की ओर से उपलब्ध कराए गए कीवर्ड के जवाब में ऐसे किसी भी कीवर्ड को इंडेक्स नहीं किया गया है जिसमें map<string,int> मौजूद हो. अगर कोई शब्द दिया गया है, लेकिन दिखाया नहीं गया है, तो वह मैप में नहीं दिखेगा.

ध्यान दें: कृपया अपने कॉलबैक फ़ंक्शन की जांच करके पक्का करें कि यह कोई ऐसी गड़बड़ी जनरेट न करे जो आपके पेज को लोड करने में रुकावट डाल सकती है.

JavaScript के कॉलबैक फ़ंक्शन का उदाहरण:

var adblock1 = {
  'container' : 'adblock1_div_id',
  'adLoadedCallback' : function(containerName, adsLoaded,
    isExperimentVariant, callbackOptions) {
    if (adsLoaded) {
       try {
         // most likely do nothing
       } catch (e) {
         alert ("Error in callback function");
         // Do something to handle error gracefully
       }
    } else {
       // as you always do when there is no ad coverage from Google
    }
  }
};
      
number ज़रूरी नहीं
इस यूनिट में दिखाए जाने वाले विज्ञापनों की संख्या. डिफ़ॉल्ट वैल्यू 2 होती है.

उदाहरण:

'number' : 4
relatedSearches ज़रूरी नहीं
इस यूनिट में दिखाई जाने वाली मिलती-जुलती खोजों की संख्या. अगर यह वैल्यू 3 से कम है, तो मिलती-जुलती खोजें नहीं दिखाई जाएंगी.

उदाहरण:

'relatedSearches' : 4