Introduzione ai messaggi delle transazioni

Nota

Questa versione beta di Hotel Price Ads è disponibile solo per selezionare i partecipanti. Per informazioni sulla partecipazione al programma di versione beta, contattare il proprio account manager o registrarsi qui.

Se crei campagne pubblicitarie per hotel in Microsoft Advertising, usa i messaggi di transazione per aggiornare i dati dell'itinerario (prezzi e disponibilità).

Prima di poter inviare messaggi di transazione Microsoft, è necessario contattare il gestore account per iscriversi.

Modalità diverse per l'invio dei dati dell'itinerario a Microsoft

Microsoft supporta le modalità seguenti che è possibile usare per fornire i dati dell'itinerario.

• Modalità push
• Modalità pull
• Modalità pull con hint

Con la modalità push si inviano a Microsoft gli aggiornamenti non richiesti a intervalli scelti. Per usare questa modalità, è necessario specificare gli indirizzi IPv4 (o gli intervalli di indirizzi in formato CIDR) di tutti i server che verranno usati per inviare messaggi di transazione. Per informazioni, vedere Push Transaction Messages to Microsoft (Push dei messaggi di transazione in Microsoft).

Con le opzioni della modalità pull , Microsoft invia messaggi di query che specificano i dati dell'itinerario dell'hotel da restituire. La differenza tra le due modalità pull è la quantità di dati inviati a Microsoft. Con la modalità pull, si restituiscono i dati per tutti gli itinerari e tutti gli hotel. Ma con pull con hint, si indica a Microsoft quali dati sono stati modificati e richiede solo tali dati. Per informazioni, vedere Avere messaggi di transazione pull Microsoft.

Che cos'è un messaggio di transazione

Un messaggio di transazione è un documento XML che contiene i dati relativi ai prezzi e alla disponibilità per una o più proprietà dell'hotel. Per ogni proprietà dell'hotel, specificare un Result elemento per ogni Checkin combinazione ( Nights nota anche come itinerario) nella finestra di prenotazione avanzata. 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">100.00</Baserate>
    <Tax currency="USD">10.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">8.00</OtherFees>
  </Result>
  <Result>
    <Property>13579</Property>
    <Checkin>2017-05-26</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">300.00</Baserate>
    <Tax currency="USD">30.00</Tax>
    <OtherFees currency="USD">12.00</OtherFees>
  </Result>
</Transaction>

È possibile specificare fino a 180 giorni di prenotazione avanzata con soggiorni fino a 14 notti. Ad esempio, se il messaggio timestamp è 2017-06-10, l'ultima Checkin data specificata dal messaggio è 2017-09-08.

Il documento deve usare la codifica UTF-8.

Altre informazioni

Convalidare il messaggio prima di inviarlo

Prima di inviare a Microsoft il messaggio di transazione, usare transaction XSD per convalidare il messaggio. Ciò consente di risparmiare tempo e round trip rilevando gli errori di sintassi dei documenti e i vincoli imposti dall'XSD.

Nell'esempio seguente viene illustrato l'uso di xmllint per convalidare il messaggio contenuto in SampleTransaction.xml.

xmllint.exe --schema transaction.xsd SampleTransaction.xml

Nota

Esistono vincoli non definiti dall'XSD che possono generare errori al momento dell'elaborazione del messaggio da parte di Microsoft. Assicurarsi che il messaggio sia conforme a tutti i vincoli definiti in questo documento.