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

होटल विज्ञापनों और मुफ़्त बुकिंग लिंक में, लैंडिंग पेजों के लिंक शामिल होते हैं. इन पेजों पर जाकर लोग कमरे बुक कर सकते हैं. आपके पास यह तय करने का विकल्प होता है कि 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 वैरिएबल निकाले जाते हैं. अन्य वैरिएबल का हिसाब, उपयोगकर्ता की स्थान-भाषा और क्लाइंट की अन्य सेटिंग के आधार पर लगाया जाता है.

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

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

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

वैरिएबल सुझाया गया/ज़रूरी नहीं है ब्यौरा
ADVANCE-BOOKING-WINDOW Optional चेक-इन करने की तारीख से पहले, बुकिंग के समय होटल के टाइमज़ोन के हिसाब से, बुकिंग के लिए उपलब्ध दिनों की संख्या. उदाहरण के लिए, 36.
ALTERNATE-HOTEL-ID Recommended (if you have separate IDs to identify properties versus booking engines) आपकी प्रॉपर्टी के लिए एक वैकल्पिक पहचानकर्ता. यह एट्रिब्यूट का नाम, आपके होटल सूची फ़ीड में दिया गया है. अलग-अलग आईडी होने से तब फ़ायदा होता है, जब आपको फ़ीड की जानकारी के लिए एक प्रॉपर्टी आइडेंटिफ़ायर और बुकिंग इंजन के लिए दूसरा प्रॉपर्टी आइडेंटिफ़ायर चाहिए.
CAMPAIGN-ID Recommended उस Google Ads कैंपेन का आईडी जिसे आपको यूआरएल से जोड़ना है. अगर क्लिक, Google Ads कैंपेन से नहीं जुड़ा है, तो यह खाली होता है.
CHECKINDAY Recommended होटल के किराये वाले फ़ीड के <Checkin> एलिमेंट में बताया गया दो अंकों वाला दिन. उदाहरण के लिए, 20.
CHECKINDAY-OF-WEEK Optional हफ़्ते का वह दिन —Monday से Sunday, जब होटल के टाइमज़ोन के हिसाब से चेक-इन किया जाता है. उदाहरण के लिए, Tuesday.
CHECKINMONTH Recommended महीना, दो अंकों में. यह Hotel Price Feed के <Checkin> एलिमेंट में तय किया जाता है. उदाहरण के लिए, 05.
CHECKINYEAR Recommended होटल के किराये के फ़ीड के <Checkin> एलिमेंट में बताया गया साल, चार अंकों में. उदाहरण के लिए, 2023.
CHECKOUTDAY Recommended यह दो अंकों वाला दिन है. इसका हिसाब, होटल के किराये की जानकारी वाले फ़ीड के <Nights> और <Checkin> एलिमेंट से लगाया जाता है. उदाहरण के लिए, 26.
CHECKOUTMONTH Recommended यह दो अंकों वाला महीना है. इसका हिसाब, होटल के किराये की जानकारी वाले फ़ीड के <Nights> और <Checkin> एलिमेंट से लगाया जाता है. उदाहरण के लिए, 05.
CHECKOUTYEAR Recommended यह चार अंकों वाला साल है. इसे होटल के किराये की जानकारी वाले फ़ीड के <Nights> और <Checkin> एलिमेंट से कैलकुलेट किया जाता है. उदाहरण के लिए, 2023.
CHILD-AGE Recommended (must be provided for child occupancy pricing) हर बच्चे की ज़्यादा से ज़्यादा उम्र, जैसा कि कीमत वाले फ़ीड के <Child "age"> एलिमेंट में बताया गया है. इस वैरिएबल का इस्तेमाल, FOR-EACH-CHILD-AGE कंडीशनल ब्लॉक के साथ किया जाना चाहिए.
CHILD-INDEX Optional यह लूप वैरिएबल, इंडेक्स किए गए 0 से शुरू होता है. यह हर बच्चे के लिए काउंटर दिखाता है. साथ ही, यात्रा की योजना में शामिल हर बच्चे की उम्र की जानकारी देता है. हालांकि, यह ज़रूरी नहीं है, लेकिन इस वैरिएबल का इस्तेमाल सिर्फ़ FOR-EACH-CHILD-AGE कंडीशनल ब्लॉक के साथ किया जा सकता है.
CLICK-TYPE Optional इससे पता चलता है कि उपयोगकर्ता ने स्टैंडर्ड होटल के किराये वाली लिस्टिंग पर क्लिक किया है या रूम बंडल पर. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • hotel: उपयोगकर्ता ने स्टैंडर्ड रूम के किराये के लिए दिखाई गई लिस्टिंग पर क्लिक किया.
  • room: उपयोगकर्ता ने रूम बंडल की लिस्टिंग पर क्लिक किया.
CLOSE-RATE-RULE-IDS Optional (only applies if you are using conditional or private rates) उन किराये के नियमों के आईडी की सूची, जिन्हें कॉमा लगाकर अलग किया गया है. ये ऐसे किराये हैं जो उपलब्ध नहीं थे. हालांकि, अगर उपयोगकर्ता ने कोई छोटी कार्रवाई की होती, तो ये उपलब्ध हो सकते थे. ध्यान दें कि निजी किराये के लिए, किराये से जुड़े नियम के आईडी हमेशा यहां दिखते हैं. ऐसा तब होता है, जब उपयोगकर्ता को इससे जुड़ा यूज़र इंटरफ़ेस (यूआई) दिखाया जाता है.
Optional बंद कर दिया गया है: <Result> एलिमेंट में तय किए गए कस्टम फ़ील्ड की वैल्यू. हर कस्टम फ़ील्ड के लिए, 200 वर्णों की सीमा होती है. ज़्यादा जानकारी के लिए, लेन-देन से जुड़े मैसेज के बारे में खास जानकारी लेख पढ़ें. ARI का इस्तेमाल करते समय, कस्टम फ़ील्ड उपलब्ध नहीं होते. CUSTOM वैरिएबल सिर्फ़ तब दिखते हैं, जब लेन-देन के मैसेज में कीमतें भेजी जाती हैं.

अहम जानकारी: अगर आपको CUSTOM वैरिएबल का इस्तेमाल करना है, तो अपने टेक्निकल खाता मैनेजर (टैम) से संपर्क करें.
DATE-TYPE Optional इससे पता चलता है कि उपयोगकर्ता ने डिफ़ॉल्ट तारीख चुनी है या खोज में दी गई कोई तारीख. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • default: उपयोगकर्ता ने किसी ऐसे होटल विज्ञापन या मुफ़्त बुकिंग लिंक पर क्लिक किया है जिसमें डिफ़ॉल्ट तारीखों का इस्तेमाल किया गया था.
  • selected: उपयोगकर्ता ने तारीखों के साथ सेट किए गए होटल के विज्ञापन या मुफ़्त बुकिंग लिंक पर क्लिक किया.
GOOGLE-ADS-CLICK-SOURCE Optional इससे पता चलता है कि क्लिक का सोर्स Google Ads था. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • bl: पैसे लेकर दिखाए जाने वाले बुकिंग लिंक
  • tpa: यात्रा का प्रमोशन करने वाले विज्ञापन
  • tfsa: Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड
  • pm: परफ़ॉर्मेंस मैक्स कैंपेन या यात्रा के लक्ष्यों के लिए परफ़ॉर्मेंस मैक्स कैंपेन.

    • ध्यान दें: अगर क्लिक Google Ads के बजाय Google Search से मिला है, तो यह पैरामीटर खाली होता है
GOOGLE-SITE Optional वह Google प्रॉपर्टी जिस पर किसी व्यक्ति ने आपके होटल के किराये का डेटा देखा. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • localuniversal: उपयोगकर्ता को होटल के बुकिंग पेज का लिंक, google.com खोज के ज़रिए मिला.
  • mapresults: उपयोगकर्ता को maps.google.com के ज़रिए होटल का बुकिंग लिंक मिला.
  • verification: Google इस वैल्यू का इस्तेमाल तब करता है, जब वह आपकी साइट पर डेटा क्वालिटी की जांच अपने-आप करता है. इन क्वेरी के लिए आपसे कोई शुल्क नहीं लिया जाता. Google Analytics इस पैरामीटर और इसकी वैल्यू का इस्तेमाल, होटल विज्ञापन के लिए अपने-आप होने वाली पुष्टि के ट्रैफ़िक की पहचान करने के लिए कर सकता है.
  • unknown: उपयोगकर्ता को विज्ञापन या मुफ़्त बुकिंग लिंक, किसी ऐसे सोर्स से मिला है जिसके बारे में पता नहीं है.
LENGTH Recommended होटल के किराये के फ़ीड में <Nights> एलिमेंट से तय की गई, होटल में रात बिताने की संख्या के हिसाब से ठहरने की अवधि. उदाहरण के लिए, 3.
MODIFICATION-IDS Optional

अगर एआरआई किराये में बदलाव का इस्तेमाल किया जाता है, तो इस वैरिएबल की वैल्यू, किराये में बदलाव के मैसेज का id एट्रिब्यूट होती है. अगर किराये में एक से ज़्यादा बार बदलाव किया गया है, तो यह कॉमा लगाकर अलग की गई लिस्ट होती है. इसमें बदलाव के आईडी किसी भी क्रम में दिए जा सकते हैं.
NUM-ADULTS Recommended (must be used with the NUM-CHILDREN or FOR-EACH-CHILD-AGE condition) उपयोगकर्ता ने यात्रा की योजना के लिए, वयस्कों की संख्या तय की है. इस वैरिएबल का इस्तेमाल NUM-CHILDREN, FOR-EACH-CHILD-AGE या दोनों के साथ किया जाना चाहिए.
NUM-CHILDREN Recommended उपयोगकर्ता ने यात्रा कार्यक्रम में 0 से 17 साल की उम्र के बच्चों की संख्या बताई है. NUM-CHILDREN, FOR-EACH-CHILD-AGE या दोनों में से किसी एक को शामिल करना ज़रूरी है, ताकि बच्चों के साथ यात्रा करने वाले लोग, यात्रा की योजना में शामिल हो सकें.
NUM-GUESTS Recommended (if you don't send child occupancy pricing) उपयोगकर्ता ने यात्रा की योजना के लिए, वयस्कों और बच्चों की कुल संख्या बताई है. यह वैल्यू, NUM-ADULTS और NUM-CHILDREN वैल्यू का योग होती है. ज़्यादा से ज़्यादा लोगों की भागीदारी बढ़ाने के लिए, हमारा सुझाव है कि आप NUM-ADULTS और NUM-CHILDREN, दोनों का इस्तेमाल करें.
PACKAGE-ID Recommended (applies if you use Room Bundles) होटल के किराये की जानकारी वाले फ़ीड में पैकेज के लिए यूनीक आइडेंटिफ़ायर. स्टैंडर्ड पैकेज के लिए, पैकेज आईडी, <Result> ब्लॉक में मौजूद <PackageID> एलिमेंट की वैल्यू होती है. रूम बंडल के लिए, पैकेज आईडी, लेन-देन के मैसेज में मौजूद <RoomBundle> या <PackageData> ब्लॉक में मौजूद <PackageID> एलिमेंट की वैल्यू होती है.
PARTNER-CURRENCY Optional होटल के किराये वाले फ़ीड में, <Baserate> एलिमेंट के currency एट्रिब्यूट से तय किया गया तीन अक्षरों वाला करंसी कोड. उदाहरण के लिए, USD या CAD .
PARTNER-HOTEL-ID Recommended यह होटल का यूनीक आइडेंटिफ़ायर होता है. इसे होटल सूची फ़ीड में मौजूद <id> एलिमेंट से तय किया जाता है.
PARTNER-ROOM-ID Recommended (applies if you use Room Bundles) Hotel Price Feed में कमरे के लिए यूनीक आइडेंटिफ़ायर. किसी स्टैंडर्ड रूम के लिए, रूम आईडी, <Result> ब्लॉक में मौजूद <RoomID> एलिमेंट की वैल्यू होती है. रूम बंडल के लिए, रूम आईडी वह वैल्यू होती है जो लेन-देन के मैसेज में <RoomBundle> या <RoomData> ब्लॉक में मौजूद <RoomID> एलिमेंट को असाइन की जाती है.
Optional (only applies to Ads) बंद कर दिया गया है: कमीशन इकट्ठा करने वाली किसी एजेंसी का इस्तेमाल करने पर, यह आपको पहले से तय स्ट्रिंग commission या उस आईएटीए नंबर (उदाहरण के लिए, "01234567") पर ले जाती है जिसे Google ने असाइन किया है. अपने आईएटीए नंबर या पहले से तय स्ट्रिंग के फ़ॉर्मैट में बदलाव करने के लिए, अपने टेक्निकल अकाउंट मैनेजर (टीएएम) से संपर्क करें.
PRICE-DISPLAYED-TAX (Optional) टैक्स की वह रकम जो उपयोगकर्ता को उसकी स्थानीय मुद्रा में दिखाई जाती है. PRICE-DISPLAYED-TAX की वैल्यू, होटल के किराये वाले फ़ीड में मौजूद <Tax> एलिमेंट की वैल्यू होती है. उदाहरण के लिए, "3.14".
PRICE-DISPLAYED-TOTAL (Optional) कमरे का कुल किराया, जो उपयोगकर्ता को उसकी स्थानीय मुद्रा में दिखाया जाता है. PRICE-DISPLAYED-TOTAL की वैल्यू, होटल के किराये से जुड़े फ़ीड में मौजूद <Baserate>, <Tax>, और <OtherFees> एलिमेंट की वैल्यू का योग होती है. उदाहरण के लिए, "152.13".
PROMO-CODE (Optional)

अगर ARI प्रमोशन का इस्तेमाल किया जाता है, तो इस वैरिएबल की वैल्यू, लागू किए गए <Promotion> के id एट्रिब्यूट को असाइन की जाती है. अगर एक से ज़्यादा प्रमोशन लागू किए जाते हैं, तो यह प्रमोशन आईडी की कॉमा लगाकर अलग की गई सूची होती है. इसमें प्रमोशन आईडी किसी भी क्रम में हो सकते हैं.

अगर किराये के नियमों का इस्तेमाल किया जाता है, तो इस वैरिएबल की वैल्यू को PromoCode एलिमेंट को असाइन किया जाता है. ऐसा तब होता है, जब किराये का नियम लागू होता है.
RATE-PLAN-ID Recommended (only applies if you use RoomBundles) कीमत वाले फ़ीड के <RoomBundle> ब्लॉक में मौजूद <RatePlanID> एलिमेंट के हिसाब से आईडी. <RatePlanID>, कमरे और पैकेज के डेटा के कॉम्बिनेशन के लिए यूनीक आइडेंटिफ़ायर दिखाता है. ज़्यादा जानकारी के लिए, मीटिंग रूम के बंडल देखें.
RATE-RULE-ID Recommended (only applies if you use conditional rates or private rates) कीमत वाले फ़ीड के <Rate> ब्लॉक में rate_rule_id एट्रिब्यूट के ज़रिए तय किया गया आईडी. ज़्यादा जानकारी के लिए, खास किराये लेख पढ़ें.

ध्यान दें: सिर्फ़ शर्तों के साथ तय किए गए किराये या निजी तौर पर तय किए गए ऐसे किराये दिखाए जाते हैं जिन्हें छिपाया नहीं गया है.
USER-COUNTRY Recommended दो अक्षरों वाला देश का कोड, जिससे उपयोगकर्ता की जगह की जानकारी मिलती है. यह जानकारी, उपयोगकर्ता की क्लाइंट सेटिंग से निकाली जाती है. उदाहरण के लिए, US या FR.
USER-CURRENCY Recommended तीन अक्षर वाला मुद्रा कोड, जिससे उपयोगकर्ता की स्थानीय मुद्रा का पता चलता है. USER-CURRENCY वैरिएबल की वैल्यू का अनुमान, उपयोगकर्ता की क्लाइंट सेटिंग से लगाया जाता है. उदाहरण के लिए, USD या CAD .
USER-DEVICE Recommended उपयोगकर्ता के डिवाइस का टाइप. USER-DEVICE की वैल्यू इनमें से कोई एक हो सकती है:
  • mobile
  • tablet
  • desktop
  • unknown

USER-DEVICE वैरिएबल की वैल्यू का अनुमान, उपयोगकर्ता की क्लाइंट सेटिंग से लगाया जाता है.
USER-LANGUAGE Recommended दो अक्षरों वाला ISO 639-1 भाषा कोड, जिससे यह पता चलता है कि विज्ञापन या मुफ़्त बुकिंग लिंक किस भाषा में दिखाया गया है. USER-LANGUAGE वैरिएबल की वैल्यू का अनुमान, उपयोगकर्ता की क्लाइंट सेटिंग से लगाया जाता है. उदाहरण के लिए, en या fr.
USER-LIST-ID (Google Ads में तय किया गया) Optional (only applies if you use Audience Lists in Google Ads) Google Ads की उपयोगकर्ता सूची का वह आईडी जिसमें ऑडियंस की सूची या उपयोगकर्ता की जानकारी शामिल होती है. ऑडियंस की सूचियों का इस्तेमाल, बिड घटाने या बढ़ाने की सेटिंग के आधार पर किया जाता है. अगर उपयोगकर्ता एक से ज़्यादा ऑडियंस की सूचियों का हिस्सा है, तो बिड को सबसे ज़्यादा घटाने या बढ़ाने की सेटिंग वाली ऑडियंस की सूची को चुना जाता है. जिन ऑडियंस के लिए सबसे ज़्यादा बोली घटाने या बढ़ाने की सेटिंग का इस्तेमाल किया गया है उनमें से किसी एक को चुनने का फ़ैसला अपने-आप होता है.
VERIFICATION Optional यह बूलियन पुष्टि करता है कि लिंक को Google ने टेस्टिंग या अपने-आप होने वाली पुष्टि के लिए जनरेट किया है या नहीं. अगर लिंक को Google ने टेस्टिंग या अपने-आप पुष्टि करने के लिए जनरेट किया है, तो इसकी वैल्यू true होती है. इसके अलावा, इसकी वैल्यू false होती है.

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

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

शर्त के हिसाब से लॉजिक लागू करने की सुविधा, इन स्टेटमेंट के साथ काम करती है:

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

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

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

शर्त सुझाया गया/ज़रूरी नहीं है ब्यौरा
IF-AD-CLICK (सिर्फ़ होटल विज्ञापन के लिए) Optional अगर उपयोगकर्ता ने विज्ञापन पर क्लिक किया है, तो यह true पर सेट हो जाता है. अगर उपयोगकर्ता ने मुफ़्त में दिखाई जाने वाली बुकिंग के लिंक पर क्लिक किया है, तो यह false पर सेट हो जाता है.
IF-CLICK-TYPE-HOTEL Optional अगर उपयोगकर्ता ने किसी होटल की लिस्टिंग पर क्लिक किया है, तो यह true पर सेट हो जाता है. अगर ऐसा नहीं है, तो यह false पर सेट हो जाता है.
IF-CLICK-TYPE-ROOM Optional अगर उपयोगकर्ता ने रूम बंडल के विज्ञापन पर क्लिक किया है, तो यह true पर सेट हो जाता है. ऐसा न होने पर, यह false पर सेट हो जाता है.
IF-CLOSE-RATE-RULE-IDS Optional अगर उपयोगकर्ता ज़रूरी शर्तें पूरी नहीं करता है, तो एक या उससे ज़्यादा शर्तों के हिसाब से तय किए गए किराये उपलब्ध नहीं होंगे. ऐसे में, यह true पर सेट हो जाता है. अगर उपयोगकर्ता ज़रूरी शर्तें पूरी करता है, तो यह false पर सेट हो जाता है. डिफ़ॉल्ट रूप से, यह true होता है. ऐसा तब होता है, जब उपयोगकर्ता को निजी दर वाला यूज़र इंटरफ़ेस (यूआई) दिखाया गया हो.
IF-DEFAULT-RATE Optional अगर उपयोगकर्ता ने होटल की ऐसी लिस्टिंग पर क्लिक किया है जिसमें डिफ़ॉल्ट तारीखों का इस्तेमाल किया गया था, तो यह true पर सेट हो जाता है. अगर ऐसा नहीं है, तो यह false पर सेट हो जाता है.
IF-HOTEL-CAMPAIGN Optional अगर उपयोगकर्ता ने होटल कैंपेन के किसी विज्ञापन पर क्लिक किया है, तो यह true के तौर पर रिज़ॉल्व होता है. ऐसा न होने पर, यह false के तौर पर रिज़ॉल्व होता है. यह अंतर, उन पार्टनर के लिए फ़ायदेमंद है जिनके पास Google Ads में एट्रिब्यूशन असाइन करने के लिए, कई तरह के कैंपेन टाइप मौजूद हैं.
IF-MODIFICATION-IDS Optional अगर उपयोगकर्ता ने ऐसे किराये पर क्लिक किया है जिसमें एआरआई के हिसाब से बदलाव किया गया है, तो इसकी वैल्यू true होती है. ऐसा न होने पर, इसकी वैल्यू false होती है.
(सिर्फ़ होटल विज्ञापन के लिए) Recommended (if you use pay-per-stay Google Ads campaigns) बंद कर दिया गया है: यह, होटल में ठहरने पर पैसे चुकाना (पीपीएस) कमीशन प्रोग्राम में शामिल होटल के लिए true के तौर पर दिखता है. इसके अलावा, यह false के तौर पर दिखता है.
IF-PROMO-CODE Optional अगर उपयोगकर्ता ने एआरआई प्रमोशन या PromoCode के साथ किराये के नियम पर आधारित किसी कीमत पर क्लिक किया है, तो इसकी वैल्यू true होती है. ऐसा न होने पर, इसकी वैल्यू false होती है.
IF-PROMOTED (सिर्फ़ होटल विज्ञापन के लिए) Recommended (if you use Promoted hotels) अगर उपयोगकर्ता ने प्रॉपर्टी प्रमोशन विज्ञापन पर क्लिक किया है, तो यह true पर सेट हो जाता है. अगर उपयोगकर्ता ने किसी दूसरे विज्ञापन पर क्लिक किया है, तो यह false पर सेट हो जाता है.
IF-RATE-RULE-ID Optional अगर उपयोगकर्ता ने शर्त के साथ लागू होने वाला किराया चुना है, तो यह true पर सेट हो जाता है. ऐसा न होने पर, यह false पर सेट हो जाता है.
IF-USER-LIST-ID (Google Ads में तय किया गया) Optional अगर उपयोगकर्ता, Google Ads की उस ग्राहक सूची का सदस्य है जिसका आईडी आपने ऑडियंस की सूचियों के लिए बिड मल्टीप्लायर सेट करते समय दिया था, तो यह true के तौर पर रिज़ॉल्व होता है. ऐसा न होने पर, यह false के तौर पर रिज़ॉल्व होता है.
IF-VERIFICATION Optional अगर लिंक को Google ने टेस्टिंग या अपने-आप पुष्टि करने के लिए जनरेट किया है, तो यह true पर रिज़ॉल्व होता है. ऐसा न होने पर, यह false पर रिज़ॉल्व होता है.
ELSE Recommended (if you use any conditional IF statements) अगर पिछली शर्त पूरी नहीं होती है, तो इस शर्त का पालन करने वाली वैल्यू को यूआरएल में डाला जाता है.
END-IF Optional (required if you have any IF conditional statements) IF स्टेटमेंट के कंडीशनल ब्लॉक को खत्म करता है.
FOR-EACH-CHILD-AGE Optional (required for child occupancy pricing) यह फ़ंक्शन, कीमत वाले फ़ीड में मौजूद हर <Child "age"> एलिमेंट के लिए एक बार लागू होता है. उदाहरण के लिए, अगर <OccupancyDetails> में दो एलिमेंट <Child age="17"> और <Child age= "17"> शामिल हैं, तो डायरेक्टिव दो बार लागू होगा.
END-FOR-EACH Optional (required if using FOR-EACH block) FOR-EACH स्टेटमेंट के कंडीशनल ब्लॉक को खत्म करता है.

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 का उदाहरण

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

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

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

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

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>

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

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

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

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

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

एफ़बीएल पर मिले क्लिक के साथ CAMPAIGN-IDs की वैल्यू मौजूद नहीं है

अगर क्लिक, मुफ़्त बुकिंग लिंक से मिला है, तो 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-PROMOTED का उदाहरण (सिर्फ़ होटल विज्ञापन)

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

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

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

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

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

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

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

<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

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

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

यूआरएल बनाते समय ध्यान रखने वाले सामान्य नियम

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

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

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

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

    <!-- 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;" से बदलें

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

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

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

    इस उदाहरण से मिलने वाला यूआरएल कुछ ऐसा दिख सकता है:

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

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

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