Creare un messaggio di transazione
Per fornire a Bing i prezzi e i dati di disponibilità dell'hotel, creare un documento XML contenente un messaggio di transazione. Il messaggio di transazione contiene un elenco di date di archiviazione, lunghezze di soggiorno e prezzi.
I messaggi di transazione possono contenere fino a 180 giorni di prenotazione avanzata e ogni prenotazione può specificare fino a un soggiorno di 14 notti. Una data di check-in e la durata del soggiorno sono definite itinerario. Se si specifica il numero massimo di itinerari, il messaggio conterrà 2.520 itinerari.
I messaggi di transazione sono limitati a 100 MB di dati non compressi o a 10 MB di dati compressi (usando la compressione GZip). Per ridurre il traffico di rete, è necessario inviare dati compressi.
Un messaggio di transazione deve contenere solo gli itinerari che si stanno aggiungendo o aggiornando, senza includere itinerari che non sono stati modificati dall'ultima volta che è stato inviato un messaggio.
Il documento deve usare la codifica UTF-8 e deve essere conforme a Transaction XSD.
Importante
È necessario leggere e seguire tutte le politiche di Hotel Price Ads. Per l'elenco dei criteri, vedere Criteri dei programmi pilota.
Nota
Bing non supporta tutti gli elementi XSD delle transazioni. Bing ignora qualsiasi elemento o attributo nel messaggio che non supporta. Transaction Message Reference include solo gli elementi e gli attributi supportati da Bing.
Nota
Il messaggio deve specificare gli elementi nell'ordine definito in Transaction XSD (o come illustrato nel riferimento).
Elemento Transaction di primo livello
I messaggi di transazione contengono un singolo elemento Transaction di primo livello.
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
È necessario specificare gli timestamp
attributi e id
.
L'attributo timestamp
deve identificare l'ora in cui si invia il messaggio. Bing usa il timestamp per assicurarsi che elabori solo gli itinerari più recenti. Ad esempio, se Bing elabora un messaggio con timestamp 14:10 e quindi elabora un messaggio con un timestamp di 14:09, Bing elabora solo gli itinerari nel messaggio 14:09 che non sono stati inclusi nel messaggio 14:10.
L'attributo id
è un ID definito dall'utente che identifica in modo univoco il messaggio all'inserzionista. L'inserzionista usa l'ID per identificare il messaggio nell'elenco dei report sullo stato del feed dell'hotel.
Specifica dell'elenco di itinerari
L'elemento Transaction
contiene un elenco di elementi Result , uno per ogni itinerario definito. Il messaggio deve includere solo nuovi itinerari o quelli modificati.
Di seguito viene illustrato un Result
elemento che specifica gli elementi figlio necessari.
<Result>
<Property>13579</Property>
<Checkin>2017-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
</Result>
L'ID Property
deve corrispondere all'ID di una proprietà nel file del feed dell'hotel. La Checkin
data deve essere compresa nella finestra di prenotazione avanzata di 90 giorni e Nights
deve essere compresa nell'intervallo da 1 a 14.
Specifica Baserate
il costo dell'intera durata del soggiorno e non la tariffa della camera notturna.
Se si consente la prenotazione avanzata di cinque giorni e soggiorni fino a tre notti, il messaggio conterrà 15 Result
elementi. L'esempio seguente mostra il valore di un giorno di itinerari.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="mobile"/>
<PointOfSale id="desktop"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="mobile"/>
<PointOfSale id="desktop"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="mobile"/>
<PointOfSale id="desktop"/>
</AllowablePointsOfSale>
</Result>
</Transaction>
Dopo aver definito i 15 itinerari, ogni messaggio successivo includerà solo gli itinerari modificati. Ad esempio, i prezzi o le modifiche di disponibilità.
Rimozione di itinerari
Per rimuovere un itinerario, impostare gli Baserate
elementi , Tax
e OtherFees
su -1.00. Bing rimuove automaticamente gli itinerari con date di archiviazione precedenti.
Uso degli elementi Result facoltativi
Di seguito viene illustrato un Result
elemento che include gli elementi figlio facoltativi.
<Result>
<Property>13579</Property>
<Checkin>2017-05-26</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">159.99</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">4.00</OtherFees>
<ExpirationTimestamp>2017-05-28T09:00:34Z</ExpirationTimestamp>
<ChargeCurrency>deposit</ChargeCurrency>
<Custom1>summer2017</Custom1>
<AllowablePointsOfSale>
<PointOfSale id="mobile"/>
<PointOfSale id="desktop"/>
</AllowablePointsOfSale>
</Result>
Utilizzare ExpirationTimestamp
per specificare una data di scadenza per l'itinerario. Ad esempio, nel caso 1, l'itinerario viene servito.
Caso 1:
Oggi = 16/3/2018
CheckInDate = 1/4/2018
ExpirationTimestamp = 20/3/2018
Ma nel caso 2, l'itinerario non è servito.
Caso 2:
Oggi = 21/3/2018
CheckInDate = 1/4/2018
ExpirationTime = 20/3/2018
Usare l'elemento ChargeCurrency
per specificare quando viene addebitato l'addebito per la prenotazione all'utente. Per impostazione predefinita, l'utente paga quando prenota (questa è l'opzione Web). In questo esempio viene usato Il deposito, che chiede all'utente di pagare una parte al momento della prenotazione e il resto in un secondo momento (ad esempio, quando eseguono il check-out).
Usare uno o più dei cinque Custom
elementi per fornire valori di sostituzione per i parametri dinamici in un URL POS (Point of Sale). Ad esempio, se l'URL POS è https://www.partnerdomain.com?promo=(CUSTOM1) e Custom1
è impostato su summer2017, l'URL POS usato da Bing è https://www.partnerdomain.com?promo=summer2017. Per altre informazioni, vedere Uso dei parametri di query dinamica.
La somma di tutti i valori Personalizzati[1-5] è limitata a un massimo di 1.000 caratteri, ma tenere presente che il limite pratico può essere inferiore data la lunghezza massima di un URL.
Usare l'elemento AllowablePointsOfSale
per specificare URL POS specifici che gli utenti possono usare per la prenotazione. Per impostazione predefinita, l'utente può usare qualsiasi POS nel file del feed dei punti vendita del partner. L'attributo id
deve corrispondere a un POS nel file di feed.
Passaggi successivi
Prima di inviare messaggi di transazione, assicurarsi che il file del feed dell'hotel e il file dei punti vendita siano aggiornati. Per aggiornare questi file, contattare il TAM. Dopo che TAM ha importato i dati in Bing, è possibile iniziare a inviare messaggi di transazione. I messaggi di transazione inviati prima dell'importazione dei dati avranno esito negativo.
Convalidare il messaggio di transazione prima di inviarlo a Bing. Per informazioni, vedere Convalida del messaggio di transazione.
Per informazioni sull'invio di Bing al messaggio di transazione, vedere Push transaction messages to Bing (Push dei messaggi di transazione a Bing ) o Having Bing Pull Transaction Messages (Messaggi di transazione pull Bing).
Per informazioni sull'aggiunta di bundle di sala agli itinerari, vedere Creazione di un messaggio di transazione dei metadati e Uso di bundle di sala.