Creare un feed di prezzi (in precedenza messaggio di transazione)

Articolo
06/22/2024

Per fornire a Bing i dati relativi ai prezzi e alla disponibilità dell'hotel, creare un documento XML contenente un feed di prezzi. Il feed Prezzi contiene un elenco di date di check-in, lunghezze di soggiorno e prezzi.

I feed di prezzo 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 feed di prezzo 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 feed prezzi deve contenere solo gli itinerari che si sta 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. Il riferimento al feed di prezzi 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 feed di prezzo 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 di proprietà.

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 di proprietà. 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 Baserateelementi , Taxe 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 di feed Pagine di destinazione del partner. L'attributo id deve corrispondere a un POS nel file di feed.

Passaggi successivi

Prima di inviare i feed di prezzo, assicurarsi che il file del feed di proprietà e il file delle pagine di destinazione siano aggiornati. Per aggiornare questi file, contattare il TAM. Dopo che il TAM ha importato i dati in Bing, è possibile iniziare a inviare feed price. I feed di prezzo inviati prima dell'importazione dei dati avranno esito negativo.

Convalidare il feed Prezzi prima di inviarlo a Bing. Per informazioni, vedere Convalida del feed di prezzi.

Per informazioni sull'invio di Bing al feed di prezzi, vedere Push dei feed price in Bing o Having Bing Pull Price feeds .For information about Bing your Price feed, see Push Price feeds to Bing or Having Bing Pull Price feeds.For information about Bing your Price feed, see Push Price feeds to Bing or Having Bing Pull Price feeds.

Per informazioni sull'aggiunta di bundle di sale agli itinerari, vedere Creazione di un feed di prezzo dei metadati e Uso di bundle di sala.

Condividi tramite