Prezzi delle modalità di consegna

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

Panoramica delle modalità di invio

Per impostazione predefinita, è possibile inviare query su un hotel per un massimo di 330 giorni prima della disponibilità della camera e per un massimo di 30 notti di soggiorno, ma puoi determinare il numero massimo di itinerari (combinazione di data di check-in e durata del soggiorno).

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

I metodi tipici 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 il push dei messaggi contenenti un sottoinsieme di informazioni che rappresentano un modello di prezzi per le tue proprietà in base a vari dettagli delle tariffe, limitazioni e disponibilità. I feed ARI utilizzano la specifica XML OTA (OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ) per definire la disponibilità e i prezzi. Contatta il tuo account manager per saperne di più sulla modalità di invio ARI e per determinare se questo tipo di feed è più adatto al tuo account. Per ulteriori informazioni, consulta la sezione Utilizzare il feed ARI.

• Pull: Google esegue periodicamente query sul servizio 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 sui prezzi 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 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 l'eccezione 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 quando aggiorni i prezzi e la 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 scoprire di più, consulta la sezione Rimuovere dall'inventario.

Per ulteriori informazioni su come fornire aggiornamenti dei prezzi, inclusi esempi di messaggi Transaction, consulta la pagina Aggiornare i prezzi.

Query sui prezzi in tempo reale

Google può anche richiedere alcuni aggiornamenti dei prezzi al momento dell'asta tramite query sui prezzi in tempo reale. Le query sui prezzi in tempo reale sono richieste sui prezzi inviate 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.

Punto chiave: a causa della nuova esperienza di ricerca, Live Query non è più disponibile per gli utenti dello Spazio economico europeo.

Contesto

Le query Pull e Prezzo modificato generalmente 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, una funzionalità è in fase di test in cui i contesti di utenti più utilizzati 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 vedere un numero elevato di contesti utente per proprietà o itinerari molto popolari, ma il numero medio di contesti degli utenti dovrebbe essere inferiore a 10. Puoi restituire prezzi aggiuntivi o ignorare contesti utente specifici: spetta a te decidere quali prezzi restituire per una determinata query. Se ignori un contesto utente suggerito, potresti ridurre il 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 sei pronto a ricevere questi messaggi, quindi apporta una modifica 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 vari componenti delle informazioni sui prezzi in Google.

Il seguente diagramma mostra il flusso di richiesta e risposta 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 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 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 che sono stati rilevati avvisi o errori relativi alla modalità di invio.

Inserisci 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 struttura. Devi eseguire il push degli aggiornamenti ogni volta che vengono aggiunti, rimossi o modificati tipi di camera o piani tariffari. In questo caso, devi 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 in 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 nuovi tentativi, interrompi l'invio di 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 a questi 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 modo più dettagliato 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 le procedure 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 POST HTTP. Se utilizzi HTTPS, il dominio deve essere firmato da un'autorità di certificazione ufficiale.
• L'intestazione Content-Type è impostata su application/xml.
• Ogni 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: l'aggiornamento di tutti i prezzi di tutti gli hotel potrebbe richiedere molti messaggi Query e i messaggi Transaction risultanti potrebbero essere molto grandi. Per ridurre le dimensioni e il numero di messaggi, 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 Messaggi di transazione e Aggiornare i 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 usi 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 averla impostata durante la configurazione iniziale.

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

Il seguente diagramma mostra il flusso di richiesta e risposta per la modalità Prezzo modificato:

Le sezioni seguenti descrivono ogni passaggio 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 deve 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 l'ultima volta che hai risposto 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 aggiornati dopo il 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 i messaggi 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 per le proprietà che hai specificato nel messaggio Hint Response. L'elemento principale di un messaggio Query è <Query>.

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

Passaggio 4: messaggio Transaction

Invii 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 la sezione Modalità di invio Pull.