Messaggi Query

I messaggi Query sono richieste di aggiornamenti di prezzi o metadati inviate da Google. Loro vengono utilizzati sia con i prezzi pull che con quelli modificati modalità di invio.

L'elemento principale dei messaggi Query è <Query>.

La struttura del messaggio Query dipende dal tipo di messaggio:

• Prezzi:Google invia un messaggio Query in cui vengono richiesti gli aggiornamenti sui prezzi gli hotel specificati.

• Metadati: Google invia un messaggio Query in cui vengono richiesti i dati sulle camere e sui pacchetti negli hotel specificati.

Devi definire l'endpoint utilizzato da Google per i messaggi Query e le query sui prezzi in tempo reale durante la configurazione iniziale. Per ulteriori informazioni, contatta il tuo Technical Account Manager (TAM).

Google invia un messaggio Query come richiesta POST HTTP con Content-Type intestazione impostata su "application/xml" e l'intestazione User-Agent impostata su Google-HotelAdsPrices. L'eccezione a questa regola si verifica durante la prova manuale l'integrazione dell'endpoint di prezzo tramite Google-TravelAds-Live. Queste query di esempio potrebbero contenere o non contenere l'intestazione User-Agent.

La formattazione dettagliata dei messaggi Query è disponibile nella Riferimento XML per le query.

Messaggi di query sui prezzi

I messaggi Query sui prezzi specificano le combinazioni di proprietà e itinerario per cui tu fornisci i prezzi.

Quando riceve un messaggio Query sui prezzi, il server deve rispondere con un Messaggio <Transaction> contenente le informazioni sui prezzi richieste.

Per ulteriori informazioni, consulta la Panoramica dei prezzi.

Esistono tre tipi speciali di messaggi Query:

1. Prezzi in tempo reale: se questa opzione è attivata, le query vengono inviate quando un utente sta esaminando attivamente i prezzi per la proprietà o la combinazione di itinerari specificata e hai un periodo di tempo specificato per rispondere.

2. Con contesto: se questa opzione è attiva, i suggerimenti relativi al contesto dell'utente sono inclusi in ogni query che Google ti invia e i consigli riflettono tipi comuni di utenti che cercano la proprietà o l'itinerario in questione combinazioni. Seguire questi consigli può aumentare l'efficacia delle tue risposte.

3. Metadati: si tratta di una richiesta di dettagli su camere e pacchetti per il proprietà specificate.

Query sui prezzi in tempo reale

Le query sui prezzi in tempo reale sono richieste di aggiornamenti dei prezzi in tempo reale da parte di Google risposta alle ricerche degli utenti. Google riceve una richiesta di ricerca da un utente per combinazione di hotel o itinerario e perché i dati sui prezzi non sono disponibili o meno corrente, Google ti richiede un aggiornamento del prezzo al momento della ricerca. Con le query sui prezzi in tempo reale, Google tenta di ottenere un prezzo e di mostrarlo nei risultati al momento della ricerca.

Tutte le richieste di query sui prezzi in tempo reale hanno un limite di tempo di risposta, solitamente fino a 4000 millisecondi. Questo limite è specificato nella richiesta della query sui prezzi in tempo reale. La mancata risposta entro il limite di tempo comporta la mancata partecipazione all'opportunità specifica. Tuttavia, ti consigliamo di indicare comunque un prezzo in modo che possa essere memorizzato nella cache e utilizzato per opportunità future. La connessione per la risposta rimane aperta per dieci minuti o come specificato nella configurazione del partner.

Anche le query sui prezzi in tempo reale sono contestuali e possono recuperare i prezzi per i seguenti parametri: paese dell'utente, tipo di dispositivo, occupazione (numero di ospiti), e se questi ospiti sono adulti o bambini. Con le query sui prezzi in tempo reale, possono mostrare prezzi più aggiornati che corrispondono a ciò che il cliente ha cercato.

Le query sui prezzi in tempo reale sono intese come meccanismo secondario di determinazione dei prezzi aggiornamenti. Il meccanismo principale per la rideterminazione dei prezzi prevede comunque le modalità Pull o Prezzo modificato. Le query sui prezzi in tempo reale consentono di colmare le lacune nei dati nei casi in cui Google non dispone dei prezzi per le combinazioni di hotel o itinerari.

Punto chiave: a causa della nuova esperienza di ricerca, la query in tempo reale non è più disponibile quando l'utente si trova in un paese dello spazio SEE e invia una query di navigazione (specifica per hotel) con date o modifica le date nella pagina dei risultati di ricerca.

Regole per l'utilizzo delle query sui prezzi in tempo reale

• Non esistono dati memorizzati nella cache per l'itinerario in questione perché l'itinerario richiesto è atipico, ad esempio le date sono molto avanti nel tempo o perché l'hotel viene cercato molto raramente.

• La data richiesta è una data non predefinita.

Nota: le date predefinite non sono idonee per le query sui prezzi in tempo reale. Attivo Le query sui prezzi vengono richieste solo per le date non predefinite.

In genere Google memorizza nella cache i risultati di un prezzo in tempo reale in modo che lo stesso hotel o non vengono più interrogate. Può richiedere sia combinazioni di hotel o itinerari singoli sia combinazioni di più hotel o di un solo itinerario.

La funzionalità Prezzi in tempo reale con contesto consente a Google di inviare Richieste di prezzi in tempo reale in base al tipo di dispositivo di un utente, il paese da cui che cercano e il numero di persone che abitano, inclusi i bambini. Entrambi i campi Il messaggio Query e il messaggio Transaction sono espansi per includere Elemento <Context> che definisce i parametri di query. Prezzi ricevuti da Le query sui prezzi in tempo reale con contesto possono essere memorizzate nella cache come pacchetto camera, se si tratta di un prezzo per un numero di persone specifico e come tariffa agevolata, se è per il paese o il dispositivo dell'utente.

Con query di contesto

Le query di contesto sono richieste regolari di aggiornamento del database per combinazioni di proprietà o itinerario specificate. Contengono un elenco di contesti dell'utente che sono popolari per queste combinazioni. Se vengono utilizzate le tariffe agevolate, l'invio di tariffe per tutti i possibili contesti utente potrebbe essere costoso, pertanto puoi utilizzare questo elenco di contesti utente per limitare la risposta. Prezzi di ritorno solo per i contesti utente specificati coprono la maggior parte delle query pertinenti degli utenti.

Se ti interessa ricevere query con contesto, contatta il tuo Technical Account Manager (TAM). Può confermare che sei pronto a ricevere questi messaggi e apportare una modifica alla configurazione per iniziare a inviarti i contesti utente nelle query.

Punto chiave: la lingua non è specificata nei messaggi di richiesta con contesto. Quindi, se specifica <LanguageCode> nelle regole tariffarie, quindi la risposta con contesto devono includere tutte le tariffe pertinenti specifiche per la lingua. In caso di dubbi, ti consigliamo di utilizzare le condizioni per il paese anziché le condizioni per la lingua determinare l'origine o la nazionalità dell'utente. Tuttavia, se hai tariffe che sono specifiche per la lingua principale dell'utente, quindi usa le condizioni relative alla lingua.

Messaggi di query sui metadati

I messaggi di query sui metadati contengono dettagli sulle informazioni su camere e pacchetti per le proprietà specificate.

Quando ricevi un messaggio Query sui metadati, devi rispondere con un messaggio <Transaction> che specifica i prezzi per le proprietà richieste in elementi <Result>.

Per ulteriori informazioni, consulta la sezione Definire i metadati di camere e pacchetti.

Controlla le query

Questa sezione descrive come controllare quali proprietà e itinerari può essere l'oggetto di messaggi Query di Google.

Confini degli itinerari

Puoi determinare i possibili limiti delle query sui prezzi utilizzando <ItineraryCapabilities>. Devi definire le regole che determinano l'intervallo di date e la durata massima dei soggiorni supportati.

Puoi impostare valori predefiniti per <MaxAdvancePurchase> e <MaxLengthOfStay> che si applicano a tutte le combinazioni di hotel o itinerario. Puoi anche definire queste impostazioni per gruppi di hotel.

Esempi di messaggi di query

Questa sezione mostra diversi esempi di messaggi Query sui prezzi e un Messaggio query. Ulteriori esempi sono disponibili nella sezione Riferimento XML per i messaggi Query.

Itinerario di esempio

L'esempio seguente mostra un prezzo <Query> che richiede gli aggiornamenti di prezzo per 4 hotel, disponibile per 3 notti, a partire dal 23 maggio 2023:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

In questo esempio vengono richiesti gli aggiornamenti dei prezzi per ogni hotel:

5/23/18 - 6/26/18

Esempio di query sui prezzi in tempo reale

L'esempio seguente mostra una query sui prezzi in tempo reale con un tempo limite di risposta di 500 millisecondi:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

In questo esempio viene richiesto il prezzo di un singolo hotel:

6/23/23 - 6/25/23

Un esempio di risposta a questa query è disponibile nel Prezzi e Riferimento XML per l'inventario delle camere (Transazioni).

Esempio di query con contesto

L'esempio seguente mostra un esempio di query con contesto:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

Con le query di contesto, puoi specificare solo il contesto del paese dell'utente. In futuro, queste query potrebbero anche specificare il dispositivo e il numero di persone dell'utente.

Intervalli di date di check-in

Se utilizzi Prezzo modificato, la struttura del messaggio Query dipenderà sul tipo di suggerimento che utilizzi per gli intervalli di date di check-in, o gli itinerari con intervallo di date. Per ulteriori informazioni su ciascuno di questi tipi di suggerimenti, consulta la sezione Messaggi Hint Response.

L'esempio seguente mostra un messaggio <Query> sui prezzi per gli intervalli di date di check-in:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

In questo esempio vengono richiesti gli aggiornamenti dei prezzi per i seguenti soggiorni (per ciascun hotel):

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

Soggiorni con intervallo di date

L'esempio seguente mostra un messaggio <Query> relativo ai prezzi per un intervallo di date soggiorni:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

In questo esempio vengono richiesti gli aggiornamenti dei prezzi per ciascun hotel:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

Più i soggiorni che sono iniziati prima della notte specificata (che è inclusa):

5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

Messaggi Query sui metadati

L'esempio seguente mostra un messaggio <Query> che richiede l'aggiornamento dei metadati per le informazioni sulle camere e sui pacchetti per diverse proprietà:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

Devi rispondere a questo tipo di messaggio Query con un messaggio Transaction in cui definisci i metadati di camere e pacchetti. Per ulteriori informazioni, consulta la sezione Definire i metadati di camere e pacchetti.