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. Tu e il tuo Technical Account Manager (TAM) collaborerete durante la configurazione iniziale per impostare la modalità di invio.

Panoramica delle modalità di invio

Per impostazione predefinita, è possibile fare query su un hotel con un anticipo massimo di 330 giorni rispetto alla disponibilità delle camere e fino a 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ù aste potrai partecipare. Tuttavia, più itinerari gestisci, più dati 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 determinazione dei prezzi predefinite per le tue proprietà. A differenza delle modalità Pull e Prezzo modificato, i feed ARI non eseguono query per prezzi o itinerari specifici. Devi invece eseguire 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 disponibilità e prezzi. Contatta il tuo account manager per scoprire di più sulla modalità di invio ARI e per determinare se questo tipo di feed è più adatto al tuo account. Per maggiori informazioni, consulta la pagina Utilizzare il feed ARI.

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

  • Prezzo modificato (in precedenza Pull with Hints): simile alla modalità Pull, ma Google richiede i dati solo per un sottoinsieme di proprietà, non per tutte le proprietà. 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 per sempre fino all'aggiornamento. Per ulteriori informazioni, consulta la sezione Utilizzo dei prezzi modificati.

Oltre ad aggiornare i 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 con le query sui prezzi in tempo reale. Le query sui prezzi in tempo reale sono richieste di prezzi inviate da Google per un'asta in corso. Se rispondi entro il periodo di tempo specificato, il tuo annuncio dovrebbe comparire 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 dalla cache anziché inviare un'altra query sui prezzi in tempo reale in futuro.

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 diversi utenti.

Poiché potrebbe essere costoso restituire prezzi corrispondenti a un set completo di possibili contesti utente, è in corso il test di una funzionalità in cui nella query vengono specificati i contesti più diffusi degli utenti. I contesti utente si basano sulle richieste degli utenti in cui hai avuto l'opportunità di mostrare un prezzo e vengono calcolati in modo da 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 utente 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. Tuttavia, ignorare un contesto utente suggerito potrebbe comportare una riduzione del traffico.

Modalità di invio Push ARI

Con la modalità di invio Push del feed ARI, invii aggiornamenti incrementali a Google ogni volta che le tariffe per notte, la disponibilità, i conteggi dell'inventario o altre limitazioni cambiano. A differenza dei prezzi pull o modificati, la modalità push ARI 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:

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 Utilizzare il feed ARI.

I prezzi devono 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 nella cache da Google

Per ogni messaggio push ARI ricevuto, Google risponde con lo stato della connessione HTTP e i risultati di 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 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 attivi (pacchetti) per ogni proprietà. Devi eseguire il push degli aggiornamenti ogni volta che tipi di camere o piani tariffari vengono aggiunti, rimossi o modificati. In questo caso, invii un messaggio XML con le nuove informazioni negli elementi <RoomData> e <PackageData>. Questi elementi sono secondari dell'elemento <PropertyDataSet>.

Errori di connessione o relativi ai contenuti

Se ricevi un messaggio di errore relativo alla modalità di invio perché il formato XML non è corretto o non è corretto, cerca la soluzione 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 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 di prezzo. 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à di invio pull:

fig2

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 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 POST HTTP. Se utilizzi HTTPS, devi ottenere la firma del dominio da parte di 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.

Aggiorna 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 pacchetto.

Modalità di invio dei prezzi modificati

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

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

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

fig3

Le seguenti sezioni descrivono tutti i passaggi 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 dovrà essere firmato da un'autorità di certificazione ufficiale.
  • L'intestazione Content-Type è impostata su application/xml.
  • In base a 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 indicando tutti i prezzi aggiornati dal timestamp in questione. 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 cambiati 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 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 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 quelle 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 maggiori informazioni, consulta Modalità di invio pull.