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 sovrapposizionebase
, il che significa che la migliore promozione di base idonea viene selezionata e applicata per prima, prima di altre promozioni. Tieni presente chebase
può essere combinato solo consecond
oany
e non può essere combinato con un altrobase
onone
.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.
Settore fiscale
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.