Messaggio promozioni

Panoramica

Il messaggio Promotions definisce le regole per le tariffe scontate utilizzando OTA_HotelRateAmountNotifRQ. Per ogni tariffa, vengono valutate le promozioni definite e alla tariffa viene applicato lo sconto massimo consentito. Questo tipo di messaggio è facoltativo e devi definire le promozioni solo se vengono utilizzate nel sistema per applicare gli sconti sulle tariffe.

Puoi combinare le promozioni e applicarle a diversi attributi utente, ad esempio tipi di dispositivo (dispositivo mobile, tablet, computer) e codici paese.

Per esempi di vari scenari relativi alle promozioni, consulta le istruzioni.

Le seguenti sezioni descrivono le linee guida generali, un esempio di base e gli scenari di istruzioni per iniziare ad aggiungere e aggiornare le promozioni.

Linee guida

Questa sezione illustra le linee guida comuni e le istruzioni speciali per impostare le promozioni.

Attieniti alle seguenti linee guida per le promozioni:

Azioni

Elimina
Utilizza un'azione delete nell'elemento <Promotion> per eliminare una singola promozione in base al relativo ID.
Overlay
Utilizza un'azione overlay nell'elemento <HotelPromotions> per sostituire tutte le promozioni per una proprietà.
Delta
Se non viene specificata alcuna azione, vengono aggiunte o sostituite tutte le promozioni specificate in <HotelPromotions>. Se una promozione con questo ID non è mai stata aggiunta o è stata eliminata, viene aggiunta. Se esiste una promozione con questo ID, viene sovrascritta con la nuova definizione.

Generale

  • Può esistere una singola promozione o un insieme di promozioni per ogni proprietà e ogni promozione ha un insieme di condizioni. La promozione può essere applicata solo se le condizioni sono soddisfatte.

  • Se vuoi che una promozione si applichi solo a una data, un tipo di camera o un piano tariffario specifici, specificalo nelle condizioni della promozione. Se la promozione non si applica a una data, un tipo di camera o un piano tariffario specifici, non è necessario impostarli.

  • Ogni promozione è legata a una proprietà specifica. Se utilizzi la stessa promozione per più proprietà, devi inviarla separatamente per ogni proprietà. Per specificare l'identificatore proprietà, utilizza l'attributo hotel_id dell'elemento <HotelPromotions>.

  • Puoi includere fino a 99 promozioni. Contatta il TAM Google se devi includerne altri.

  • Utilizza l'elemento <Stacking> per specificare come combinare le promozioni. Per impostazione predefinita, Google utilizza il tipo di sovrapposizione base, il che significa che la migliore promozione di base idonea viene selezionata e applicata per prima, prima di altre promozioni. Tieni presente che base può essere combinato solo con second o any e non può essere combinato con un altro base o none.

  • Anche se ci sono più promozioni che possono essere applicate insieme, questo stack potrebbe non essere quello che viene utilizzato se c'è un'altra promozione o un unico insieme di promozioni che offre lo sconto maggiore. La promozione (combinazione) con lo sconto maggiore viene applicata alla prenotazione quando sono idonee più promozioni (combinazioni di).

  • Invia un aggiornamento del messaggio Promozioni ogni volta che si verificano cambiamenti che interessano le tue promozioni.

La migliore promozione (o serie di promozioni) viene applicata all'importo di AmountAfterTax. Se viene specificato solo AmountBeforeTax, le promozioni vengono applicate a AmountBeforeTax.

Esempio

Questa sezione fornisce un esempio base di un messaggio Promotions utilizzando elementi obbligatori e facoltativi. Dopo aver preparato il file, invialo a Google tramite un messaggio POST a questo endpoint:

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

Per scoprire di più su come eseguire il push/POST del messaggio, consulta la sezione Push dei messaggi.

Per l'attributo hotel_id di <HotelPromotions>, utilizza l'ID hotel univoco utilizzato nel tuo sistema per identificare la proprietà. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> del feed elenco hotel. La coerenza con il sistema è fondamentale per garantire che Google visualizzi correttamente i dati.

UserCountry consente di elencare le località degli utenti (paesi) idonee per la promozione. Se specificato, solo agli utenti dei paesi elencati viene offerta la tariffa scontata.

Questo esempio mostra come impostare uno sconto del 15% per un soggiorno prolungato per gli utenti negli Stati Uniti e in Italia:

<?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>

Per altri esempi, consulta la sezione Esempi di promozioni.

Procedure

Questa sezione fornisce soluzioni agli scenari che potresti riscontrare durante l'impostazione delle promozioni.

Scenario 1: come aggiungere una promozione scontata per un soggiorno prolungato

Descrizione

Vuoi offrire notti scontate in determinati giorni di un soggiorno prolungato.

Soluzione

Utilizza l'impostazione FreeNights per personalizzare il tipo di sconto applicato in base al numero di notti del soggiorno.

Esempio

Questo esempio mostra come aggiungere uno sconto del 20% per due notti per ogni 7 notti di soggiorno per l'intervallo di date di prenotazione specificato. Per un itinerario di 15 notti, viene applicato uno sconto del 20% su un totale di 4 notti.

<?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>

Scenario 2: come impostare i tipi di dispositivo

Imposta devices per specificare i dispositivi utente idonei per la promozione. Se specificato, la tariffa scontata viene offerta solo agli utenti che utilizzano i dispositivi elencati.

Descrizione

Vuoi specificare il tipo di dispositivo dell'utente idoneo per la promozione.

Soluzione

Imposta il tipo di dispositivo su uno o più dei seguenti valori: desktop, tablet o mobile.

Esempio

Il seguente esempio mostra come specificare uno sconto del 25% per gli utenti di dispositivi mobili e tablet:

<?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>

Scenario 3: come sostituire la versione precedente con una nuova promozione

Descrizione

L'insieme corrente di promozioni per una proprietà è obsoleto o errato e deve essere sostituito con un insieme completamente nuovo.

Soluzione

Utilizza l'azione overlay per sostituire le promozioni.

Esempio

L'esempio seguente mostra i due sconti originali del 20% e del 30% per la proprietà.

<?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>

Questo esempio mostra come utilizzare overlay per sostituire le due promozioni esistenti con un'unica promozione del 15% di sconto per la proprietà.

<?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>

Scenario 4: come rimuovere una o tutte le promozioni

Descrizione

Vuoi rimuovere una o tutte le promozioni (senza sostituzione) perché la proprietà ha rimosso tutte le sue promozioni senza impostarne di nuove oppure hai commesso un errore e devi correggerle.

Soluzione

Utilizza l'azione delete se vuoi eliminare solo promozioni individuali specifiche di una proprietà e utilizza l'azione overlay (non delete) per rimuovere tutte le promozioni esistenti senza sostituzione.

Per maggiori dettagli su come sostituire le promozioni utilizzando overlay, consulta lo Scenario 3.

Samples

Il seguente esempio mostra come eliminare una sola promozione per una proprietà:

<?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>

Questo esempio mostra come rimuovere tutte le promozioni senza sostituire una proprietà:

<?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>

Scenario 5: come impilare le promozioni

L'elenco sovrapposto specifica come combinare le promozioni. Se non specificato, si presume che type sia base, il che significa che la migliore promozione di base idonea viene selezionata e applicata per prima, prima di altre promozioni. Quando l'attributo type di Stacking è any, può essere combinato con qualsiasi altra promozione.

Descrizione

Vuoi che l'utente abbia la possibilità di utilizzare più promozioni contemporaneamente per la stessa proprietà.

Soluzione

Utilizza lo stacking per impostare più sconti per proprietà. Uno stack può avere al massimo un base e un second, ma un numero illimitato di any e any può essere combinato con gli altri tipi tranne none.

Esempio

Questo esempio mostra come impilare i tipi di sovrapposizione base, second e any. Per uno sconto combinato del 15%, 25% e 10%, un prezzo di 100 $corrisponde a un totale di 57,38 $ (100 × 0,85 × 0,75 × 0,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>

Tieni presente che lo sconto combinato per le promozioni sovrapposte da 1 a 3 è migliore rispetto allo sconto per la promozione 4. La promozione 4 non può essere combinata con altre promozioni a causa del suo tipo di sovrapposizione (none). Se la promozione 4 prevedeva uno sconto del 43% o superiore, verrà utilizzata al posto della combinazione delle promozioni da 1 a 3.