प्रमोशन से जुड़ा मैसेज

खास जानकारी

प्रमोशन मैसेज में, OTA_HotelRateAmountNotifRQ का इस्तेमाल करके छूट वाली दरों के नियमों के बारे में बताया गया है. हर दर के लिए, तय किए गए प्रमोशन का आकलन किया जाता है और दर पर ज़्यादा से ज़्यादा छूट लागू की जाती है. इस तरह का मैसेज देना ज़रूरी नहीं है. आपको सिर्फ़ तब प्रमोशन सेट करने होंगे, जब आपके सिस्टम में उनका इस्तेमाल दर में छूट लागू करने के लिए किया जाए.

प्रमोशन को एक साथ जोड़कर, उन्हें अलग-अलग उपयोगकर्ता एट्रिब्यूट पर लागू किया जा सकता है. जैसे, डिवाइस के टाइप (मोबाइल, टैबलेट, डेस्कटॉप) और देश के कोड.

प्रमोशन से जुड़ी अलग-अलग स्थितियों के उदाहरणों के लिए, कैसे करें देखें.

नीचे दिए गए सेक्शन में, सामान्य दिशा-निर्देश, एक बुनियादी उदाहरण, और प्रमोशन जोड़ने और अपडेट करने के तरीके बताए गए हैं.

दिशा-निर्देश

इस सेक्शन में प्रमोशन सेट करने के सामान्य दिशा-निर्देशों और खास निर्देशों के बारे में बताया गया है.

प्रमोशन के लिए इन दिशा-निर्देशों का पालन करें:

कार्रवाइयाँ

मिटाएं
किसी प्रमोशन को उसके आईडी से मिटाने के लिए, <Promotion> एलिमेंट में delete कार्रवाई का इस्तेमाल करें.
ओवरले में दिखने वाले विज्ञापन
किसी प्रॉपर्टी के सभी प्रमोशन बदलने के लिए, <HotelPromotions> एलिमेंट में overlay ऐक्शन का इस्तेमाल करें.
Delta
अगर कोई कार्रवाई तय नहीं की जाती है, तो <HotelPromotions> में बताए गए सभी प्रमोशन जोड़ दिए जाते हैं या बदल दिए जाते हैं. अगर उस आईडी वाला प्रमोशन पहले कभी जोड़ा नहीं गया था या मिटा दिया गया था, तो प्रमोशन जोड़ा जाता है. अगर उस आईडी वाला कोई प्रमोशन मौजूद होता है, तो उसे नई परिभाषा से ओवरराइट कर दिया जाता है.

सामान्य

  • हर प्रॉपर्टी के लिए एक या प्रमोशन का सेट हो सकता है और हर प्रमोशन के लिए कुछ शर्तें तय की जाती हैं. यह प्रमोशन सिर्फ़ तब लागू किया जा सकता है, जब शर्तें पूरी हों.

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

  • हर प्रमोशन किसी खास प्रॉपर्टी से जुड़ा होता है. अगर एक से ज़्यादा प्रॉपर्टी के लिए एक ही प्रमोशन का इस्तेमाल किया जाता है, तो आपको हर प्रॉपर्टी के लिए इसे अलग से भेजना होगा. अपने प्रॉपर्टी आइडेंटिफ़ायर की जानकारी देने के लिए, <HotelPromotions> एलिमेंट के hotel_id एट्रिब्यूट का इस्तेमाल करें.

  • ज़्यादा से ज़्यादा 99 प्रमोशन शामिल किए जा सकते हैं. अगर आपको इससे ज़्यादा जानकारी शामिल करनी है, तो अपने Google TAM से संपर्क करें.

  • प्रमोशन को जोड़ने का तरीका बताने के लिए, <Stacking> एलिमेंट का इस्तेमाल करें. डिफ़ॉल्ट रूप से, Google base स्टैकिंग टाइप का इस्तेमाल करता है. इसका मतलब है कि ज़रूरी शर्तें पूरी करने वाले सबसे अच्छे बेस प्रमोशन को ही चुना जाता है और दूसरे प्रमोशन से पहले लागू किया जाता है. ध्यान दें कि base को सिर्फ़ second या any के साथ जोड़ा जा सकता है. इसे दूसरे base या none के साथ नहीं जोड़ा जा सकता.

  • अगर कई प्रमोशन के स्टैक एक साथ लागू किए जा सकते हैं, तब भी हो सकता है कि उस स्टैक का इस्तेमाल तब नहीं किया जाए, जब ज़्यादा छूट देने वाला कोई दूसरा प्रमोशन या प्रमोशन का स्टैक हो. सबसे ज़्यादा छूट वाला प्रमोशन (कॉम्बिनेशन) बुकिंग पर लागू होता है. यह छूट तब लागू होती है, जब एक से ज़्यादा (कई तरह के कॉम्बिनेशन) वाले प्रमोशन की ज़रूरी शर्तें पूरी की जाती हों.

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

सबसे अच्छा प्रमोशन (या प्रमोशन का स्टैक) AmountAfterTax रकम पर लागू होता है. अगर सिर्फ़ AmountBeforeTax तय किया गया है, तो प्रमोशन AmountBeforeTax पर लागू हो जाएंगे.

उदाहरण

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

https://www.google.com/travel/hotels/uploads/promotions

मैसेज को पुश/पोस्ट करने के तरीके के बारे में ज़्यादा जानने के लिए, मैसेज पुश करना देखें.

<HotelPromotions> के hotel_id एट्रिब्यूट के लिए, उस यूनीक होटल आईडी का इस्तेमाल करें जिसे आपने अपने सिस्टम में इस्तेमाल करके, प्रॉपर्टी की पहचान की है. यह वैल्यू, होटल सूची फ़ीड के <listing> एलिमेंट में <id> का इस्तेमाल करके बताए गए होटल आईडी से मेल खानी चाहिए. यह पक्का करने के लिए कि Google आपका डेटा सही तरीके से दिखा रहा है, अपने सिस्टम को लगातार इस्तेमाल करना ज़रूरी है.

UserCountry का इस्तेमाल करके, उन जगहों (देशों) की जानकारी दी जा सकती है जहां उपयोगकर्ता इस प्रमोशन के लिए मंज़ूरी पा सकते हैं. अगर बताया जाता है, तो सिर्फ़ सूची में शामिल देशों के उपयोगकर्ताओं को छूट वाली दर दी जाती है.

इस उदाहरण में, अमेरिका और इटली के उपयोगकर्ताओं के लिए, लंबे समय तक ठहरने पर 15% की छूट सेट करने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123_abc"
            timestamp="2022-05-30T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="IT"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

ज़्यादा उदाहरणों के लिए, प्रमोशन के उदाहरण देखें.

कैसे करें

इस सेक्शन में उन स्थितियों के समाधान दिए गए हैं जिनका आपको प्रमोशन सेट करते समय करना पड़ सकता है.

पहली स्थिति: लंबे समय तक रहने के लिए छूट वाला प्रमोशन जोड़ने का तरीका

ब्यौरा

आपको लंबे समय तक ठहरने के कुछ दिनों के लिए, छूट वाली रातों की सुविधा देनी है.

समस्या का हल

रातों की संख्या के हिसाब से लागू होने वाली छूट के टाइप को पसंद के मुताबिक बनाने के लिए, FreeNights सेटिंग का इस्तेमाल करें.

नमूना

इस सैंपल में बताया गया है कि कैसे बुकिंग की तारीखों की तय सीमा के दौरान, हर सात रातों के लिए दो रातों के लिए 20% की छूट जोड़ी जा सकती है. 15 रातों की यात्रा के लिए, कुल चार रातों की बुकिंग पर 20% की छूट मिलेगी.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-05T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-02-01" end="2022-06-30"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="7"
                    discount_nights="2"
                    discount_percentage="20"
                    night_selection="cheapest"
                    repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

दूसरी स्थिति: डिवाइस के टाइप सेट करने का तरीका

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

ब्यौरा

आपको यह तय करना है कि किस तरह के उपयोगकर्ता डिवाइस प्रमोशन के लिए मंज़ूरी पा सकते हैं.

समस्या का हल

डिवाइस के टाइप को इनमें से एक या इससे ज़्यादा वैल्यू पर सेट करें: desktop, tablet या mobile.

नमूना

नीचे दिए गए नमूने में मोबाइल और टैबलेट उपयोगकर्ताओं के लिए 25% की छूट तय करने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="25"/>
        <Devices>
          <Device type="mobile"/>
          <Device type="tablet"/>
        </Devices>
    </Promotion>
  </HotelPromotions>
</Promotions>

तीसरी स्थिति: पुराने प्रमोशन को नए प्रमोशन से बदलने का तरीका

ब्यौरा

किसी प्रॉपर्टी के लिए प्रमोशन का मौजूदा सेट पुराना या गलत है और उसे पूरी तरह से नए सेट से बदलना होगा.

समस्या का हल

प्रमोशन बदलने के लिए, overlay कार्रवाई का इस्तेमाल करें.

नमूना

नीचे दिए गए नमूने में प्रॉपर्टी पर 20% और 30% की मूल दो छूट दिखाई गई हैं.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
    <Promotion id="2">
      <BookingDates>
        <DateRange start="2022-08-01" end="2022-08-31"/>
      </BookingDates>
      <Discount percentage="30"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

इसके बाद, इस सैंपल में बताया गया है कि प्रॉपर्टी पर 15% की छूट वाले एक प्रमोशन से, मौजूदा दो प्रमोशन को बदलने के लिए, overlay का इस्तेमाल कैसे करें.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-25T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-06-01" end="2022-07-31"/>
      </BookingDates>
      <Discount percentage="15"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

चौथा स्थिति: एक या सभी प्रमोशन हटाने का तरीका

ब्यौरा

आपको एक या सभी प्रमोशन (जिन्हें बदले बिना) हटाना है, क्योंकि प्रॉपर्टी ने नए प्रमोशन सेट किए बिना ही उसके सभी प्रमोशन हटा दिए हैं या आपको कोई गड़बड़ी हुई है और आपको उसे ठीक करना है.

समस्या का हल

अगर आपको किसी प्रॉपर्टी के लिए सिर्फ़ एक खास प्रमोशन मिटाना है, तो delete कार्रवाई का इस्तेमाल करें. साथ ही, बदले गए बिना सभी मौजूदा प्रमोशन हटाने के लिए, overlay (delete नहीं) कार्रवाई का इस्तेमाल करें.

overlay का इस्तेमाल करके प्रमोशन बदलने का तरीका जानने के लिए, तीसरी स्थिति देखें.

सैंपल

नीचे दिए गए सैंपल में, किसी प्रॉपर्टी के सिर्फ़ एक प्रमोशन को मिटाने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

इस सैंपल में, किसी प्रॉपर्टी को बदले बिना सभी प्रमोशन हटाने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>

पांचवीं स्थिति: प्रमोशन को स्टैक करने का तरीका

स्टैकिंग से पता चलता है कि प्रमोशन को कैसे जोड़ा जा सकता है. अगर इसकी जानकारी नहीं दी गई है, तो type को base माना जाता है. इसका मतलब है कि ज़रूरी शर्तें पूरी करने वाले सबसे अच्छे बेस प्रमोशन को चुना जाता है और उसे दूसरे प्रमोशन से पहले लागू किया जाता है. जब Stacking का type एट्रिब्यूट any हो जाता है, तो इसे किसी दूसरे प्रमोशन के साथ इस्तेमाल किया जा सकता है.

ब्यौरा

आपकी इच्छा है कि उपयोगकर्ता को एक ही प्रॉपर्टी के लिए, एक समय पर कई प्रमोशन इस्तेमाल करने का विकल्प मिले.

समस्या का हल

हर प्रॉपर्टी के लिए एक से ज़्यादा छूट सेट करने के लिए, स्टैकिंग का इस्तेमाल करें. किसी स्टैक में ज़्यादा से ज़्यादा एक base और एक second हो सकता है. हालांकि, इसमें any की संख्या अनलिमिटेड हो सकती है. साथ ही, any को none को छोड़कर अन्य टाइप के साथ जोड़ा जा सकता है.

नमूना

इस सैंपल में, base, second, और any स्टैकिंग टाइप को स्टैक करने का तरीका बताया गया है. कुल 15%, 25%, 10% छूट के लिए, 100 डॉलर की कुल कीमत 57.38 डॉलर (100 × .85 × .75 × .9) होगी.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_x"
            id="123"
            timestamp="2022-05-20T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="25"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="40"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

ध्यान दें कि स्टैकिंग प्रमोशन एक से तीन तक के लिए कुल छूट, प्रमोशन 4 पर मिलने वाली छूट से ज़्यादा है. प्रमोशन 4 को इसके स्टैकिंग टाइप (none) की वजह से अन्य प्रमोशन के साथ नहीं जोड़ा जा सकता. अगर प्रमोशन 4 पर 43% या उससे ज़्यादा की छूट है, तो एक से लेकर तीसरे प्रमोशन के कॉम्बिनेशन के बजाय इसका इस्तेमाल किया जाएगा.