Panoramica del feed ARI

Il feed ARI (disponibilità, tariffe e inventario) è una modalità di invio dei prezzi che controlla le tariffe per notte, la disponibilità e l'inventario e fornisce vincoli su come questi possono essere combinati. Il feed ARI offre anche la flessibilità di includere tasse, commissioni e promozioni.

A differenza delle modalità di invio dei prezzi basati sugli itinerari e dei prezzi pull e modificati, sui feed ARI non vengono eseguite query per prezzi o itinerari specifici. Devi invece eseguire il push dei messaggi quando il tuo modello di prezzi contiene dati nuovi o modificati, ad esempio modifiche ai dettagli delle tariffe, alle restrizioni e alla disponibilità.

Vantaggi

Il feed ARI offre i seguenti vantaggi:

• Efficienza della larghezza di banda: aumenta l'efficienza della larghezza di banda riducendo il volume di dati da trasmettere. Inviando dati ARI notturni e solo modifiche incrementali, Google può calcolare prezzi e aggiornamenti per un'ampia gamma di valori relativi ad acquisti anticipati e durata del soggiorno.

• Accuratezza del prezzo: migliora l'accuratezza del prezzo utilizzando un modello di evento push-on-change per fornire aggiornamenti in tempo reale.

• Maggiore copertura dei prezzi: raggiunge una copertura dei prezzi più elevata (numero di itinerari con i prezzi) utilizzando dati granulari combinati in vari itinerari.

• Flessibilità: consente una maggiore flessibilità nell'offerta di promozioni e pacchetti.

• Facilità d'uso: trasmette i dati in modo in linea con il modo in cui vengono archiviati sul sistema, evitando la necessità di calcolare o memorizzare nella cache i prezzi per molti itinerari.

Tipi di messaggi di richiesta

I messaggi ARI inviati a Google vengono definiti messaggi "di richiesta" ARI. Google di conseguenza restituisce messaggi di "risposta" che indicano l'esito positivo o negativo.

Il feed ARI segue i protocolli standard di OpenTravel Alliance (OTA) per alcuni dei principali tipi di messaggi per la definizione della disponibilità e dell'inventario.

Punto chiave: devi inviare i quattro tipi di messaggi (transazione, tariffa, inventario e disponibilità) per rendere disponibili i prezzi. Ti consigliamo di limitare in particolare le dimensioni dei messaggi ARI <OTA_HotelRateAmountNotifRQ> a 5 MB con un limite di 400 file al secondo per la frequenza di caricamento.

Il feed ARI utilizza i seguenti messaggi di richiesta:

• Transaction (Dati proprietà). Definisce il tipo di camera e le informazioni sul pacchetto (piano tariffario).

• OTA_HotelRateAmountNotifRQ. Definisce gli importi delle tariffe per il numero di persone per data o in base alla durata del soggiorno per prodotto (combinazione di tipo di camera e piano tariffario) per intervalli di date specifici.

• OTA_HotelAvailNotifRQ. Definisce disponibilità e limitazioni in base al tipo di camera e ai piani tariffari. L'inventario può essere aggiornato anche utilizzando questo messaggio, ma OTA_HotelInvCountNotifRQ è preferibile.

• OTA_HotelInvCountNotifRQ. Definisce l'inventario fisico delle camere o il numero di camere disponibili per la vendita.

• TaxFeeInfo. (Facoltativo) Definisce tasse e commissioni specifiche della proprietà. Questo messaggio non è obbligatorio se nel messaggio OTA_HotelRateAmountNotifRQ è specificato AmountAfterTax.

• Promotions. (Facoltativo) Definisce le tariffe promozionali per determinati soggiorni, prenotazioni e utenti.

• RateModifications. (Facoltativo) Definisce le regole di modifica delle tariffe per determinati tipi di prenotazioni, soggiorni e utenti.

• ExtraGuestCharges. (Facoltativo) Definisce la modalità di configurazione delle tariffe per i bambini e altri adulti.

Ogni messaggio contiene un sottoinsieme di informazioni che Google utilizza per calcolare i prezzi e la disponibilità mostrati agli utenti quando cercano le tue strutture con date di check-in e check-out specifiche e il numero di persone desiderato.

Per maggiori informazioni sul feed ARI, consulta la pagina Riferimento XML.

Messaggi push

Per aggiornare le informazioni ARI e sulle proprietà, invia i messaggi associati ogni volta che i dati cambiano nel sistema.

Punto chiave: i dati dei messaggi verranno uniti a quelli già inviati. Di conseguenza, devi inviare solo i dati nuovi o modificati.

Attieniti alle seguenti linee guida per l'invio di messaggi:

• Utilizza lo strumento self-service nella pagina Impostazioni dei prezzi di Hotel Center per aggiungere o aggiornare i tuoi indirizzi IP nel nostro sistema.

• Utilizza il seguente percorso di base per l'endpoint:

  • https://www.google.com o Host: www.google.com Port: 443

• Invia messaggi con il metodo HTTP POST.

• Imposta l'intestazione Content-Type su application/xml.

• Esiste una frequenza di aggiornamento massima a livello di account di 400 messaggi al secondo. Se superi questo limite, viene restituito un codice di errore 6032.

• Utilizza i seguenti percorsi a seconda dei dati da aggiornare:

  • Transaction (dati proprietà): /travel/hotels/uploads/property_data
  • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
  • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
  • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
  • TaxFeeInfo: /travel/hotels/uploads/taxes
  • Promotions: /travel/hotels/uploads/promotions
  • RateModifications: /travel/hotels/uploads/rate_modifications
  • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

Per ogni messaggio di richiesta ricevuto, Google risponderà con HTTP 200 OK se la connessione al server è riuscita e includerà un corpo con un messaggio di risposta che indica se gli aggiornamenti sono stati applicati correttamente o se sono stati riscontrati avvisi o errori. Se Google risponde con un codice di errore HTTP, invia nuovamente il messaggio. Se il corpo della risposta HTTP contiene avvisi o errori, questi devono essere corretti prima di inviare nuovamente il messaggio. Puoi anche visualizzare i problemi riscontrati per messaggi specifici nella pagina Stato del feed in Hotel Center.

Online su Google (LoG)

Online su Google ti consente di mostrare i tuoi hotel sui siti web di Google. Poiché il valore predefinito della LoG per un hotel è true, tutti i nuovi hotel verranno visualizzati automaticamente su Google.

Utilizza la LoG per attivare e disattivare annunci e link di prenotazione gratuiti delle proprietà nel tuo account Hotel Center, a prescindere dallo stato di Google Ads o dalla presenza o meno di tariffe su Google. Questo vale solo per gli hotel e non per le case vacanze.

Esistono due modi per impostare il valore LoG di un hotel: Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

Per ulteriori informazioni su LoG, consulta la Guida di Hotel Center.

Utilizzo di Travel Partner API, you can do the following:

• Visualizza lo stato delle tue proprietà tramite Hotel Center o utilizza l'endpoint hotelViews.list.

• Recupera un elenco di tutti i tuoi hotel visualizzati su Google utilizzando il parametro filter con liveOnGoogle = TRUE nell'endpoint hotelViews.list.

• Ricevi un riepilogo delle proprietà di un account specifico, con il numero di proprietà attive su Google, utilizzando hotelViews.summary.

Per saperne di più su come impostare LoG utilizzando l'API, consulta l'articolo di hotelViews.list e il Riferimento API.