Anfragenachrichten

Anfragenachrichten sind Google-Anfragen zu Preis- oder Metadatenaktualisierungen. Sie werden sowohl mit den Pull-Preisen als auch mit den geänderten Preisen Übermittlungsmodi.

Das Stammelement von Anfragenachrichten ist <Query>.

Die Struktur der Anfragenachricht hängt vom Nachrichtentyp ab:

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

• Metadaten:Google sendet eine Anfragenachricht, mit der Daten zum Raum angefordert werden. und Paketinformationen in den angegebenen Hotels.

Sie definieren den Endpunkt, den Google für Anfragenachrichten und Live-Inhalte verwendet. Preisabfragen während der Erstkonfiguration. Weitere Informationen wenden Sie sich an Ihren Technical Account Manager (TAM).

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

Detaillierte Formatierungen für Anfragenachrichten finden Sie im XML-Referenz für Abfragen

Preisanfragenachrichten

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

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

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 für die angegebene Kombination von Unterkünften oder Reiseplan innerhalb eines bestimmten Zeitraums beantwortet werden.

2. Mit Kontext:Wenn diese Option aktiviert ist, werden Empfehlungen zum Nutzerkontext in die Google Ihnen sendet, und die Empfehlungen spiegeln am meisten Häufige Typen von Nutzern, die nach der Unterkunft oder dem Reiseplan suchen Kombinationen. Wenn Sie diese Empfehlungen umsetzen, können Sie Ihre Antworten.

3. Metadaten: Dies ist eine Anfrage für Details zu Zimmern und Paketen für die angegebenen Eigenschaften.

Livepreisabfragen

Livepreisabfragen sind Anfragen von Google nach Echtzeit-Preisaktualisierungen in auf Suchanfragen von Nutzern. Google erhält von einem Nutzer eine Suchanfrage Hotel- oder Reiseplankombination und weil keine Preisdaten verfügbar sind oder nicht fordert Google zum Zeitpunkt der Suche eine Preisaktualisierung von Ihnen an. Mit Bei einer Livepreisabfrage versucht Google, einen Preis zu erhalten und im Ergebnisse zum Zeitpunkt der Suche angezeigt.

Alle Anfragen zu Livepreisabfragen haben ein Zeitlimit für die Antwort, das in der Regel bei bis zu 4.000 Millisekunden. Dieses Limit wird in der Abfrage der Livepreise angegeben Wenn eine Antwort nicht innerhalb der Frist erfolgt, führt dies zu eine verpasste Teilnahme für die jeweilige Chance. Wir empfehlen jedoch, Trotzdem einen Preis angeben, damit er im Cache gespeichert und für zukünftige Empfehlungen verwendet werden kann. Die Verbindung für die Antwort bleibt zehn Minuten oder die in der Konfiguration des Partners angegeben sind.

Livepreisabfragen sind kontextbezogen und können Preise für die folgenden Parameter: Land des Nutzers, Gerätetyp, Belegung (Anzahl der Gäste), ob es sich dabei um Erwachsene oder Kinder handelt. Bei Livepreisabfragen können Sie können aktuellere Preise angezeigt werden, die der Suchanfrage des Kunden entsprechen.

Livepreisabfragen sind ein sekundärer Mechanismus zur Preisgebung Aktualisierungen. Der primäre Mechanismus für die Preisneuberechnung ist weiterhin „Pull“ oder „Geändert“. Preise. Livepreisabfragen helfen, Lücken zu schließen, die Google nicht über Preise für Hotel- oder Reiseplankombinationen berechnet.

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

Regeln für die Verwendung von Livepreisabfragen

• Für den angegebenen Reiseplan sind keine im Cache gespeicherten Daten vorhanden, da der angeforderte Reiseplan untypisch ist, z. B. dass die Termine sehr weit in der Zukunft liegen oder das Hotel nach denen selten gesucht wird.

• Das angeforderte Datum ist kein Standarddatum.

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

Google speichert die Ergebnisse von Livepreisen in der Regel so, dass dasselbe Hotel oder Reiseplan werden nicht noch einmal abgefragt. Es kann sowohl ein Hotel als auch ein Reiseplan angefordert werden. oder Kombinationen für mehrere Hotels oder für einen einzelnen Reiseplan erstellen.

Mit der Funktion Livepreise mit Kontext kann Google Ihnen Livepreisanfragen basierend auf dem Gerätetyp eines Nutzers und dem Land, aus dem der Personen, die sie suchen, und die Anzahl der Personen, einschließlich Kindern. Sowohl die Die Anfragenachricht und die Transaktionsnachricht werden um Folgendes erweitert: <Context>-Element, das die Abfrageparameter definiert. Preise erhalten von Livepreisabfragen mit Kontext können als Zimmerpaket, wenn es sich um einen Preis für eine bestimmte Belegung und als nutzerabhängiger Preis handelt, wenn es sich um ein Nutzerland oder Nutzergerät handelt.

Mit Kontextabfragen

Bei Kontextabfragen handelt es sich um regelmäßige Anfragen zur Aktualisierung unserer Datenbank für Kombinationen aus Unterkünften oder Reiseplänen. Sie enthalten eine Liste der Nutzenden, Kontexte, die für diese Kombinationen beliebt sind. Wenn Nutzerabhängige Preise verwendet wird, dann dass die Versandpreise für alle möglichen Nutzerkontexte teuer sein können. Daher können Sie Verwenden Sie diese Liste von Nutzerkontexten, um Ihre Antwort einzuschränken. Wiederkehrende Preise nur für die angegebenen Nutzerkontexte die überwiegende Mehrheit der relevanten Nutzeranfragen abdecken.

Wichtiger Hinweis: Wenn Sie an Anfragen mit Kontext interessiert sind, wenden Sie sich an Ihren Technical Account Manager (TAM). So kann bestätigt werden, dass Sie diese Nachrichten empfangen können, und nehmen dann eine Konfigurationsanpassung vor, um mit der durch das Senden von Nutzerkontexten in Abfragen.

Nachrichten zu Metadatenabfragen

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

Wenn du eine Anfragenachricht zu metadata erhältst, solltest du mit Eine <Transaction>-Nachricht, in der die Preise für die angeforderten Unterkünfte angegeben sind in <Result>-Elementen.

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

Kontrollabfragen

In diesem Abschnitt wird beschrieben, wie Sie festlegen, welche Unterkünfte und Reisepläne Sie nutzen. kann der Betreff von Anfragenachrichten von Google sein.

Grenzen von Reiseplänen

Sie bestimmen die möglichen Grenzen von Preisabfragen mithilfe von <ItineraryCapabilities> Sie definieren Regeln, die den Zeitraum festlegen. und die von Ihnen unterstützte maximale Aufenthaltsdauer.

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

Beispiele für Abfragenachrichten

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

Beispielreiseplan

Das folgende Beispiel zeigt ein Preis-<Query>, das Preisaktualisierungen anfordert für 4 Hotels, ab 23. Mai 2023 für 3 Nächte verfügbar:

<?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 einem Zeitlimit für die 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 Preise und XML-Referenz für 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. Künftig werden solche können auch das Gerät und die Belegung des Nutzers angegeben werden.

Check-in-Zeiträume

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

Das folgende Beispiel zeigt eine Preis-<Query>-Nachricht für das Check-in-Datum Bereiche:

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

Aufenthalte in bestimmten Zeiträumen

Im folgenden Beispiel sehen Sie eine Preisnachricht <Query> für bestimmte Zeiträume. Aufenthalte:

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

Das folgende Beispiel zeigt eine <Query>-Nachricht, die Metadaten anfordert Updates für die Zimmer- und Paketinformationen verschiedener Unterkünfte:

<?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, definiert Zimmer- und Paketmetadaten. Weitere Informationen finden Sie unter Zimmer- und Paketmetadaten definieren.