Panoramica di ARI

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

A differenza delle modalità 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, esegui il push dei messaggi quando il tuo modello di prezzi presenta 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 notturni e solo le modifiche incrementali, Google può calcolare i prezzi e gli aggiornamenti per un'ampia gamma di valori di acquisto anticipato 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: ottiene 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 allineato a come vengono archiviati nel 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 principali tipi di messaggi per definire la disponibilità e l'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 del tasso di occupazione 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 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 delle camere fisiche o il numero di camere disponibili per la vendita.

  • TaxFeeInfo. (Facoltativo) Definisce tasse e 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 come devono essere configurate le tariffe per i bambini e gli adulti aggiuntivi.

Ogni messaggio contiene un sottoinsieme di informazioni che Google utilizza per calcolare disponibilità e prezzi 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 su ARI, consulta la 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 un codice di errore 6032.

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

    • 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 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, correggili 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.

Live on Google (LoG)

Live on Google (LoG) ti consente di mostrare i tuoi hotel sui siti web Google. Poiché il valore LoG predefinito per un hotel è true, tutti i nuovi hotel vengono 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 di 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 maggiori dettagli 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 gli hotel visualizzati su Google utilizzando il parametro filter con liveOnGoogle = TRUE nell'endpoint hotelViews.list.

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

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