वैरिएबल और शर्तें

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

खास जानकारी

लैंडिंग पेज फ़ाइल में, लैंडिंग पेज का यूआरएल तय किया जाता है. जब विज्ञापन या मुफ़्त बुकिंग लिंक दिखाया जाता है, तो यूआरएल में मौजूद डाइनैमिक जानकारी को असल वैल्यू से बदल दिया जाता है. अपने लैंडिंग पेज यूआरएल में डाइनैमिक वैल्यू जोड़ने के लिए, यहां दिए गए सिंटैक्स का इस्तेमाल करें:

<URL>https://partner_url?param_id=(variable_name)</URL>

यहां दिए गए उदाहरणों में एक ऐसा यूआरएल दिखाया गया है जिसमें होटल के असल आईडी और यात्रा की योजना के बजाय, Google के वैरिएबल के नाम का इस्तेमाल किया गया है:

उदाहरण 1

<URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

उदाहरण 2

<URL>https://www.partnerdomain.com/hotel/(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)
</URL>

जब खोज नतीजों के पेज के लिए लैंडिंग पेज का लिंक बनाया जाता है, तो Google यह पक्का करने के लिए कि यूआरएल में डाइनैमिक जानकारी. उदाहरण के लिए, अगर कोई व्यक्ति होटल #42 के लिए, 23/5/2023 से छह रातें, Google पिछले लिंक को रेंडर करेगा जैसे:

https://www.partnerdomain.com?hotelID=42&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=6

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

उदाहरण के लिए, LENGTH वैरिएबल की वैल्यू, <Nights> एलिमेंट को असाइन की जाती है. यह वैल्यू, यात्रा की योजना के कीमत वाले फ़ीड से ली जाती है. इसी तरह, PARTNER-HOTEL-ID वैरिएबल, होटल सूची के <id> एलिमेंट में तय किया गया है उपयोगकर्ता की खोज की शर्तों से मेल खाने वाला फ़ीड.

कुछ वैरिएबल, कीमत वाले फ़ीड एलिमेंट के सबसेट हैं. उदाहरण के लिए, कीमत वाले फ़ीड में मौजूद एक <Checkin> एलिमेंट से, CHECKINDAY, CHECKINMONTH, और CHECKINYEAR वैरिएबल निकाले जाते हैं. अन्य वैरिएबल का हिसाब, उपयोगकर्ता की स्थानीय भाषा और क्लाइंट की अन्य सेटिंग के आधार पर लगाया जाता है.

वैरिएबल वैल्यू के सोर्स के बारे में ज़्यादा जानने के लिए, कीमत की खास जानकारी और होटल की सूची देखें.

यूआरएल वैरिएबल

यहां दी गई टेबल में, ऐसे उपलब्ध वैरिएबल के बारे में बताया गया है जिनका इस्तेमाल करके, लैंडिंग पेज का यूआरएल बनाया जा सकता है:

यूआरएल में शर्त वाला लॉजिक

एंडपॉइंट को शर्त के हिसाब से बनाने के लिए, लैंडिंग पेज फ़ाइल के <URL> एलिमेंट में खास निर्देशों का इस्तेमाल किया जा सकता है.

शर्त के हिसाब से लागू होने वाले लॉजिक में, ये स्टेटमेंट इस्तेमाल किए जा सकते हैं:

• if_statement: अगर true है, तो इस शर्त के मुताबिक वैल्यू को यूआरएल में डाला जाता है. अगर true नहीं है, तो ELSE डायरेक्टिव के मुताबिक वैल्यू डाली जाती हैं.

• for_statement: एक FOR लूप कंडीशन बनाता है, जो दी गई वैल्यू की संख्या के हिसाब से दोहराता है.

IF और FOR स्टेटमेंट में ये शामिल हैं:

IF-AD-CLICK का उदाहरण

आपके पास एक शर्त वाला ब्लॉक बनाने का विकल्प है. यह ब्लॉक यह जांच करता है कि उपयोगकर्ता ने आपके लैंडिंग पेज पर रीडायरेक्ट करने के लिए, विज्ञापन या मुफ़्त बुकिंग लिंक पर क्लिक किया है या नहीं.

यहां दिए गए उदाहरण में, लैंडिंग पेज की फ़ाइल में इस डायरेक्टिव का इस्तेमाल किया गया है:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-AD-CLICK)&amp;adType=1(ELSE)&amp;adType=0(ENDIF)</URL>

इस उदाहरण में, अगर उपयोगकर्ता ने किसी विज्ञापन पर क्लिक नहीं किया, तो नतीजा यह होगा यूआरएल:

https://www.partner.com?hid=123&adType=0

अगर उपयोगकर्ता ने विज्ञापन पर क्लिक किया, तो नतीजा यह यूआरएल होगा:

https://www.partner.com?hid=123&adType=1

IF-Click-TYPE-Hotel का उदाहरण

आपके पास शर्तों वाला ऐसा ब्लॉक बनाने का विकल्प होता है जो यह जांच करता है कि उपयोगकर्ता ने साफ़ तौर पर कमरे के बंडल के बिना होटल चुना है या नहीं. लेन-देन के मैसेज के <Room Bundle> ब्लॉक में <RatePlanID> एलिमेंट की वैल्यू, उपयोगकर्ता के चुने गए रूम के बंडल की कीमत पर सेट की जाएगी.

यहां दिए गए उदाहरण में, लैंडिंग पेजों की फ़ाइल में इस डायरेक्टिव का इस्तेमाल किया गया है:

<URL>https://partner.com/(IF-CLICK-TYPE-HOTEL)landing(ELSE)landing_room(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

इस उदाहरण में, अगर उपयोगकर्ता ने रूम बंडल चुना, तो नतीजा यह यूआरएल होगा:

https://partner.com/landing_room?hid=123

अगर उपयोगकर्ता ने कमरे का बंडल नहीं चुना है, तो यह यूआरएल होगा:

https://partner.com/landing?hid=123

IF-CLICK-TYPE-ROOM का उदाहरण

आपके पास शर्तों वाला ऐसा ब्लॉक बनाने का विकल्प होता है जो यह जांच करता है कि उपयोगकर्ता ने कोई रूम बंडल चुना है या नहीं.

यहां दिए गए उदाहरण में, लैंडिंग पेजों की फ़ाइल में इस डायरेक्टिव का इस्तेमाल किया गया है:

<URL>https://partner.com/(IF-CLICK-TYPE-ROOM)landing_room(ELSE)landing(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

इस उदाहरण में, अगर उपयोगकर्ता ने कमरे का बंडल नहीं चुना है, तो इसका नतीजा यह होगा नीचे दिया गया यूआरएल:

https://partner.com/landing?hid=123

अगर उपयोगकर्ता ने रूम बंडल चुना है, तो नतीजा यह यूआरएल होगा:

https://partner.com/landing_room?hid=123

IF-DEFAULT-DATE फ़ंक्शन का उदाहरण

तारीख के अलावा किसी अन्य पैरामीटर को सेट करने के लिए, IF-DEFAULT-DATE कंडीशनल स्टेटमेंट का इस्तेमाल करें. अगर उपयोगकर्ता ने कोई तारीख नहीं चुनी है, तो आपकी वेबसाइट इस पैरामीटर का इस्तेमाल करके कस्टम व्यवहार को ट्रिगर कर सकती है.

यहां दिए गए उदाहरण में यह जांच की गई है कि डिफ़ॉल्ट तारीख का इस्तेमाल किया गया है या नहीं:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)<strong>(IF-DEFAULT-DATE)</strong>&amp;popup_datepicker=true(ELSE)&amp;popup_datepicker=false(ENDIF)</URL>

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

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=1&popup_datepicker=true

अगर उपयोगकर्ता ने कोई तारीख चुनी है, तो नतीजा इस यूआरएल से मिलता-जुलता हो सकता है, उनकी चुनी गई यात्रा की योजना के हिसाब से:

https://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2023&nights=2&popup_datepicker=false

IF-HOTEL-CAMPAIGN का उदाहरण (होटल विज्ञापन और मुफ़्त बुकिंग लिंक पर क्लिक)

शर्तों के हिसाब से एक ब्लॉक बनाया जा सकता है. इससे यह पता चलता है कि उपयोगकर्ता ने उस विज्ञापन पर क्लिक किया है या नहीं किसी होटल कैंपेन से हुई है.

नीचे दिए गए उदाहरण में, लैंडिंग पेज फ़ाइल में इस डायरेक्टिव का इस्तेमाल किया गया है:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

इस उदाहरण में, अगर उपयोगकर्ता किसी होटल कैंपेन के यूआरएल पर क्लिक करता है, तो ऐसे में निम्न URL:

https://www.partner.com?hotelID=123&hotel_campaign=12345678

अगर क्लिक, होटल कैंपेन के यूआरएल (जैसे, सामान्य सर्च कैंपेन) पर नहीं है, तो नतीजा यह यूआरएल होगा:

https://www.partner.com?hotelID=123&utm_campaign=87654321

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

एफ़बीएल क्लिक वाले खाली कैंपेन आईडी

अगर यह क्लिक मुफ़्त बुकिंग लिंक पर है, तो IF-HOTEL-CAMPAIGN, नतीजे में दिखेगा जैसा कि इस यूआरएल में दिखाया गया है, TRUE और CAMPAIGN-ID वैल्यू को खाली पर सेट किया गया है:

https://www.partner.com?hotelID=123&hotel_campaign=

कैंपेन आईडी को खाली छोड़ने से रोकने के लिए, IF-AD-CLICK कंडीशनल स्टेटमेंट का इस्तेमाल किया जा सकता है. इसका उदाहरण यहां दिया गया है:

<URL>https://partner.com?hotelID=(PARTNER-HOTEL-ID)(IF-HOTEL-CAMPAIGN)(IF-AD-CLICK)&amp;hotel_campaign=(CAMPAIGN-ID)(ELSE)&amp;FreeBookingLink(ENDIF)(ELSE)utm_campaign=(CAMPAIGN-ID)(ENDIF)</URL>

IF-PAYMENT-ID का उदाहरण (सिर्फ़ Hotel Ads के लिए)

यूआरएल में बदलाव करने के लिए IF-PAYMENT-ID कंडिशनल स्टेटमेंट का इस्तेमाल करें. यह इस बात पर निर्भर करता है कि क्या यह क्लिक, पीपीएस कमीशन प्रोग्राम की वजह से हो सकता है या नहीं. नीचे दिया गया उदाहरण यह जांचता है कि क्या कोई क्लिक PPS कमीशन प्रोग्राम से आया है और नतीजे के आधार पर booking_source पैरामीटर:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)&amp;booking_source=(IF-PAYMENT-ID)(PAYMENT-ID)(ELSE)cpc(ENDIF)</URL>

अगर होटल, कमीशन कार्यक्रम का हिस्सा है, तो नतीजे के तौर पर यूआरएल:

• अगर Google को कोई आईएटीए नंबर असाइन नहीं किया गया है, तो:

  https://partner.com?hid=123&booking_source=commissions

• अगर Google को कोई आईएटीए नंबर असाइन किया गया है, तो:

  https://partner.com?hid=123&booking_source=01234567

अगर ऐसा नहीं है, तो यह यूआरएल इस तरह का होगा:

https://partner.com?hid=123&booking_source=cpc

अगर प्रमोट किया गया है, तो उदाहरण (सिर्फ़ होटल विज्ञापन के लिए)

एक कंडिशनल ब्लॉक बनाया जा सकता है, जो यह पता लगाता है कि उपयोगकर्ता ने प्रॉपर्टी प्रमोशन विज्ञापन.

यहां दिए गए उदाहरण में, लैंडिंग पेजों की फ़ाइल में इस डायरेक्टिव का इस्तेमाल किया गया है:

<URL>https://partner.com/(IF-PROMOTED)1(ELSE)0(ENDIF)?hid=(PARTNER-HOTEL-ID)</URL>

इस उदाहरण में, अगर उपयोगकर्ता ने प्रॉपर्टी प्रमोशन विज्ञापन चुना है, तो नतीजा यह यूआरएल होगा:

https://partner.com/1?hid=123

अगर उपयोगकर्ता ने प्रॉपर्टी प्रमोशन विज्ञापन नहीं चुना है, तो नतीजा यह होगा निम्न URL:

https://partner.com/0?hid=123

IF-RATE-RULE-ID का उदाहरण

आपके पास एक शर्त वाला ब्लॉक बनाने का विकल्प है. यह ब्लॉक यह जांच करता है कि उपयोगकर्ता ने शर्त के साथ कोई किराया चुना है या नहीं. अगर ऐसा है, तो लेन-देन के मैसेज के <Rate> ब्लॉक में मौजूद <RateRuleID> एलिमेंट की वैल्यू का इस्तेमाल किया जाता है.

नीचे दिए गए उदाहरण में, लैंडिंग पेजों की फ़ाइल में इस डायरेक्टिव का इस्तेमाल किया गया है:

<URL>https://partner.com?hid=(PARTNER-HOTEL-ID)(IF-RATE-RULE-ID)&amp;customerType=42(ELSE)(ENDIF)</URL>

इस उदाहरण में, अगर उपयोगकर्ता ने कोई खास किराया नहीं चुना है, तो इसका नतीजा यह होगा नीचे दिया गया यूआरएल:

https://www.partner.com?hid=123

अगर उपयोगकर्ता ने शर्तों के हिसाब से तय की गई किराया दर चुनी है, तो नतीजा यह यूआरएल होगा:

https://www.partner.com?hid=123&customerType=42

IF-USER-LIST-ID का उदाहरण (Google Ads में तय किया गया)

अगर आपने Google Ads में होटल कैंपेन में ऑडियंस की सूचियों के लिए बिड मल्टीप्लायर सेट किए हैं, तो किसी Google Ads ऑडियंस सूची से जुड़े ग्राहक के लिए, अपनी वेबसाइट पर पैरामीटर सेट करने के लिए, USER-LIST-ID के साथ IF-USER-LIST-ID का इस्तेमाल किया जा सकता है. ऐसा हो सकता है कि आप ट्रैकिंग के लिए या अपने ऑडियंस सूचियों के सदस्यों के लिए वेबसाइट.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-USER-LIST-ID)&amp;audience_list=(USER-LIST-ID)(ELSE)(ENDIF)</URL>

इस उदाहरण में, अगर उपयोगकर्ता ऑडियंस की सूची का सदस्य नहीं था, तो इसका नतीजा नीचे दिया गया यूआरएल:

https://www.partner.com?hid=123

अगर उपयोगकर्ता 12345678 ऑडियंस की सूची का सदस्य था, तो इसका नतीजा यह होगा नीचे दिया गया यूआरएल:

https://www.partner.com?hid=123&audience_list=12345678

IF-VERIFICATION फ़ंक्शन का उदाहरण

अगर आपको यह देखना है कि Google ने यूआरएल को जांच के लिए जनरेट किया है या अपने-आप पुष्टि करने के लिए, तो IF-VERIFICATION का इस्तेमाल करें.

<URL>https://partner.com/?hid=(PARTNER-HOTEL-ID)(IF-VERIFICATION)&amp;isgoogle=true(ENDIF)</URL>

इस उदाहरण में, अगर Google ने जांच या पुष्टि के लिए यूआरएल जनरेट नहीं किया है, तो नतीजा यह यूआरएल होगा:

https://www.partner.com?hid=123

अगर Google ने जांच या पुष्टि के लिए यूआरएल जनरेट किया है, तो नतीजा यह यूआरएल होगा:

https://www.partner.com?hid=123&isgoogle=true

FOR-EACH-CHILD-AGE का उदाहरण

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

यहां दिए गए उदाहरण में, लैंडिंग पेजों की फ़ाइल में इस डायरेक्टिव का इस्तेमाल किया गया है:

<URL>https://partner.com?adults=(NUM-ADULTS)&amp;children=(NUM-CHILDREN)(FOR-EACH-CHILD-AGE)&amp;age=(CHILD-INDEX)_(CHILD-AGE)(END-FOR-EACH)&amp;hid=(PARTNER-HOTEL-ID)&amp;</URL>

इस उदाहरण में, अगर यात्रा की योजना में दो वयस्क और दो बच्चे शामिल हैं, जिनकी उम्र क्रमशः 0 और 17 साल है, तो नतीजा यह यूआरएल होगा:

https://www.partner.com?adults=2&children=2&age=0_0age=1_17&hid=123

अगर यात्रा की योजना में दो वयस्क और 0 बच्चे थे, तो नतीजा ये होगा यूआरएल:

https://www.partner.com?adults=2&children=0&hid=123

यूआरएल बनाते समय इस्तेमाल किए जाने वाले सामान्य नियम

सभी वैरिएबल डालना ज़रूरी नहीं है. आपको अपने लैंडिंग पेज के यूआरएल में कोई वैरिएबल डालने की ज़रूरत नहीं है. हालांकि, यात्रा की योजना और उपयोगकर्ता जानकारी आम तौर पर उपयोगकर्ता के लिए बेहतर अनुभव बनाती है और इस प्रक्रिया में आपकी सहायता करती है नीतियों के मुताबिक काम करते हैं.

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

• सभी वैरिएबल को ओपन और क्लोज़ ब्रैकेट से घेरा जाता है.

• क्वेरी स्ट्रिंग पैरामीटर को आखिरी आउटपुट. ऐसा इसलिए है, क्योंकि ऐंपरसेंड एक्सएमएल में एक खास वर्ण है और लैंडिंग पेजों की फ़ाइल का फ़ॉर्मैट एक्सएमएल है. इसलिए, आपको कोड में बदली गई इकाई का इस्तेमाल करना होगा "& उसकी जगह पर होगा. फ़ाइनल आउटपुट में, असली "&" वर्ण. उदाहरण के लिए:

  <!-- Do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&amp;nights=(LENGTH)</URL>
  
  <!-- Do NOT do this: -->
  <URL>https://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)&nights=(LENGTH)</URL>
  

  आपको उन खास वर्णों को भी कोड में बदलना होगा जिन्हें आपने लैंडिंग पेज के यूआरएल में शामिल किया है. उदाहरण के लिए:

  • स्पेस (" "): <URL> एलिमेंट में स्पेस वर्ण को "%20;" से बदलें
  • फ़ॉरवर्ड स्लैश ("/"): <URL> एलिमेंट में फ़ॉरवर्ड स्लैश को "%2F;" से बदलें

  यह ज़रूरी नहीं है कि वर्णमाला वाले सभी वर्ण, यूआरएल के कोड में बदले गए हों. उदाहरण के लिए, हाइफ़न ("-") के लिए, यूआरएल को कोड में बदलने की ज़रूरत नहीं होती. सामान्य वर्ण, जो URL एनकोडेड होने चाहिए, सलाह लें यूआरएल को कोड में बदलने का तरीका.

• किसी एक पैरामीटर की वैल्यू, कई वैरिएबल से बनाई जा सकती है. यहां दिए गए उदाहरण में, CHECKINDAY,CHECKINMONTH, और CHECKINYEAR वैरिएबल से एक पैरामीटर, checkinDate बनाया गया है:

  <URL>https://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>
  

  इस उदाहरण के नतीजे के तौर पर, यह यूआरएल ऐसा दिख सकता है:

  https://www.partnerdomain.com?checkinDate=7/23/1971
  

• क्वेरी स्ट्रिंग पैरामीटर के नाम के लिए, किसी भी आईडी का इस्तेमाल किया जा सकता है. आपका सर्वर इन वैल्यू को प्रोसेस करता है. हालांकि, पास की जाने वाली वैल्यू उपलब्ध वैरिएबल की सूची देखें.

• उपलब्ध सूची के अलावा, ज़्यादा से ज़्यादा पांच कस्टम वैरिएबल का इस्तेमाल किया जा सकता है वैरिएबल.