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

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

खास जानकारी

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

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

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

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

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

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

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

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

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

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

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

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

वैरिएबल सुझाया गया/ज़रूरी नहीं जानकारी
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 का इस्तेमाल करते समय कस्टम फ़ील्ड उपलब्ध नहीं होते हैं.
DATE-TYPE Optional इससे पता चलता है कि उपयोगकर्ता ने डिफ़ॉल्ट तारीख चुनी है या खोज में दी गई कोई खास तारीख. आपको ये वैल्यू दिख सकती हैं:
  • default: उपयोगकर्ता ने होटल के विज्ञापन या मुफ़्त बुकिंग लिंक पर क्लिक किया, जिसमें डिफ़ॉल्ट तारीखों का इस्तेमाल किया गया था.
  • selected: उपयोगकर्ता ने तारीख सेट किए गए होटल के विज्ञापन या मुफ़्त बुकिंग लिंक पर क्लिक किया.
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") पर ले जाता है. अपने आईएटीए नंबर या पहले से तय स्ट्रिंग के फ़ॉर्मैट में बदलाव करने के लिए, अपने तकनीकी खाता मैनेजर (TAM) से संपर्क करें.
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-PAYMENT-ID (सिर्फ़ होटल विज्ञापन के लिए) Recommended (if you use pay-per-stay Google Ads campaigns) होटल में ठहरने पर पैसे चुकाना (पीपीएस) कमीशन प्रोग्राम में शामिल होटलों के लिए, true में शामिल होता है. इस तरह के कमीशन प्रोग्राम false में शामिल हो जाते हैं.
IF-PROMO-CODE Optional अगर उपयोगकर्ता ने उस दर पर क्लिक किया है जो ARI प्रमोशन या दिए गए 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 स्टेटमेंट के कंडिशनल ब्लॉक को खत्म करता है.

आईएफ़-विज्ञापन पर क्लिक का उदाहरण

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

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

<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-सीटीआर-टाइप-होटल का उदाहरण

एक कंडिशनल ब्लॉक बनाया जा सकता है, जो यह जांच करे कि उपयोगकर्ता ने साफ़ तौर पर रूम बंडल के बिना होटल चुना है या नहीं. 'लेन-देन' मैसेज के <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

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

FBL क्लिक वाले खाली CAMPAIGN-ID

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

यूआरएल को बदलने के लिए 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

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

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

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

<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-Terms-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 में किसी होटल कैंपेन में ऑडियंस की सूचियों के लिए बिड मल्टीप्लायर सेट किए जाते हैं, तो USER-LIST-ID के साथ IF-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-पुष्टि का उदाहरण

अगर आपको यह देखना है कि 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>

इस उदाहरण में, अगर यात्रा की योजना में 2 वयस्कों और 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)&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

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

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