पसंद के मुताबिक सर्च विज्ञापनों के पैरामीटर की जानकारी

हमने जानकार उपयोगकर्ताओं के लिए, सर्च स्टाइल के ऐसे पैरामीटर की सूची दी है जो फ़िलहाल काम के हैं. AdSense में जनरेट किए गए कोड में, सबसे ज़्यादा इस्तेमाल की जाने वाली पैरामीटर सेटिंग शामिल होती हैं. दो पैरामीटर ज़रूरी होते हैं: pubId और query. AdSense से आपको pubId मिलता है, लेकिन आपको कोड में बदलाव करके query पैरामीटर के लिए एक वैल्यू पास करनी होगा. बाकी सभी पैरामीटर को इस्तेमाल करना या न करना आपकी ज़रूरत पर तय करता है. नीचे इनके बारे में बताया गया है.

पैरामीटर के टाइप

पैरामीटर दो टाइप के होते हैं:

• पेज लेवल के पैरामीटर, पेज पर मौजूद सभी विज्ञापन यूनिट पर लागू होते हैं
• यूनिट लेवल के पैरामीटर, हर विज्ञापन यूनिट पर अलग-अलग लागू होते हैं.

यहां उदाहरण के तौर पर, दो विज्ञापन ब्लॉक वाले कोड जनरेटर से मिलने वाले आउटपुट दिया गया है. इस कोड को कॉन्फ़िगर करने के लिए, आपको pageOptions मैप में ज़रूरी query पैरामीटर सेट करना होगा. उदाहरण के लिए, “query”: myQuery). विज्ञापनों को दिखाना शुरू करने के लिए, आपको इतना ही करना है. पेज लेवल के ब्लॉक में, पेज लेवल के वैकल्पिक पैरामीटर सेट किए जा सकते हैं. साथ ही, adblock1 और adblock2 मैप में अलग-अलग यूनिट लेवल के पैरामीटर सेट किए जा सकते हैं.

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // Page level parameters
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // Unit level parameters
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

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

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

ज़रूरी

पैरामीटर	जानकारी और उदाहरण
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 // where myQuery is a JavaScript variable containing the search query
resultsPageBaseUrl	इसकी तब ज़रूरत होती है, जब पेज पर मिलती जुलती खोज यूनिट हों इससे खोज नतीजों के उस पेज के यूआरएल का पता चलता है जहां सर्च क्वेरी, वह मिलता-जुलता शब्द है जिस पर उपयोगकर्ता ने क्लिक किया है. resultsPageBaseUrl में इसके खुद के पैरामीटर शामिल हो सकते हैं. हालांकि, इसमें सर्च क्वेरी शामिल नहीं होगी. यह अपने-आप जुड़ जाएगी. उदाहरण: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
styleId	ज़रूरी है इससे सर्च स्टाइल के उस आईडी का पता चलता है जो पेज पर मौजूद विज्ञापन या मिलती-जुलती खोज की यूनिट पर लागू होता है. सर्च स्टाइल का इस्तेमाल करने के बारे में ज़्यादा जानें. ध्यान रखें कि किसी अनुरोध के लिए styleId सेट किए जाने पर, विज्ञापन या मिलती-जुलती खोजें, नए स्टाइल के साथ रेंडर होंगी. पुराने स्टाइल पैरामीटर को अनदेखा कर दिया जाएगा. अगर अनुरोध में styleId का ज़िक्र नहीं है, तो सिस्टम डिफ़ॉल्ट स्टाइल रेंडर की जाएगी. उदाहरण 'styleId': '1234567890'

ज़रूरी नहीं

पैरामीटर	जानकारी और उदाहरण
linkTarget	ज़रूरी नहीं इससे पता चलता है कि किसी विज्ञापन पर क्लिक करने से वह पुरानी विंडो में खुलेगा या नई विंडो में. डिफ़ॉल्ट वैल्यू '_top' होती है. इस पैरामीटर का इस्तेमाल यूनिट लेवल पर भी किया जा सकता है. '_top' पुरानी विंडो में खुलेगा. '_blank' नई विंडो में खुलेगा. उदाहरण: 'linkTarget' : '_blank'
maxTermLength	ज़रूरी नहीं इससे पता चलता है कि मिलती-जुलती खोज के शब्दों में कितने वर्ण हो सकते हैं. इन वर्णों में स्पेस भी शामिल हैं. अगर वर्णों की संख्या सेट नहीं है, तो इसके लिए ज़्यादा से ज़्यादा सीमा नहीं होगी. उदाहरण: 'maxTermLength' : 50
referrerAdCreative	ज़रूरी नहीं अगर कोई उपयोगकर्ता किसी दूसरी वेबसाइट पर दिए गए लिंक या विज्ञापन (जिस पर आपका कंट्रोल है) पर क्लिक करके, आपके उस कॉन्टेंट पेज पर जाता है जिसमें कॉन्टेंट यूनिट के लिए मिलती-जुलती खोज मौजूद है, तो यह पैरामीटर उस विज्ञापन के क्रिएटिव टेक्स्ट या लिंक के हिसाब से सेट होना चाहिए. इस पैरामीटर का इस्तेमाल करने के लिए, यहां दिए गए दिशा-निर्देश लागू होते हैं: यह पैरामीटर सिर्फ़ मिलते-जुलते कॉन्टेंट के लिए की गई खोज के अनुरोध पर ही उपलब्ध कराया जाना चाहिए. इसे बाकी सभी अनुरोधों के लिए अनदेखा कर दिया जाएगा. इसका इस्तेमाल सिर्फ़ उसी ट्रैफ़िक पर किया जाना चाहिए जो जान-बूझकर दूसरी वेबसाइटों से लिया गया है. ऑर्गैनिक ट्रैफ़िक पर इसका इस्तेमाल कभी नहीं किया जा सकता. इसमें शीर्षक और/या विज्ञापन की जानकारी या क्रिएटिव का लिंक शामिल हो सकता है. यह केस-इनसेंसिटिव है. यह सही तरह से UTF-8 कोड में बदले गए वर्ण को स्वीकार करता है; यूनिकोड वर्ण / मात्राओं का इस्तेमाल किया जा सकता है. Google, आपकी तरफ़ से सबमिट किए गए पैरामीटर का इस्तेमाल या उन्हें अनदेखा कर सकता है. इस्तेमाल किए जाने पर, यह शब्दों के चुनाव और उनकी रैंकिंग पर असर डाल सकता है. उदाहरण: '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'

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

पैरामीटर	जानकारी और उदाहरण
adsafe	ज़रूरी नहीं इससे फ़िल्टर करने के उन नियमों की जानकारी मिलती है जिन्हें Google को सर्च क्वेरी से मेल खाने वाले विज्ञापनों पर लागू करना है. यहां adsafe के लिए मान्य सेटिंग दी गई हैं और नतीजों में दिखने वाले विज्ञापन पर हर वैल्यू के असर के बारे में बताया गया है: 'high', परिवार के साथ देखने लायक विज्ञापन दिखाता है. परिवार के साथ नहीं देखने लायक या सेक्शुअल कॉन्टेंट वाले विज्ञापन नहीं दिखते. 'medium' परिवार के साथ देखने लायक और परिवार के साथ नहीं देखने लायक, दोनों तरह के विज्ञापन दिखाता है. सेक्शुअल कॉन्टेंट वाले विज्ञापन नहीं दिखते. 'low' सभी तरह के विज्ञापन दिखाता है. ध्यान दें: adsafe को डिफ़ॉल्ट रूप से 'high' पर सेट किया गया है. उदाहरण: 'adsafe': 'medium'
adtest	ज़रूरी नहीं adtest पैरामीटर का इस्तेमाल करके यह बताया जाता है कि विज्ञापनों के लिए किया गया अनुरोध एक टेस्ट है. जब adtest पैरामीटर की वैल्यू 'on' होती है, तब Google उस अनुरोध को टेस्ट मानता है. साथ ही, इसे विज्ञापन इंप्रेशन के तौर पर नहीं गिना जाता है और क्लिकथ्रू नतीजों के तौर पर ट्रैक नहीं किया जाता है. जब adtest पैरामीटर की वैल्यू 'on' होती है, तब आपकी आय जनरेट नहीं होती. ध्यान दें: अपने विज्ञापन टेस्ट करते समय इस पैरामीटर का इस्तेमाल करें. हालांकि, प्रोडक्शन सिस्टम में इसका इस्तेमाल न करें, वर्ना दिखाए गए विज्ञापनों के लिए आपको पैसे नहीं मिलेंगे. adtest की डिफ़ॉल्ट वैल्यू 'off' होती है. उदाहरण: 'adtest' : 'on'
channel	ज़रूरी नहीं अलग-अलग पेजों की परफ़ॉर्मेंस को ट्रैक करने के लिए, 'खोज के लिए AdSense' चैनल को शामिल किया जा सकता है. उस यूनीक चैनल आईडी का इस्तेमाल करें जिसे आपने अपने AdSense खाते में बनाया है. कस्टम चैनल की मदद से, विज्ञापन की परफ़ॉर्मेंस को ट्रैक करने के बारे में ज़्यादा जानें. एक से ज़्यादा चैनल को '+' के निशान से अलग करना चाहिए.   उदाहरण: 'channel' : 'testA' 'channel' : 'testA+testB'
hl	ज़रूरी नहीं यह पैरामीटर उस भाषा की पहचान करता है, जिसे अनुरोध किए गए विज्ञापनों को टारगेट करना है. डिफ़ॉल्ट वैल्यू 'en' होती है. Google में सभी Google Ads 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 बल्गारियन, रूसी arabic ISO-8859-6   greek ISO-8859-7 ग्रीक hebrew 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 बल्गारियन, रूसी arabic ISO-8859-6   greek ISO-8859-7 ग्रीक hebrew 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 सभी
personalizedAds	ज़रूरी नहीं इससे पता चलता है कि उपयोगकर्ताओं ने लोगों के हिसाब से विज्ञापन दिखाने के लिए, Google के साथ अपनी निजी जानकारी शेयर करने की सहमति पब्लिशर को दी है या नहीं. true, क्वेरी से टारगेट किए गए विज्ञापन दिखाता है. साथ ही, यह कुछ ऐसे विज्ञापन भी दिखाता है जिन्हें उपयोगकर्ता की Google कुकी की मदद से टारगेट किया जा सकता है. अगर उपयोगकर्ता यूरोपीय संघ में रहता है, तो उपयोगकर्ता को सबसे पहले आपकी साइट को अपनी सहमति देनी होगी वह साइट दर्शकों की पसंद को ध्यान में रखकर विज्ञापन दिखाने के उद्देश्य से Google के साथ निजी जानकारी शेयर करे. false से केवल क्वेरी से टारगेट होने वाले विज्ञापन दिखाई देते हैं. इससे उपयोगकर्ता की Google कुकी के ज़रिए टारगेट होने वाला कोई भी विज्ञापन दिखाई नहीं देगा. अगर किसी उपयोगकर्ता ने लोगों के हिसाब से विज्ञापन दिखाने के लिए, Google के साथ अपनी निजी जानकारी शेयर करने की सहमति नहीं दी है, तो इस वैल्यू को 'false' पर सेट करना होगा. ध्यान दें: personalizedAds की डिफ़ॉल्ट वैल्यू 'true' होती है. उदाहरण: 'personalizedAds': false

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

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

ज़रूरी

पैरामीटर	जानकारी और उदाहरण
container	ज़रूरी है उस खाली विज्ञापन कंटेनर का आईडी <div id='afscontainer1'></div> जहांं विज्ञापन दिखाना है. उदाहरण: 'container' : 'afscontainer1'
maxTop	ज़रूरी इस पैरामीटर का इस्तेमाल यह बताने के लिए किया जाता है कि सबसे ऊपर की विज्ञापन यूनिट पर कितने विज्ञापन दिखाने हैं. ध्यान दें: इस पैरामीटर का इस्तेमाल number पैरामीटर की जगह किया जाता है. यह विज्ञापन यूनिट इतनी चौड़ी होनी चाहिए कि इससे विज्ञापनों की पहली लाइन न छिपे. पेज के किसी दूसरे प्लेसमेंट पर maxTop पैरामीटर का इस्तेमाल करने से नीति का उल्लंघन होता है. उदाहरण: 'maxTop' : 4
width	ज़रूरी है इससे विज्ञापन यूनिट या उससे जुड़ी सर्च यूनिट की चौड़ाई की जानकारी पिक्सल में मिलती है. उदाहरण: 'width' : '700px' 'width' : 700

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

पैरामीटर	जानकारी और उदाहरण
adLoadedCallback	ज़रूरी नहीं इससे JavaScript के उस फ़ंक्शन के बारे में पता चलता है जिसे कॉल करना है. यह तब किया जाता है, जब विज्ञापन या मिलती-जुलती खोज लोड होती है या कोई भी विज्ञापन या मिलती-जुलती खोज नहीं दिखाई जाती है. पैरामीटर, लागू किए गए JavaScript के उस कॉलबैक फ़ंक्शन पर सेट होना चाहिए जिसे आपने विज्ञापन कॉल पूरा होने पर कार्रवाई करने के लिए सेट किया है. कॉलबैक फ़ंक्शन इन पैरामीटर का इस्तेमाल करता है: containerName विज्ञापन या मिलती-जुलती खोज यूनिट के कंटेनर का नाम. adsLoaded जब दिखाने के लिए कम से कम एक विज्ञापन या उससे मिलता-जुलता खोज शब्द हो, तब इसे 'सही' पर सेट करें. साथ ही, दिखाने के लिए विज्ञापन या उससे जुड़ी कोई खोज न होने पर, 'गलत' पर सेट करें. isExperimentVariant अगर पसंद के मुताबिक स्टाइल वाला प्रयोग चल रहा हो और विज्ञापनों को रेंडर करने के लिए प्रयोग का वैरिएंट चुना जाता हो, तो 'सही' पर सेट करें. callbackOptions JSON ऑब्जेक्ट जिसमें ये फ़ील्ड शामिल हैं: termPosition: किसी मिलती-जुलती खोज ब्लॉक के लिए, पब्लिशर की तरफ़ से उपलब्ध कराए गए शब्दों के जवाब में ऐसे किसी भी शब्द को इंडेक्स नहीं किया गया है जिसमें 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	ज़रूरी नहीं इस इकाई में दिखाई जाने वाली मिलती-जुलती खोजों की संख्या. जब तक शून्य पर सेट न किया जाए, तब तक यह पैरामीटर कम से कम तीन मिलती-जुलती खोजें दिखाता है. अगर बताया न गया हो, तो डिफ़ॉल्ट वैल्यू '0' होती है. उदाहरण: 'relatedSearches' : 4