पैरामीटर
पेज लेवल के पैरामीटर की जानकारी
आपको हर पेज में सिर्फ़ एक बार ये पैरामीटर डालने होंगे. इनका असर पेज की सभी यूनिट पर होता है.
ज़रूरी है
पैरामीटर | जानकारी और उदाहरण |
---|---|
adPage
|
यह तब ज़रूरी होता है, जब उपयोगकर्ता नतीजों वाले अगले या पिछले पेज पर जाता है.
|
pubId
|
ज़रूरी है यह आपका AdSense क्लाइंट आईडी है. आपका 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 पेज पैरामीटर, डिफ़ॉल्ट रूप से 'क्वेरी' पर अपने-आप सेट हो जाता है. हालांकि, यह ध्यान रखना ज़रूरी है कि यह डिफ़ॉल्ट वैल्यू, खास तौर पर सिर्फ़ खोज के नतीजों के पेजों (Search पर मिलती-जुलती खोज) के लिए डिज़ाइन की गई है. अगर किसी दूसरे तरह के पेज (जैसे, लेख, ब्लॉग पोस्ट) पर मिलती-जुलती खोज का इस्तेमाल किया जा रहा है, तो आपको पैरामीटर को साफ़ तौर पर 'कॉन्टेंट' पर सेट करना होगा. ध्यान दें: इस पैरामीटर का इस्तेमाल करने के लिए, यहां दिए गए दिशा-निर्देश लागू होते हैं:
उदाहरण: '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 को डिफ़ॉल्ट रूप से 'ज़्यादा' पर सेट किया गया है. उदाहरण: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
ज़रूरी नहीं adtest पैरामीटर का इस्तेमाल करके यह बताया जाता है कि विज्ञापनों के लिए किया गया अनुरोध एक टेस्ट है. जब adtest पैरामीटर की वैल्यू on होती है, तब Google उस अनुरोध को टेस्ट मानता है. साथ ही, इसे न तो विज्ञापन इंप्रेशन के तौर पर गिना जाता है और न ही क्लिकथ्रू नतीजों के तौर पर ट्रैक किया जाता है. जब adtest पैरामीटर की वैल्यू on होती है, तब रेवेन्यू जनरेट नहीं होता. जब विज्ञापन टेस्ट किए जा रहे हों यानी adtest पैरामीटर on हो, तब दिखाए जाने वाले विज्ञापनों पर "टेस्ट विज्ञापन" ओवरले दिखाया जाएगा और उन पर क्लिक नहीं किया जा सकेगा. हालांकि, ऐसा उन विज्ञापन अनुरोध के लिए विज्ञापन दिखाते समय किया जाएगा जो ऐसे डोमेन से किए गए हैं जिसे अब तक साइटें टैब में मंज़ूरी नहीं मिली है. इस पैरामीटर का इस्तेमाल अपने विज्ञापन टेस्ट करते समय करें, लेकिन प्रोडक्शन सिस्टम में इस्तेमाल न करें. अगर ऐसा किया जाता है, तो दिखाए गए विज्ञापनों के लिए आपको पेमेंट नहीं किया जाएगा. adtest की डिफ़ॉल्ट वैल्यू 'बंद' होती है. उदाहरण: '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' : 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
|
ज़रूरी नहीं इस यूनिट में दिखाई जाने वाली मिलती-जुलती खोजों की संख्या. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से यह वैल्यू 0 होती है. उदाहरण: 'relatedSearches' : 4 |