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 itinerari. 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, è possibile effettuare query su un hotel con un anticipo massimo di 330 giorni rispetto alla disponibilità delle camere 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.

I metodi tipici 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, invii 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 scoprire 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. Questo modello è ideale se non sai esattamente quando cambiano le informazioni sui prezzi o se queste cambiano in modo irregolare 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à di invio Pull.

  • Prezzi modificati (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.

Contesto

In genere, le query di estrazione e sui prezzi modificati non specificano informazioni sull'utente, poiché Google utilizza le tue risposte per compilare una cache che potrebbe essere utilizzata per pubblicare annunci per una serie di utenti diversi.

Poiché potrebbe essere costoso restituire i prezzi corrispondenti a un insieme completo di possibili contesti utente, è in corso il test di una funzionalità in cui i contesti utente più diffusi sono specificati all'interno della query. I contesti utente si basano sulle richieste degli utenti in cui hai avuto la possibilità di mostrare un prezzo e vengono calcolati per coprire la maggior parte delle richieste degli utenti. Potresti visualizzare un numero elevato di contesti utente per proprietà o itinerari molto apprezzati, ma il numero medio di contesti utente dovrebbe essere inferiore a 10. Puoi restituire prezzi aggiuntivi o ignorare i 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.

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:

fig1

Passaggio 1: invia i 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 siano stati 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 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 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 contenenti dati aggiornati su prezzi e disponibilità.

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

fig2

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).
  • Utilizzano 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.

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. La modalità Prezzo modificato prevede che tu 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, consulta il tuo Technical Account Manager (TAM). Dovresti averlo configurato durante la configurazione iniziale.

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

fig3

Le sezioni seguenti descrivono i singoli passaggi in 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 HintRequest 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

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.