Anfragenachrichten

Anfragenachrichten sind Google-Anfragen zu Preis- oder Metadatenaktualisierungen. Sie werden mit den Übermittlungsmodi „Pull-Preise“ und „Geänderte Preise“ verwendet.

Das Stammelement von Anfragenachrichten ist <Query>.

Die Struktur der Anfragenachricht hängt vom Nachrichtentyp ab:

• Preise: Google fragt in einer Anfragenachricht Preisaktualisierungen für die angegebenen Hotels ab.

• Metadaten: Google sendet eine Anfragenachricht, in der Daten zu den Zimmer- und Paketinformationen in den angegebenen Hotels angefordert werden.

Sie legen den Endpunkt fest, den Google bei der Erstkonfiguration für Abfragenachrichten und Livepreisabfragen verwendet. Weitere Informationen erhalten Sie von Ihrem Technical Account Manager (TAM).

Google sendet eine Anfragenachricht als HTTP-POST-Anfrage, wobei der Header Content-Type auf „application/xml“ und der Header User-Agent auf Google-HotelAdsPrices festgelegt ist. Die Ausnahme von dieser Regel tritt beim manuellen Testen der Einbindung des Preisendpunkts über Google-TravelAds-Live auf. Diese Beispielabfragen können den Header User-Agent enthalten.

Detaillierte Formatierungen für Abfragenachrichten finden Sie in der XML-Referenz für Abfragen.

Preisanfragenachrichten

Preisabfragenachrichten geben die Kombinationen der Unterkünfte oder Reisepläne an, für die Sie die Preise angeben.

Wenn Ihr Server eine Anfragenachricht zu pricing erhält, sollte er mit einer <Transaction>-Nachricht mit den angeforderten Preisinformationen antworten.

Weitere Informationen finden Sie in der Preisübersicht.

Es gibt drei spezielle Arten von Anfragenachrichten:

1. Livepreise: Wenn diese Option aktiviert ist, werden Abfragen gesendet, wenn ein Nutzer aktiv nach Preisen für die angegebene Unterkunft oder Reiseplankombination sucht und Sie innerhalb einer bestimmten Frist antworten müssen.

2. Mit Kontext:Wenn diese Option aktiviert ist, sind Empfehlungen zum Nutzerkontext in jede Abfrage enthalten, die Google Ihnen sendet. Die Empfehlungen spiegeln die häufigsten Nutzertypen wider, die nach bestimmten Kombinationen aus Unterkünften oder Reiseplan suchen. Wenn Sie diese Empfehlungen befolgen, können Sie die Effizienz Ihrer Antworten steigern.

3. Metadata: Dies ist eine Anfrage für Details zu Zimmern und Paketen für die angegebenen Unterkünfte.

Livepreisabfragen

Livepreisabfragen sind Anfragen von Google zu Preisaktualisierungen in Echtzeit als Reaktion auf Suchanfragen von Nutzern. Google erhält von einem Nutzer eine Suchanfrage für eine Kombination aus Hotel oder Reiseplan. Da keine oder nicht aktuellen Preisdaten verfügbar sind, fordert Google zum Zeitpunkt der Suche eine Preisaktualisierung von Ihnen an. Bei Livepreisabfragen versucht Google, einen Preis abzurufen und ihn zum Zeitpunkt der Suche in den Ergebnissen anzuzeigen.

Alle Anfragen für Livepreise haben eine Antwortzeit von normalerweise bis zu 4.000 Millisekunden. Dieses Limit wird in der Anfrage zur Abfrage der Livepreise angegeben. Wenn eine Antwort nicht innerhalb der Frist erfolgt, wird die Teilnahme an der jeweiligen Gelegenheit verpasst. Wir empfehlen jedoch, trotzdem einen Preis anzugeben, damit er im Cache gespeichert und für zukünftige Möglichkeiten verwendet werden kann. Die Verbindung für die Antwort bleibt zehn Minuten lang oder wie in der Partnerkonfiguration angegeben geöffnet.

Livepreisabfragen sind auch kontextabhängig und können Preise für die folgenden Parameter abrufen: Land des Nutzers, Gerätetyp, Belegung (Anzahl der Gäste) und ob diese Gäste Erwachsene oder Kinder sind. Mit Livepreisabfragen können Sie aktuellere Preise anzeigen, die der Suchanfrage des Kunden entsprechen.

Livepreisabfragen sind als sekundärer Mechanismus für Preisaktualisierungen gedacht. Der primäre Mechanismus für die Preisneuberechnung ist weiterhin „Pull-Preise“ oder „Geänderte Preise“. Livepreisabfragen helfen, Lücken zu schließen, bei denen Google keine Preise für Hotel- oder Reiseplankombinationen zur Verfügung hat.

Wichtiger Hinweis :Aufgrund der neuen Suche ist die Liveabfrage nicht mehr verfügbar, wenn sich der Nutzer in einem EWR-Land befindet und eine Navigationsabfrage (hotelspezifisch) mit Datumsangaben oder Datumsänderungen auf der Suchergebnisseite durchführt.

Regeln für die Verwendung von Livepreisabfragen

• Im Cache sind keine Daten für den angegebenen Reiseplan vorhanden, da der angefragte Reiseplan atypisch ist, z. B. weil die Daten sehr weit in der Zukunft liegen oder nach dem Hotel nur selten gesucht wird.

• Das angeforderte Datum ist kein Standarddatum.

: Hinweis: Die Standardtermine können nicht für Livepreisabfragen verwendet werden. Livepreisabfragen werden nur für nicht standardmäßige Datumsangaben angefordert.

Google speichert die Ergebnisse von Livepreisen in der Regel im Cache, damit dasselbe Hotel oder derselbe Reiseplan nicht noch einmal abgefragt werden. Es können sowohl Kombinationen aus einem einzelnen Hotel oder Reiseplan als auch Kombinationen mit mehreren Hotels oder Reiseplänen angefordert werden.

Mit der Funktion Livepreise mit Kontext kann Google bestimmte Livepreisanfragen basierend auf dem Gerätetyp eines Nutzers, dem Land, aus dem er sucht, und der Anzahl der Personen, einschließlich Kindern, senden. Sowohl die Anfragenachricht als auch die Transaktionsnachricht werden um das Element <Context> erweitert, das die Abfrageparameter definiert. Preise, die aus Livepreisabfragen mit Kontext empfangen werden, können als Zimmerpaket im Cache gespeichert werden, wenn es sich um einen Preis für eine bestimmte Belegung handelt, und als nutzerabhängiger Preis, wenn sie für ein Land oder ein Nutzergerät gelten.

Mit Kontextabfragen

Kontextabfragen sind regelmäßige Anfragen zur Aktualisierung unserer Datenbank für die angegebenen Kombinationen aus Unterkünften oder Reiseplan. Sie enthalten eine Liste von Nutzerkontexten, die für diese Kombinationen beliebt sind. Wenn nutzerabhängige Preise verwendet werden, kann das Senden von Preisen für alle möglichen Nutzerkontexte teuer sein. Daher können Sie diese Liste von Nutzerkontexten verwenden, um Ihre Antwort einzuschränken. Die Rückgabe von Preisen nur für die angegebenen Nutzerkontexte deckt die überwiegende Mehrheit der relevanten Nutzeranfragen ab.

Wichtiger Hinweis: Wenn Sie an Anfragen mit Kontext interessiert sind, wenden Sie sich an Ihren Technical Account Manager (TAM). Er kann bestätigen, dass Sie zum Empfangen solcher Nachrichten bereit sind, und dann eine Konfigurationsanpassung vornehmen, um Nutzerkontexte in Abfragen an Sie zu senden.

Nachrichten zu Metadatenabfragen

Metadaten-Abfragenachrichten enthalten Details zu Zimmer- und Paketinformationen für die angegebenen Unterkünfte.

Wenn Sie eine Anfragenachricht zu metadata erhalten, sollten Sie mit einer <Transaction>-Nachricht antworten, in der die Preise für die angeforderten Unterkünfte in <Result>-Elementen angegeben sind.

Weitere Informationen finden Sie unter Definieren von Zimmer- und Paketmetadaten.

Kontrollabfragen

In diesem Abschnitt wird beschrieben, wie Sie steuern, welche Unterkünfte und Reisepläne Gegenstand von Anfragenachrichten von Google sein können.

Grenzen von Reiseplänen

Sie legen die möglichen Grenzen von Preisabfragen mit <ItineraryCapabilities> fest. Sie definieren Regeln, die den Datumsbereich und die maximale Aufenthaltsdauer festlegen, die Sie unterstützen.

Sie können für <MaxAdvancePurchase> und <MaxLengthOfStay> Standardwerte festlegen, die für alle Kombinationen aus Hotel oder Reiseplan gelten. Sie können diese Einstellungen auch für Hotelgruppen definieren.

Beispiele für Abfragenachrichten

Dieser Abschnitt enthält mehrere Beispiele für Preisabfragenachrichten und eine Metadatenanfragenachricht. Weitere Beispiele finden Sie in der XML-Referenz für Abfragen.

Beispielreiseplan

Das folgende Beispiel zeigt eine Preis-<Query>, mit der Preisaktualisierungen für 4 Hotels für 3 Nächte ab dem 23. Mai 2023 angefordert werden:

<?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 diesem Beispiel werden Preisaktualisierungen für jedes Hotel angefordert:

5/23/18 - 6/26/18

Beispiel für eine Abfrage für Livepreise

Das folgende Beispiel zeigt eine Livepreisabfrage mit einer Antwortzeit von 500 Millisekunden:

<?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 diesem Beispiel wird ein Preis für ein einzelnes Hotel angefordert:

6/23/23 - 6/25/23

Ein Beispiel für eine Antwort auf eine Transaktionsnachricht auf diese Abfrage finden Sie in der XML-Referenz für Preise und Zimmerinventar (Transaktionen).

Beispiel für eine Abfrage mit Kontext

Das folgende Beispiel zeigt ein Beispiel mit Kontextabfrage:

<?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>

Bei Kontextabfragen wird nur das Land des Nutzers angegeben. In Zukunft könnten solche Abfragen auch Angaben zu Gerät und Belegung des Nutzers machen.

Check-in-Zeiträume

Wenn Sie „Geänderte Preise“ verwenden, hängt die Struktur der Anfragenachricht vom Hinweistyp ab, den Sie für Check-in-Zeiträume, genaue Reisepläne oder Reisepläne mit bestimmten Zeiträumen verwenden. Weitere Informationen zu jedem dieser Hinweistypen finden Sie unter Hinweisantwortnachrichten.

Das folgende Beispiel zeigt eine Preisnachricht <Query> für Check-in-Zeiträume:

<?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 diesem Beispiel werden Preisaktualisierungen für die folgenden Aufenthalte (für jedes Hotel) angefordert:

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

Aufenthalte in bestimmten Zeiträumen

Das folgende Beispiel zeigt eine Preis-<Query>-Nachricht für Aufenthalte in bestimmten Zeiträumen:

<?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 diesem Beispiel werden Preisaktualisierungen für jedes Hotel angefordert:

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

Außerdem werden Aufenthalte angefordert, deren Startdatum vor dem gegebenen Datum liegen (dieses aber beinhalten):

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

Nachricht zur Metadatenabfrage

Im folgenden Beispiel sehen Sie eine <Query>-Nachricht, mit der Metadatenaktualisierungen für die Zimmer- und Paketinformationen für mehrere Unterkünfte angefordert werden:

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

Sie antworten auf diese Art von Anfragenachricht mit einer Transaktionsnachricht, in der Zimmer- und Paketmetadaten definiert werden. Weitere Informationen finden Sie unter Definieren von Zimmer- und Paketmetadaten.