Panoramica del feed ARI

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

A differenza delle modi di invio dei prezzi basati sull'itinerario, Pull e Prezzi modificati, sui feed ARI non vengono eseguite query relative a prezzi o itinerari specifici. Invece, invii messaggi quando il tuo modello di prezzi contiene dati nuovi o modificati, ad esempio variazioni relative a dettagli, limitazioni e disponibilità delle tariffe.

Vantaggi

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 i dati ARI giornalieri e solo le modifiche incrementali, Google può calcolare i prezzi e gli aggiornamenti per un'ampia gamma di valori di prenotazione anticipata 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: raggiungi una maggiore copertura dei prezzi (numero di itinerari con 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 coerente con la modalità di archiviazione 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 contrassegnati come messaggi di "richiesta" ARI. Google successivamente restituisce messaggi di "risposta" che indicano l'esito positivo o negativo.

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

ARI utilizza i seguenti messaggi di richiesta:

  • Transaction (Property Data). Definisce le informazioni sul tipo di camera e sul pacchetto (piano tariffario).

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

  • OTA_HotelAvailNotifRQ. Definisce la disponibilità e le limitazioni in base al tipo di camera e ai piani tariffari. Puoi aggiornare anche l'inventario utilizzando questo messaggio, ma è preferibile utilizzare OTA_HotelInvCountNotifRQ.

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

  • TaxFeeInfo. (Facoltativo) Definisce le tasse e le commissioni per ogni proprietà. Questo messaggio non è necessario 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 determinate prenotazioni, soggiorni e utenti.

  • ExtraGuestCharges. (Facoltativo) Definisce la modalità di configurazione delle tariffe per bambini e 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, oltre al numero di persone desiderato.

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

Messaggi push

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

Segui queste indicazioni per inviare 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 utilizzando 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 il codice di errore 6032.

  • Utilizza i seguenti percorsi, a seconda dei dati che vengono aggiornati:

    • Transaction (Property Data): /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 risponde con un messaggio HTTP 200 OK se la connessione al server è andata a buon fine e include un corpo del messaggio con una risposta che indica se gli aggiornamenti sono stati applicati correttamente o 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, devono essere correttati prima di inviare nuovamente il messaggio. Puoi anche visualizzare i problemi riscontrati per messaggi specifici nella pagina relativa allo stato del feed in Hotel Center.

Informazioni pubblicate su Google (LoG)

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

Utilizza Online su Google 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.

Esistono due modi per impostare il valore LoG di un hotel: il 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 dettagli sul 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'endpointhotelViews.list.

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

  • Utilizza hotelViews.summary per ottenere un riepilogo delle proprietà di un account specifico, incluso il numero di proprietà pubblicate su Google.

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