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

होटल विज्ञापनों और मुफ़्त बुकिंग लिंक में, ऐसे लैंडिंग पेजों के लिंक शामिल होते हैं जहां लोग कमरे बुक कर सकते हैं. यह तय किया जा सकता है कि 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, वैरिएबल की जगह असल वैल्यू का इस्तेमाल करता है. इससे यह पक्का होता है कि यूआरएल में डाइनैमिक जानकारी शामिल है. उदाहरण के लिए, अगर कोई व्यक्ति 23 मई, 2023 को होटल #42 में छह रातों के लिए कमरा बुक करता है, तो 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> एलिमेंट की वैल्यू होती है. रूम बंडल के लिए, पैकेज आईडी <PackageID> एलिमेंट की वैल्यू होती है. यह वैल्यू, लेन-देन वाले मैसेज के <RoomBundle> या <PackageData> ब्लॉक में होती है.
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 है, तो इस शर्त का पालन करने वाली वैल्यू यूआरएल में डाली जाती हैं. अगर ऐसा नहीं है, तो 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 अगर उपयोगकर्ता ने उपलब्धता, किराया, और इन्वेंट्री के प्रमोशन पर आधारित किराये या दिए गए 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 का उदाहरण

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

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

<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- के नियम के आईडी का उदाहरण

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

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

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

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