पैरामीटर
पेज लेवल के पैरामीटर की जानकारी
आपको हर पेज में सिर्फ़ एक बार ये पैरामीटर डालने होंगे. इनका असर पेज की सभी यूनिट पर होता है.
ज़रूरी है
पैरामीटर | ब्यौरा और उदाहरण |
---|---|
adPage
|
यह तब ज़रूरी होता है, जब उपयोगकर्ता नतीजों वाले अगले या पिछले पेज पर जाता है.
|
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
|
इसकी तब ज़रूरत होती है, जब पेज पर मिलती-जुलती खोज यूनिट हों. मिलती-जुलती खोज यूनिट का अनुरोध करने पर, इस पैरामीटर को शामिल करना ज़रूरी है. यह कुकी, पेज के कॉन्टेक्स्ट के आधार पर यह कंट्रोल करती है कि मिलती-जुलती खोज के नतीजे किस तरह से दिखाए जाएं:
ध्यान दें:relatedSearchTargeting पेज पैरामीटर की वैल्यू, डिफ़ॉल्ट रूप से 'query' पर सेट होती है. हालांकि, यह ध्यान रखना ज़रूरी है कि यह डिफ़ॉल्ट वैल्यू, खोज के नतीजों वाले पेजों के लिए ही डिज़ाइन की गई है (Search पर मिलती-जुलती खोज). अगर किसी दूसरे तरह के पेज (जैसे, लेख, ब्लॉग पोस्ट) पर मिलती-जुलती खोज का इस्तेमाल किया जा रहा है, तो आपको पैरामीटर को 'content' पर सेट करना होगा. ध्यान दें: इस पैरामीटर का इस्तेमाल करने के लिए, यहां दिए गए दिशा-निर्देश लागू होते हैं:
उदाहरण: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
ज़रूरी है इससे पसंद के मुताबिक सर्च स्टाइल के उस आईडी का पता चलता है जो पेज पर मौजूद विज्ञापन या मिलती-जुलती खोज यूनिट पर लागू होता है. कस्टम सर्च स्टाइल इस्तेमाल करने के बारे में ज़्यादा जानें. ध्यान दें कि किसी अनुरोध के लिए styleId सेट किए जाने पर, विज्ञापन या मिलती-जुलती खोजें, नए स्टाइल के साथ रेंडर होंगी. पुराने स्टाइल पैरामीटर को अनदेखा कर दिया जाएगा. अगर अनुरोध में styleId का ज़िक्र नहीं है, तो सिस्टम डिफ़ॉल्ट स्टाइल रेंडर की जाएगी. उदाहरण: 'styleId': '1234567890' |
वैकल्पिक
पैरामीटर | ब्यौरा और उदाहरण |
---|---|
linkTarget
|
ज़रूरी नहीं इससे पता चलता है कि किसी विज्ञापन पर क्लिक करने से वह पुरानी विंडो में खुलेगा या नई विंडो में. डिफ़ॉल्ट वैल्यू '_top' होती है. इस पैरामीटर का इस्तेमाल यूनिट लेवल पर भी किया जा सकता है.
उदाहरण: 'linkTarget' : '_blank' |
referrerAdCreative
|
ज़रूरी नहीं अगर कोई उपयोगकर्ता किसी दूसरी वेबसाइट पर दिए गए लिंक या विज्ञापन (जिस पर आपका कंट्रोल है) पर क्लिक करके, आपके उस कॉन्टेंट पेज पर जाता है जिसमें कॉन्टेंट यूनिट के लिए मिलती-जुलती खोज मौजूद है, तो यह पैरामीटर उस विज्ञापन के क्रिएटिव टेक्स्ट या लिंक के हिसाब से सेट होना चाहिए. इस पैरामीटर का इस्तेमाल करने के लिए, यहां दिए गए दिशा-निर्देश लागू होते हैं:
ध्यान दें: उदाहरण: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam
|
ज़रूरी नहीं इससे खोज नतीजों के पेज पर मौजूद सर्च क्वेरी के यूआरएल पैरामीटर के नाम का पता चलता है. अगर कुछ नहीं बताया गया है, तो डिफ़ॉल्ट वैल्यू 'q' होती है. उदाहरण: 'resultsPageQueryParam' : 'query' |
terms
|
ज़रूरी नहीं इस पैरामीटर की मदद से, खोज के लिए इस्तेमाल किए गए शब्दों की वह सूची उपलब्ध कराई जा सकती है जो कॉमा लगाकर अलग की गई है. इससे मिलते-जुलते खोज अनुरोध के साथ इन शब्दों का इस्तेमाल किया जा सकता है. हालांकि, हो सकता है कि Google इन शब्दों का इस्तेमाल करे या न करे.
ध्यान दें: इस पैरामीटर का इस्तेमाल करते समय, उदाहरण: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
ज़रूरी नहीं इससे कॉन्टेंट पेज के लिए यूआरएल पैरामीटर की सूची का पता चलता है. इस पेज पर, कॉन्टेंट से मिलती-जुलती खोज वाली यूनिट मौजूद होती है. इन पैरामीटर को अनदेखा किया जा सकता है. इससे मुख्य कॉन्टेंट या उपयोगकर्ता अनुभव पर कोई असर नहीं पड़ता. ध्यान दें: आपकी साइट पर खोज के लिए मिलते-जुलते शब्द दिखाने से पहले, Google आपके पेजों को क्रॉल करता है. इससे वह मिलते-जुलते शब्दों के सुझाव जनरेट करता है जो कॉन्टेक्स्ट के हिसाब से काम के हों. अगर किसी पेज को AdSense क्रॉलर ने अब तक क्रॉल नहीं किया है या उसे क्रॉल करने से ब्लॉक किया गया है (जैसे, robots.txt फ़ाइल का इस्तेमाल करके), तो हम 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 के लिए मान्य सेटिंग दी गई हैं और नतीजों में दिखने वाले विज्ञापन पर हर वैल्यू के असर के बारे में बताया गया है:
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
|
ज़रूरी नहीं है
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
ज़रूरी नहीं है
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
ज़रूरी नहीं इस पैरामीटर की मदद से, एक बूलियन वैल्यू दी जा सकती है. इससे Google को यह पता चलता है कि आपको ऐसे विज्ञापनों को अनुमति देनी है जो सहमति देने वाले और सहमति न देने वाले, दोनों तरह के ट्रैफ़िक के लिए, अमान्य ट्रैफ़िक का पता लगाने वाली कुकी और लोकल स्टोरेज का इस्तेमाल करते हैं.
डिफ़ॉल्ट रूप से, IVT को सही पर सेट किया जाता है. उदाहरण: 'ivt': false |
यूनिट लेवल के पैरामीटर की जानकारी
इन पैरामीटर का असर, उपयोगकर्ता को किसी पेज पर अलग-अलग विज्ञापन यूनिट दिखाने के तरीके पर पड़ता है. हर पैरामीटर को हर विज्ञापन यूनिट के हिसाब से अलग-अलग सेट किया जा सकता है.
ज़रूरी है
पैरामीटर | ब्यौरा और उदाहरण |
---|---|
container
|
ज़रूरी है उस खाली विज्ञापन कंटेनर का आईडी <div> जहां विज्ञापन दिखाना है.
उदाहरण: 'container' : 'afscontainer1' |
maxTop
|
इसकी तब ज़रूरत होती है, जब विज्ञापन यूनिट, खोज नतीजों के ऊपर हो. इस पैरामीटर का इस्तेमाल यह बताने के लिए किया जाता है कि सबसे ऊपर की विज्ञापन यूनिट पर कितने विज्ञापन दिखाने हैं. ध्यान दें: इस पैरामीटर का इस्तेमाल 'number' पैरामीटर की जगह किया जाता है. यह विज्ञापन यूनिट इतनी चौड़ी होनी चाहिए कि इससे विज्ञापनों की पहली लाइन न छिपे. पेज के किसी दूसरे प्लेसमेंट पर maxTop पैरामीटर का इस्तेमाल करने से नीति का उल्लंघन होता है. उदाहरण: 'maxTop' : 4 |
width
|
ज़रूरी है इससे विज्ञापन या मिलती-जुलती खोज यूनिट की चौड़ाई की जानकारी पिक्सल में मिलती है. उदाहरण: 'width' : '700px' 'width' : 700 |
कॉन्फ़िगरेशन सेटिंग
पैरामीटर | ब्यौरा और उदाहरण | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
ज़रूरी नहीं इससे JavaScript के उस फ़ंक्शन के बारे में पता चलता है जिसे कॉल करना है. यह तब किया जाता है, जब विज्ञापन या मिलती-जुलती खोज लोड होती है या कोई भी विज्ञापन या मिलती-जुलती खोज नहीं दिखाई जाती है. पैरामीटर को लागू किए गए JavaScript के उस कॉलबैक फ़ंक्शन पर सेट किया जाना चाहिए जिसे आपने विज्ञापन कॉल पूरा होने पर कार्रवाई करने के लिए सेट किया है. कॉलबैक फ़ंक्शन इन पैरामीटर का इस्तेमाल करता है:
ध्यान दें: कृपया अपने कॉलबैक फ़ंक्शन की जांच करके पक्का करें कि यह कोई ऐसी गड़बड़ी जनरेट न करे जो आपके पेज को लोड करने में रुकावट डाल सकती है. 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 |