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. La modalità di invio viene configurata da te insieme al tuo Technical Account Manager (TAM) durante la configurazione iniziale.

Panoramica delle modalità di invio

Per impostazione predefinita, un hotel può ricevere query sulla disponibilità delle camere con un anticipo massimo di 330 giorni e per un numero 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, più saranno le aste a cui riuscirai a partecipare. Tuttavia, più itinerari gestisci, più dati dovrai inviare a Google per garantire l'accuratezza delle informazioni sui prezzi.

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

• ARI (Push): un feed per l'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 relative a prezzi o itinerari specifici. Invece, esegui il push di messaggi contenenti un sottoinsieme di informazioni che rappresentano un modello di prezzi per le tue proprietà basato su 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 è il più adatto al tuo account. Per ulteriori informazioni, consulta la sezione Utilizzare il feed ARI.

• Pull: Google invia periodicamente query al servizio per aggiornare la cache dei dati su prezzi e disponibilità. Con questo modello, Google invia una richiesta al tuo server, che risponde con i dati aggiornati. Si tratta del modello migliore se non sai esattamente quando cambiano le informazioni sui prezzi o se i cambiamenti avvengono a intervalli irregolari nel corso della giornata. I prezzi rimangono nella cache fino a quando gli algoritmi di Google stabiliscono che sono diventati obsoleti, in base alla cronologia delle modifiche ai prezzi precedenti dello specifico partner. Per ulteriori informazioni, consulta la sezione Utilizzare la modalità Pull.

• Prezzo modificato (in precedenza Pull with Hints): questa modalità è simile alla modalità Pull, con la differenza che Google richiede i dati solo per un sottoinsieme di proprietà, non per tutte. Può ridurre notevolmente la quantità di traffico di rete durante l'aggiornamento dei prezzi e della disponibilità per le tue proprietà. I prezzi rimangono nella cache senza limiti di tempo, finché non vengono aggiornati. Per ulteriori informazioni, consulta la sezione Utilizzare la modalità Prezzo modificato.

Oltre che per l'aggiornamento dei prezzi, puoi utilizzare i messaggi Transaction per rimuovere le proprietà dal tuo inventario. Per ulteriori informazioni, consulta la sezione Rimuovere 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 query sui prezzi in tempo reale. Le query sui prezzi in tempo reale sono richieste di prezzi effettuate da Google in merito a 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. In questo modo, Google può fornire il prezzo memorizzato nella cache invece di inviare un'altra query sui prezzi in tempo reale per le richieste future.

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

Punto chiave :a causa della nuova esperienza di ricerca, la query live ha una disponibilità limitata per gli utenti del SEE.

Contesto

Le query Pull e Changed Pricing in genere non specificano informazioni sull'utente, in quanto Google utilizza le tue risposte per riempire una cache che potrebbe essere utilizzata per servire una serie di utenti diversi.

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

Punto chiave: il paese dell'utente è l'unico contesto supportato in Estrai o Prezzi modificati. I dettagli dell'occupazione e i contesti del tipo di dispositivo devono essere inviati tramite la query sui prezzi in tempo reale con contesto. Consulta gli esempi Con le query contestuali.

Suggerimento: se ti interessa ricevere contesti utente popolari nelle query inviate da Google, contatta il tuo Technical Account Manager (TAM). Ti confermeranno che sei pronto a ricevere questi messaggi, quindi apporteranno una modifica alla 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 di Pull o Prezzo modificato, Push ARI consente di utilizzare un modello di prezzi diverso per fornire a Google aggiornamenti su diversi componenti delle informazioni sui prezzi in modo efficiente.

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

Passaggio 1: invio dei 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: conferma da parte di Google della corretta memorizzazione dei dati nella cache

Per ogni messaggio Push ARI ricevuto, Google risponde con lo stato della connessione HTTP e i risultati dell'elaborazione delle informazioni ARI. Se la connessione al server ha esito positivo, Google risponde con un messaggio HTTP 200 OK. Il corpo del messaggio contiene una risposta che indica se gli aggiornamenti sono stati applicati correttamente o se sono stati riscontrati avvisi o errori relativi alla modalità di invio.

Inserire indirizzi IP nella lista consentita

Per inserire nella lista consentita gli indirizzi IP che utilizzi per 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, devi inviare un messaggio XML con le nuove informazioni negli elementi <RoomData> e <PackageData>. elementi secondari di <PropertyDataSet>.

Errori di connessione o di contenuti

Se ricevi un errore relativo alla modalità di invio a causa di una formattazione inadeguata o errata del codice XML, trova la risoluzione consigliata nella sezione Messaggi di errore relativi allo stato dei feed.

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

Modalità di pubblicazione 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 contenenti dati aggiornati sui prezzi e sulla disponibilità.

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

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

Le sezioni seguenti descrivono in dettaglio i singoli passaggi.

Passaggio 1: messaggio Query

Per impostazione predefinita, Google invia messaggi Query per tutte le proprietà definite nel tuo elenco di hotel. Ciò potrebbe significare che dovresti ricevere più messaggi Query durante le procedure di rideterminazione del prezzo.

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

• L'elemento principale è <Query>.
• Vengono inviati 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 dei prezzi di tutti gli hotel potrebbe comportare l'uso di numerosi messaggi Query e i messaggi Transaction risultanti potrebbero essere molto grandi. Per ridurre le dimensioni e il numero dei messaggi, ti consigliamo di utilizzare la modalità Prezzo modificato.

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 Transaction e Aggiornare i prezzi.

Aggiornare i metadati di camere e pacchetti

Oltre che per l'aggiornamento dei dati dei 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 contribuisce a 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à i cui prezzi sono stati aggiornati. Google risponde con un messaggio Query che richiede solo i prezzi di quelle proprietà.

Per configurare l'endpoint a cui Google invia i messaggi Hint Request, rivolgiti al tuo Technical Account Manager (TAM). Dovresti averlo configurato durante la configurazione iniziale.

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

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

Le sezioni seguenti descrivono ogni passaggio di questo flusso.

Passaggio 1: messaggio Hint Request

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

• L'elemento principale è <HintRequest>.
• Vengono inviati 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.
• Secondo una frequenza specificata, Google invia un timestamp al tuo server che indica quando è stata 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 che sono stati 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 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à da te specificate nel messaggio HintResponse. L'elemento principale di un messaggio Query è <Query>.

Nel determinare gli ID hotel per cui richiedere i prezzi con la modalità 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 con cui devi rispondere.

Passaggio 4: messaggio Transaction

I messaggi Transaction con un aggiornamento sui prezzi vengono inviati 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.