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

खास जानकारी

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

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

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

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

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

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

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

कार्रवाइयां

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

सामान्य

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

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

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

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

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

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

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

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

    <Promotions> मैसेज का इस्तेमाल किया जा सकता है.

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

उदाहरण

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

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

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

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

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

<?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 की संख्या पर कोई पाबंदी नहीं है. साथ ही, none को छोड़कर, any को अन्य टाइप के साथ जोड़ा जा सकता है.

नमूना

इस सैंपल में, 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>

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