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

होटल विज्ञापनों और मुफ़्त बुकिंग लिंक में, लैंडिंग पेजों के लिंक शामिल होते हैं. इन पेजों पर जाकर, उपयोगकर्ता कमरे बुक कर सकते हैं. आपके पास यह तय करने का विकल्प होता है कि 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 होटल के किराये के फ़ीड के <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) किराये के उन नियमों के आईडी की सूची जिनके लिए किराया उपलब्ध नहीं था. हालांकि, अगर उपयोगकर्ता ने कोई छोटी सी कार्रवाई की होती, तो किराया उपलब्ध हो सकता था. ध्यान दें कि जब उपयोगकर्ता को इससे जुड़ा यूज़र इंटरफ़ेस (यूआई) दिखाया जाता है, तो निजी किराये के लिए किराया तय करने के नियम के आईडी, यहां हमेशा अपने-आप भर जाते हैं.
CUSTOM[1-5] Optional <Result> एलिमेंट में तय किए गए कस्टम फ़ील्ड की वैल्यू. हर कस्टम फ़ील्ड के लिए, वैल्यू में 200 वर्ण से ज़्यादा नहीं होने चाहिए. ज़्यादा जानकारी के लिए, लेन-देन से जुड़े मैसेज की खास जानकारी देखें. ARI का इस्तेमाल करते समय, कस्टम फ़ील्ड उपलब्ध नहीं होते.

ध्यान दें: 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, इस पैरामीटर और इसकी वैल्यू का इस्तेमाल, Hotel Ads की ऑटोमेटेड पुष्टि वाले ट्रैफ़िक की पहचान करने के लिए कर सकता है.
  • unknown: उपयोगकर्ता को विज्ञापन या मुफ़्त बुकिंग लिंक, किसी ऐसे सोर्स से मिला है जिसकी पहचान नहीं की जा सकी.
LENGTH Recommended होटल में ठहरने की अवधि, रातों की संख्या के हिसाब से तय की जाती है. यह अवधि, होटल के किराये के फ़ीड में मौजूद <Nights> एलिमेंट से तय होती है. उदाहरण के लिए, 3.
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) होटल की कीमत वाले फ़ीड में, कमरे का यूनीक आइडेंटिफ़ायर. किसी स्टैंडर्ड रूम के लिए, रूम आईडी, <Result> ब्लॉक में मौजूद <RoomID> एलिमेंट की वैल्यू होती है. रूम बंडल के लिए, रूम आईडी वह वैल्यू होती है जो लेन-देन मैसेज में, <RoomBundle> या <RoomData> ब्लॉक में मौजूद <RoomID> एलिमेंट को असाइन की जाती है.
PAYMENT-ID Optional (only applies to Ads) अगर आपने कमीशन इकट्ठा करने वाली किसी एजेंसी का इस्तेमाल किया है, तो यह आपको पहले से तय स्ट्रिंग commission या Google के असाइन किए गए आईएटीए नंबर (उदाहरण के लिए, "01234567") पर ले जाती है. अपने आईएटीए नंबर या पहले से तय स्ट्रिंग के फ़ॉर्मैट में बदलाव करने के लिए, अपने तकनीकी खाता मैनेजर (टीएम) से संपर्क करें.
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)

अगर एआरआई प्रमोशन का इस्तेमाल किया जाता है, तो इस वैरिएबल की वैल्यू, लागू किए गए <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 है, तो इस शर्त के बाद वाली वैल्यू को यूआरएल में डाला जाता है. अगर true नहीं है, तो ELSE डायरेक्टिव के बाद वाली वैल्यू को डाला जाता है.

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

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

शर्त सुझाया गया/ज़रूरी नहीं ब्यौरा
IF-AD-CLICK (सिर्फ़ Hotel Ads के लिए) 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-PAYMENT-ID (सिर्फ़ Hotel Ads के लिए) Recommended (if you use pay-per-stay Google Ads campaigns) यह पैसे चुकाकर ठहरने (पीपीएस) के कमीशन प्रोग्राम में शामिल होटलों के लिए true पर सेट होता है. इसके अलावा, यह false पर सेट होता है.
IF-PROMO-CODE Optional अगर उपयोगकर्ता ने किसी ऐसे किराये पर क्लिक किया है जो खास किराये के प्रमोशन या किसी PromoCode के साथ दिए गए किराये के नियम पर आधारित है, तो यह true पर सेट हो जाता है. अगर ऐसा नहीं है, तो यह false पर सेट हो जाता है.
IF-PROMOTED (सिर्फ़ Hotel Ads के लिए) 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 पर सेट हो जाता है. अगर उपयोगकर्ता, ऑडियंस सूचियों के लिए बिड मल्टीप्लायर सेट करते समय बताए गए Google Ads ग्राहक सूची आईडी का सदस्य नहीं है, तो यह 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 का उदाहरण

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

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

<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>

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

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 कंडीशनल स्टेटमेंट का इस्तेमाल करके, यूआरएल में बदलाव करें. यह बदलाव इस आधार पर किया जाता है कि क्लिक, पीपीएस कमीशन प्रोग्राम का नतीजा है या नहीं. यहां दिए गए उदाहरण में, यह जांच की जाती है कि क्लिक पीपीएस कमीशन प्रोग्राम से आया है या नहीं. साथ ही, नतीजे के आधार पर 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&amp;booking_source=commissions
  • अगर Google को कोई आईएटीए नंबर असाइन किया गया है, तो:
    https://partner.com?hid=123&amp;booking_source=01234567

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

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

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 में होटल कैंपेन में ऑडियंस की सूचियों के लिए बिड मल्टीप्लायर सेट किए हैं, तो किसी 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

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

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

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