Messaggio promozioni

Panoramica

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

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

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

Per esempi di vari scenari relativi alle promozioni, consulta Istruzioni.

Le seguenti sezioni trattano le linee guida generali, un esempio di base e le procedure diversi per aiutarti ad aggiungere e aggiornare le promozioni.

Linee guida

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

Attieniti alle seguenti linee guida per le promozioni:

Azioni

Elimina

Utilizza un'azione delete nell'elemento <Promotion> per eliminare un singolo 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 specificate tutte le promozioni in <HotelPromotions> vengono aggiunti o sostituiti. Se una promozione con questo ID non è mai stato aggiunto o è stato eliminato, la promozione viene aggiunta. Se una promozione con questo ID esistente, viene sovrascritta con la nuova definizione.

Generale

• Ci può essere una singola promozione o un insieme di promozioni per ogni proprietà e ogni la promozione prevede una serie di condizioni. La promozione può essere applicata solo se siano soddisfatte.

• Se vuoi che una promozione si applichi solo a una data, a un tipo di camera o a un piano tariffario specifico, specificalo 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 è legata a una proprietà specifica. Se utilizzi la stessa promozione per più proprietà, devi inviarlo separatamente per ogni proprietà. A specifica l'identificatore della proprietà, usa l'attributo hotel_id del Elemento <HotelPromotions>.

• Puoi includere fino a 99 promozioni. Contatta il tuo TAM Google in caso di necessità includere più di questo.

• Utilizza l'elemento <Stacking> per specificare come è possibile combinare le promozioni. Di predefinita, Google usa il tipo di sovrapposizione base, il che significa che il migliore la promozione di base sia selezionata e applicata per primo, prima delle altre promozioni. Nota 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 serie di promozioni che possono essere applicate insieme, potrebbe non essere quello utilizzato se c'è un altro una singola promozione o un gruppo di promozioni che offre lo sconto maggiore. La la promozione (combinazione) con lo sconto maggiore viene applicata alla prenotazione quando più (combinazioni di) promozioni sono idonee.

• 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 lo <Promotions> messaggio per rimuovere le promozioni da una proprietà.

Fisco

La promozione migliore (o lo stack di promozioni) viene applicata a AmountAfterTax importo. Se viene specificato solo AmountBeforeTax, le promozioni verranno applicata a AmountBeforeTax.

Esempio

Questa sezione fornisce un esempio base di messaggio Promozioni che utilizza l'attributo 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 ulteriori informazioni su come eseguire il push/POST del messaggio, vedi Eseguire il push dei messaggi.

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

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

UserCountry consente di elencare le località degli utenti (paesi) idonee per la promozione. Se specificato, solo gli utenti nei paesi elencati vengono offriva la tariffa scontata.

Nota: l'impostazione di un codice paese è facoltativa e, se non specificato, gli utenti di la tariffa scontata è offerta in 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, vedi Esempi di promozioni.

Procedure

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

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

Descrizione

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

Soluzione

Utilizza l'impostazione FreeNights per personalizzare il tipo di sconto applicato a seconda sul numero di notti di soggiorno.

Esempio

Questo esempio mostra come aggiungere uno sconto del 20% per due notti ogni 7 notti ha soggiornato per l'intervallo di date di prenotazione specificato. Per un itinerario di 15 notti, una Lo sconto del 20% si applica per 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 promozione. Se specificato, vengono offerti solo gli utenti che usano i dispositivi elencati la tariffa scontata.

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

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

L'esempio seguente 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 vecchia promozione con nuove promozioni

Descrizione

L'insieme corrente di promozioni per una proprietà è obsoleto o non corretto e deve essere da sostituire con un insieme completamente nuovo.

Soluzione

Utilizza l'azione overlay per sostituire le promozioni.

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

Esempio

L'esempio seguente mostra i due sconti originali del 20% e 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 lo stato esistente due promozioni con una singola promozione del 15% di sconto per la struttura.

<?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é proprietà ha rimosso tutte le sue promozioni senza impostarne di nuove oppure hai fatto un errore e devi correggerlo.

Soluzione

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

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

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

Esempi

L'esempio seguente 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 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 sovrapporre le promozioni

L'impilamento specifica in che modo è possibile combinare le promozioni. Se non specificato, type si presume che sia base, il che significa che la migliore promozione di base idonea è selezionate e applicate prima delle altre promozioni. Quando l'attributo type di Stacking è any, può essere combinato con qualsiasi altra promozione.

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

Descrizione

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

Soluzione

Utilizza la sovrapposizione 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 possono da combinare con gli altri tipi tranne none.

Esempio

Questo esempio mostra come impilare i tipi di impilaggio base, second e any. Per uno sconto combinato del 15%, 25%, 10%, un prezzo di 100 $è 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 che si sovrappongono da 1 a 3 è migliore dello sconto per la promozione 4. La promozione 4 non è cumulabile con altre promozioni a causa del tipo di sovrapposizione (none). Se la promozione 4 aveva un del 43% o superiore, viene utilizzato invece della combinazione promozioni dalla 1 alla 3.