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

खास जानकारी

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

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

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

नीचे दिए गए सेक्शन में सामान्य दिशा-निर्देश, एक बुनियादी उदाहरण, और 'कैसे करें' निर्देशों के बारे में बताया गया है इन स्थितियों के बारे में बताएं.

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

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

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

कार्रवाइयां

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

सामान्य

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

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

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

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

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

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

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

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

उदाहरण

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

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>

इसके बाद, यह सैंपल दिखाता है कि मौजूदा यूआरएल को बदलने के लिए, 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 माना जाता है. इसका मतलब है कि ज़रूरी शर्तें पूरी करने वाला सबसे अच्छा बेस प्रमोशन प्रमोशन को चुना जाएगा और अन्य प्रमोशन से पहले लागू किया जाएगा. जब type एट्रिब्यूट कुल Stacking, 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>

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