Messaggio promozioni

Panoramica

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

Puoi combinare le promozioni e applicarle a diversi attributi utente, come i tipi di dispositivo (dispositivi mobili, tablet, computer) e i codici paese.

Punto chiave: quando a tariffe di prodotti specifici (tipo di camera + piano tariffario + occupazione) si applicano più promozioni, l'utente riceve la promozione o la combinazione di promozioni più economica consentita e gli sconti vengono applicati automaticamente.

Per esempi di vari scenari relativi alle promozioni, consulta la sezione Procedure.

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

Linee guida

Questa sezione tratta le linee guida comuni e le istruzioni speciali per l'impostazione delle promozioni.

Segui queste linee guida per le promozioni:

Azioni

Elimina

Utilizza un'azione delete nell'elemento <Promotion> per eliminare una singola promozione in base al suo ID.

Overlay

Utilizza un'azione overlay nell'elemento <HotelPromotions> per sostituire tutte le promozioni per una proprietà.

Delta

Se non viene specificata alcuna azione, tutte le promozioni specificate all'interno di <HotelPromotions> vengono aggiunte o sostituite. 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

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

• Le promozioni si applicano alla tariffa dell'itinerario. Non è possibile impostare uno sconto massimo per occupante.

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

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

• Puoi includere fino a 99 promozioni. Contatta il tuo TAM Google se devi includere più di questo.

• Utilizza l'elemento <Stacking> per specificare in che modo possono essere combinate le promozioni. Per impostazione predefinita, Google utilizza il tipo di baseimpilamento, il che significa che la migliore promozione di base idonea viene selezionata e applicata per prima, prima delle 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 è presente una pila di diverse promozioni che possono essere applicate insieme, questa pila potrebbe non essere quella utilizzata se esiste un'altra singola promozione o pila di promozioni che offre uno sconto maggiore. La promozione (combinazione) con lo sconto più elevato viene applicata alla prenotazione quando sono idonee più promozioni (combinazioni).

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

  Punto chiave :esiste un limite di 500 promozioni per proprietà. Puoi utilizzare il messaggio <Promotions> per rimuovere le promozioni da una proprietà.

Relativi alle imposte

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

Esempio

Questa sezione fornisce un esempio di base di un messaggio contenente promozioni che utilizza 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 Push dei messaggi.

Punto chiave: invia a Google un messaggio promozionale aggiornato ogni volta che le tue promozioni cambiano.

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

UserCountry è per elencare le località degli utenti (paesi) idonee per la promozione. Se specificato, la tariffa scontata viene offerta solo agli utenti che si trovano nei paesi inseriti nell'elenco.

Nota :l'impostazione di un codice paese è facoltativa e, se non specificato, la tariffa scontata viene offerta agli utenti di qualsiasi paese.

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 a scenari che potresti incontrare durante l'impostazione delle promozioni.

Scenario 1: come aggiungere una promozione con sconto per soggiorni prolungati

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 di soggiorno.

Esempio

Questo esempio mostra come aggiungere uno sconto del 20% per due notti ogni sette notti di soggiorno per l'intervallo specificato di date di prenotazione. Per un itinerario di 15 notti, viene applicato uno sconto del 20% a 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 alla promozione. Se specificato, la tariffa scontata viene offerta solo agli utenti che utilizzano i dispositivi inseriti nell'elenco.

Nota: se non specificato, la tariffa scontata viene offerta agli utenti che utilizzano qualsiasi dispositivo.

Descrizione

Vuoi specificare il tipo di dispositivo utente idoneo alla 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 le promozioni precedenti con quelle nuove

Descrizione

L'attuale insieme 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.

Nota :l'utilizzo di overlay (anziché di singoli delete) è il modo consigliato per sovrascrivere tutte le promozioni per una proprietà. Utilizza l'azione delete se vuoi eliminare solo promozioni specifiche per una proprietà.

Esempio

L'esempio seguente mostra gli 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 una singola promozione con uno sconto del 15% 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 correggerlo.

Soluzione

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

Nota: l'utilizzo di overlay (anziché delle singole azioni delete) è il modo consigliato per sovrascrivere tutte le promozioni per una proprietà.

Per informazioni dettagliate su come sostituire le promozioni utilizzando overlay, vedi Scenario 3.

Esempi

Il seguente esempio mostra come eliminare una sola promozione relativa a 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 sostituzione 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" action="overlay"/>
</Promotions>

Scenario 5: come combinare le promozioni

La combinazione specifica in che modo possono essere combinate 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 delle altre promozioni. Quando l'attributo type di Stacking è any, può essere combinato con qualsiasi altra promozione.

Nota: quando sono idonee più combinazioni di promozioni, alla prenotazione viene applicata la promozione (o la combinazione) con lo sconto maggiore.

Descrizione

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

Soluzione

Utilizza la combinazione per impostare più sconti per proprietà. Uno stack può avere al massimo un base e un second, ma un numero illimitato di any; inoltre, any può essere combinato con gli altri tipi, ad eccezione di none.

Esempio

Questo esempio mostra come impilare i tipi di stacking base, second e any. Per uno sconto combinato del 15%, 25%, 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 in sequenza da 1 a 3 è migliore dello sconto per la promozione 4. La promozione 4 non può essere combinata con altre promozioni a causa del tipo di accumulo (none). Se la promozione 4 avesse uno sconto del 43% o superiore, verrebbe utilizzata al posto della combinazione delle promozioni da 1 a 3.