Prezzi delle modalità di consegna

La modalità di invio determina il modo in cui invii gli aggiornamenti dei prezzi a Google per le combinazioni hotel e itinerario. Tu e il tuo Technical Account Manager (TAM) collaborare durante la configurazione iniziale per impostare la modalità di invio.

Panoramica delle modalità di invio

Per impostazione predefinita, è possibile eseguire query su un hotel con un massimo di 330 giorni di anticipo sulla disponibilità delle camere e fino a 30 notti di soggiorno, ma puoi stabilire il numero massimo di itinerari (combinazione di data di check-in e durata del soggiorno).

Più itinerari gestisci, più aste parteciperai. Tuttavia, più itinerari gestisci, maggiore è la quantità di dati che dovrai inviare a Google per garantire l'accuratezza dei dati sui prezzi.

Solitamente, i metodi di aggiornamento dei prezzi utilizzano i messaggi Transaction in uno dei seguenti modi:

• ARI (push): un feed di invio dei prezzi che utilizza piani tariffari, disponibilità e metadati degli hotel per impostare strategie di prezzo predefinite per le tue proprietà. A differenza delle modalità Pull e Prezzo modificato, i feed ARI non eseguono query su prezzi o itinerari specifici. Esegui invece il push di messaggi contenenti un sottoinsieme di informazioni che rappresenta un modello di prezzi per le tue proprietà in base a vari dettagli delle tariffe, restrizioni e disponibilità. I feed ARI utilizzano la specifica XML OTA (OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ) per definire disponibilità e prezzi. Contatta il tuo account manager per saperne di più sulla modalità di invio ARI e per determinare se questo tipo di feed è il più adatto al tuo account. Per ulteriori informazioni, consulta la sezione Utilizzare il feed ARI.

• Pull: Google interroga il servizio regolarmente per aggiornare la cache dei dati su prezzi e disponibilità. In questo modello, Google invia una richiesta al tuo server, che risponde con dati aggiornati. Questo modello è ideale se non sai esattamente quando cambiano le informazioni sui prezzi o se le informazioni cambiano in modo irregolare nel corso della giornata. I prezzi rimangono nella cache finché gli algoritmi di Google non stabiliscono che i prezzi sono diventati obsoleti in base alla cronologia delle modifiche dei prezzi precedenti specifiche del partner. Per ulteriori informazioni, consulta la sezione Utilizzo della modalità di invio Pull.

• Prezzi modificati (in precedenza Pull with Hints): simile alla modalità Pull, con la differenza che Google richiede i dati solo per un sottoinsieme di proprietà, non per tutte. Questa modalità può ridurre notevolmente la quantità di traffico di rete durante l'aggiornamento dei prezzi e della disponibilità delle tue proprietà. I prezzi rimangono nella cache a tempo indeterminato fino all'aggiornamento. Per ulteriori informazioni, consulta la sezione Utilizzo dei prezzi modificati.

Oltre che per aggiornare i prezzi, puoi utilizzare i messaggi Transaction per rimuovere le proprietà dall'inventario. Per ulteriori informazioni, consulta la sezione Rimozione dall'inventario.

Per ulteriori informazioni sull'invio degli aggiornamenti dei prezzi, inclusi esempi di messaggi Transaction, consulta la sezione Aggiornare i prezzi.

Query sui prezzi in tempo reale

Google può anche richiedere alcuni aggiornamenti dei prezzi al momento dell'asta tramite le query sui prezzi in tempo reale. Le query sui prezzi in tempo reale sono richieste sui prezzi effettuate da Google per un'asta in corso. Se rispondi entro il periodo di tempo specificato, il tuo annuncio dovrebbe apparire nell'asta.

Google archivia la risposta a una query sui prezzi in tempo reale come avviene con qualsiasi altro messaggio Transaction. Di conseguenza, Google può fornire il prezzo memorizzato nella cache anziché inviare in futuro un'altra query sui prezzi in tempo reale.

Per ulteriori informazioni, consulta la sezione Query sui prezzi in tempo reale.

Contesto

Le query Pull e Prezzo modificato in genere non specificano informazioni sull'utente, poiché Google utilizza le tue risposte per riempire una cache che potrebbe essere utilizzata per servire una varietà di utenti diversi.

Poiché potrebbe essere costoso restituire prezzi corrispondenti a un insieme completo di possibili contesti utente, è in corso il test di una funzionalità in cui i contesti utente più diffusi vengono specificati come parte della query. I contesti degli utenti si basano sulle richieste degli utenti per le quali hai avuto l'opportunità di mostrare un prezzo e sono calcolati per coprire la maggior parte delle richieste degli utenti. Potresti visualizzare un numero elevato di contesti utente per proprietà o itinerari molto popolari, ma il numero medio di contesti utente dovrebbe essere inferiore a 10. Puoi restituire prezzi aggiuntivi o ignorare contesti utente specificati: sta a te decidere quali prezzi restituire per una determinata query. Tuttavia, ignorare un contesto utente suggerito potrebbe comportare una riduzione del traffico.

Suggerimento: se vuoi ricevere contesti utente popolari nelle query inviate da Google, contatta il tuo Technical Account Manager (TAM) (TAM). Il team confermerà che puoi ricevere questi messaggi, quindi apporterà un aggiustamento della configurazione per iniziare a inviarti i contesti utente nelle query.

Modalità di invio Push ARI

Con la modalità di invio Push ARI, invii aggiornamenti incrementali a Google ogni volta che le tariffe per notte, la disponibilità, il conteggio dell'inventario o altre limitazioni cambiano. A differenza delle modalità Pull o Prezzo modificato, la modalità Push ARI ti consente di utilizzare un modello di prezzi diverso per aggiornare in modo efficiente i vari componenti delle informazioni sui prezzi in Google.

Il seguente diagramma mostra il flusso di richieste e risposte per la modalità di invio Push ARI:

Passaggio 1: invia messaggi push ARI a Google

Per aggiornare i tuoi dati con la modalità Push ARI, invia un messaggio di richiesta ARI ogni volta che i dati cambiano. La modalità di invio Push ARI supporta vari tipi di messaggi e strategie di prezzo. Per informazioni dettagliate sul push dei messaggi, consulta la sezione Utilizzare il feed ARI.

I prezzi dovrebbero essere pubblicati da Google e visibili agli utenti entro 15-20 minuti dalla ricezione di un messaggio.

Passaggio 2: verifica che i dati vengano memorizzati correttamente nella cache da Google

Per ogni messaggio push ARI ricevuto, Google risponde con lo stato della connessione HTTP e i risultati dell'elaborazione ARI. Google risponde con un HTTP 200 OK se la connessione al server ha esito positivo. Include inoltre un corpo con un messaggio di risposta che indica se gli aggiornamenti sono stati applicati correttamente o se sono stati rilevati avvisi o errori relativi alla modalità di invio.

Indirizzi IP nella lista consentita

Per inserire nella lista consentita tutti gli indirizzi IP che utilizzi per eseguire il push dei messaggi ARI a Google, utilizza la pagina delle impostazioni dei prezzi ARI di Hotel Center. Scopri come aggiornare le impostazioni dei prezzi in Hotel Center.

Aggiornare i metadati di camere e pacchetti con la modalità Push ARI

Utilizza il tipo di messaggio Transaction (Property Data) per definire i tipi di camera e i piani tariffari (pacchetti) attivi per ogni proprietà. Devi eseguire il push degli aggiornamenti ogni volta che vengono aggiunti, rimossi o modificati tipi di camera o piani tariffari. In questo caso, dovrai inviare un messaggio XML con le nuove informazioni negli elementi <RoomData> e <PackageData>. Questi elementi sono elementi secondari dell'elemento <PropertyDataSet>.

Errori di connessione o contenuti

Se ricevi un errore relativo alla modalità di invio a causa di un formato XML non corretto o non corretto, trova la risoluzione consigliata nei messaggi di errore relativi allo stato dei feed.

Se ricevi un errore di connessione HTTP quando invii un messaggio ARI a Google, riprova a eseguire la richiesta a intervalli di 1, 5 e 20 minuti. Se il problema persiste dopo 3 tentativi, interrompi l'invio dei messaggi e contatta l'Assistenza Google.

Modalità di invio pull

Con la modalità di invio Pull, Google invia periodicamente messaggi Query al tuo server per richiedere gli aggiornamenti dei prezzi. Il server risponde ai messaggi con messaggi Transaction che contengono dati aggiornati su prezzi e disponibilità.

Il seguente diagramma mostra il flusso di richiesta/risposta per la modalità Pull:

Dopo aver ricevuto gli aggiornamenti dei prezzi, Google in genere elabora i nuovi dati su prezzi e disponibilità entro circa 5 minuti.

Le sezioni seguenti descrivono in maggiore dettaglio ciascuno di questi passaggi.

Passaggio 1: messaggio Query

Per impostazione predefinita, Google invia messaggi Query per tutte le proprietà definite nel tuo elenco di hotel. Questo potrebbe significare che dovresti ricevere più messaggi Query durante i processi di ricalcolo del prezzo.

I messaggi Query sui prezzi che Google invia al tuo server hanno le seguenti caratteristiche:

• L'elemento principale è <Query>.
• Inviato all'endpoint definito durante la configurazione iniziale. Per ulteriori informazioni, contatta il tuo Technical Account Manager (TAM).
• Utilizza il metodo HTTP POST. Se utilizzi HTTPS, il dominio deve essere firmato da un'autorità di certificazione ufficiale.
• L'intestazione Content-Type è impostata su application/xml.
• Ciascun messaggio include fino a 100 proprietà per le quali Google richiede i dati su prezzi e disponibilità.
• L'intestazione User-Agent è impostata su Google-HotelAdsPrices.

Punto chiave: potrebbero essere presenti molti messaggi Query per aggiornare tutti i prezzi di tutti gli hotel e i messaggi Transaction risultanti potrebbero essere molto grandi. Per ridurre le dimensioni e il numero dei messaggi, ti consigliamo di utilizzare Prezzi modificati.

Passaggio 2: messaggio Transaction

Quando riceve un messaggio Query, il server deve rispondere con un messaggio Transaction contenente le informazioni sui prezzi per gli itinerari richiesti.

L'elemento principale di un messaggio Transaction è <Transaction>. Per ulteriori informazioni, consulta le sezioni Messaggi delle transazioni e Aggiornamento dei prezzi.

Aggiornare i metadati di camere e pacchetti

Oltre ad aggiornare i dati sui prezzi con la modalità Pull, puoi utilizzare i messaggi Transaction anche per aggiornare i metadati di camere e pacchetti. Per ulteriori informazioni, consulta la sezione Definire i metadati di camere e pacchetti.

Modalità di invio dei prezzi modificata

La modalità Prezzo modificato consente di ridurre le dimensioni e la quantità dei messaggi Query e Transaction per gli aggiornamenti dei prezzi. Quando utilizzi la modalità Prezzo modificato, invii a Google un elenco di proprietà che hanno aggiornato i prezzi. Google risponde con un messaggio Query che chiede solo i prezzi di quelle proprietà.

Per configurare l'endpoint a cui Google invia i messaggi Hint Request, consulta il tuo Technical Account Manager (TAM). Dovresti configurare questa funzionalità durante la configurazione iniziale.

Punto chiave: se non implementi i messaggi Hint Response, i messaggi Query di Google richiederanno i dati delle proprietà all identificate nel tuo elenco di hotel.

Il seguente diagramma mostra il flusso di richieste e risposte per la modalità Prezzo modificato:

Le sezioni seguenti descrivono i singoli passaggi di questa procedura.

Passaggio 1: messaggio Hint Request

I messaggi Hint Request che Google invia al tuo server hanno le seguenti caratteristiche:

• L'elemento principale è <HintRequest>.
• Inviato all'endpoint definito durante la configurazione iniziale. Per ulteriori informazioni, contatta il tuo Technical Account Manager (TAM).
• Utilizza il metodo HTTP POST. Se utilizzi HTTPS, il dominio dovrà essere firmato da un'autorità di certificazione ufficiale.
• L'intestazione Content-Type è impostata su application/xml.
• Con una frequenza specificata, Google invia un timestamp al tuo server che definisce la data e l'ora dell'ultima risposta a un messaggio Hint Request.
• L'intestazione User-Agent è impostata su Google-HotelAdsPrices.

Ti consigliamo di impostare la frequenza su 5 minuti. Per impostare o modificare la frequenza dei messaggi Hint Request, contattaci.

Quando ricevi un messaggio Hint Request da Google, devi rispondere con tutti i prezzi che sono stati aggiornati a partire da quel timestamp. Per ulteriori informazioni, consulta la sezione Messaggi Hint Request.

Passaggio 2: messaggio Hint Response

Il server risponde a un messaggio Hint Request con un messaggio Hint Response. Questo messaggio include gli ID hotel e gli itinerari delle proprietà i cui prezzi sono stati modificati dall'ultima volta che hai ricevuto e risposto a un messaggio Hint Request.

L'elemento principale di un messaggio Hint Response è <Hint>. Per ulteriori informazioni, consulta la sezione Messaggi Hint Response.

Passaggio 3: messaggio Query

Google riceve il messaggio Hint Response e risponde con un messaggio Query, come nella modalità Pull standard. La differenza è che il messaggio Query ora contiene solo gli ID hotel e gli itinerari delle proprietà specificate nel messaggio Hint Response. L'elemento principale di un messaggio Query è <Query>.

Nel determinare gli ID hotel per i quali richiedere i prezzi con la modalità Prezzo modificato, Google ignora i contenuti del feed elenco hotel. In questo modo vengono ridotte notevolmente le dimensioni del messaggio Query che ricevi da Google e le dimensioni del messaggio Transaction della tua risposta.

Passaggio 4: messaggio Transaction

Puoi inviare un messaggio Transaction con un aggiornamento dei prezzi in risposta ai messaggi Query di Google. L'elemento principale di un messaggio Transaction è <Transaction>. Per ulteriori informazioni, consulta Modalità di invio Pull.