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, fornendo vincoli su come possono essere combinate. Il feed ARI offre anche la flessibilità di includere tasse, commissioni e promozioni.

A differenza delle modalità di consegna dei prezzi basati sull'itinerario, pull e prezzo modificato, sui feed ARI non vengono eseguite query per prezzi o itinerari specifici. Esegui invece il push dei messaggi quando il modello di prezzi contiene dati nuovi o modificati, ad esempio modifiche a dettagli, limitazioni e disponibilità delle tariffe.

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 per notte e solo modifiche incrementali, Google può calcolare i prezzi e gli 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 eventi push-on-change per fornire aggiornamenti in tempo reale.

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

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

  • Facilità d'uso: trasmette i dati in un modo in linea con le modalità di archiviazione nel sistema, evitando di dover 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 restituisce successivamente 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 definire la disponibilità e l'inventario.

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 della tariffa di occupazione in base alla data o in base alla lunghezza 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 tramite questo messaggio, ma è preferibile OTA_HotelInvCountNotifRQ.

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

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

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

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

  • ExtraGuestCharges. (Facoltativo) Definisce in che modo devono essere configurate le tariffe per i bambini e gli adulti aggiuntivi.

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

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

Messaggi push

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

Segui queste linee guida per inviare messaggi:

  • Utilizza lo strumento self-service disponibile nella pagina Impostazioni 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 utilizzando il metodo HTTP POST.

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

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

  • Utilizza i seguenti percorsi in base ai dati da aggiornare:

    • Transaction (dati della 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 un 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.

Informazioni pubblicate su Google (LoG)

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

Utilizza 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 per la proprietà. 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 del Travel Partner API, you can do the following:

  • Visualizza lo stato delle tue proprietà in 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, incluso il numero di proprietà pubblicate su Google, utilizzando hotelViews.summary.

Per ulteriori informazioni su come impostare il LoG utilizzando l'API, consulta l'articolo hotelViews.list e la documentazione di riferimento API.