Wiadomości z zapytaniami

Wiadomości z zapytaniami to prośby Google o aktualizacje cen lub metadanych. Są one używane w przypadku trybów dostawy Pobieranie cen z podpowiedziami i Zmiana cen.

Elementem głównym wiadomości zapytania jest <Query>.

Struktura wiadomości z zapytaniem zależy od typu wiadomości:

Ceny: Google wysyła wiadomość z zapytaniem o aktualizacje cen w przypadku określonych hoteli.
Metadane: Google wysyła wiadomość z zapytaniem o dane dotyczące pokoju i informacje o pakiecie w określonych hotelach.

Podczas konfiguracji początkowej określasz punkt końcowy, którego Google używa w przypadku zapytań i zapytań o ceny w czasie rzeczywistym. Aby uzyskać więcej informacji, skontaktuj się z menedżerem technicznym konta.

Google wysyła wiadomość z zapytaniem jako żądanie HTTP POST z nagłówkiem Content-Type ustawionym na „application/xml” i nagłówkiem User-Agent ustawionym na Google-HotelAdsPrices. Wyjątek od tej reguły występuje podczas ręcznego testowania integracji punktu końcowego ceny za pomocą Google-TravelAds-Live. Przykładowe zapytania mogą zawierać nagłówek User-Agent lub nie.

Szczegółowe informacje o formatowaniu wiadomości z zapytaniami znajdziesz w dokumentacji XML zapytań.

Wiadomości z zapytaniami o ceny

Wiadomości z zapytaniem o cenę określają kombinacje obiektu i planu podróży, dla których podajesz ceny.

Gdy serwer otrzyma wiadomość z zapytaniem pricing, powinien odpowiedzieć wiadomością <Transaction> zawierającą żądane informacje o cenach.

Więcej informacji znajdziesz w omówieniu cen.

Istnieją 3 specjalne typy wiadomości z zapytaniem:

Ceny rzeczywiste: jeśli ta opcja jest włączona, zapytania są wysyłane, gdy użytkownik aktywnie przegląda ceny określonego obiektu lub kombinacji planu podróży, a Ty masz określony termin na odpowiedź.
Z kontekstem: jeśli ta opcja jest włączona, rekomendacje dotyczące kontekstu użytkownika są uwzględniane w każdym zapytaniu wysyłanym do Ciebie przez Google. Rekomendacje odzwierciedlają najczęstsze typy użytkowników, którzy wyszukują daną kombinację obiektu lub planu podróży. Stosowanie się do tych rekomendacji może zwiększyć skuteczność Twoich odpowiedzi.
Metadane: jest to prośba o szczegółowe informacje o pokojach i pakietach w przypadku określonych obiektów.

Zapytania o rzeczywistą cenę

Zapytania o rzeczywiste ceny to żądania Google dotyczące aktualizacji cen w czasie rzeczywistym w odpowiedzi na wyszukiwania użytkowników. Google otrzymuje od użytkownika żądanie wyszukiwania obejmujące hotel lub plan podróży. Ponieważ dane o cenach są niedostępne lub nieaktualne, Google w momencie wyszukiwania przesyła do Ciebie żądanie aktualizacji ceny. W przypadku zapytań o rzeczywiste ceny Google próbuje uzyskać cenę i wyświetlić ją w wynikach w momencie wyszukiwania.

Wszystkie żądania zapytań o rzeczywistą cenę mają limit czasu odpowiedzi, który zwykle wynosi do 4000 milisekund. Ten limit jest określony w żądaniu zapytania o rzeczywistą cenę. Jeśli nie uda się udzielić odpowiedzi w wyznaczonym czasie, skutkuje to przegapioną szansą na udział w danej okazji. Zalecamy jednak podanie ceny, aby można było ją zapisać w pamięci podręcznej i wykorzystać w przyszłości. Połączenie w celu przesłania odpowiedzi pozostaje otwarte przez 10 minut lub zgodnie z konfiguracją partnera.

Zapytania o rzeczywiste ceny są też kontekstowe i mogą pobierać ceny dla tych parametrów: kraj użytkownika, typ urządzenia, liczba osób (liczba gości) oraz to, czy goście są dorośli czy dziećmi. Dzięki zapytaniom o rzeczywiste ceny możesz wyświetlać bardziej aktualne ceny, które odpowiadają temu, czego szukał klient.

Zapytania o rzeczywistą cenę mają być dodatkowym mechanizmem aktualizacji cen. Głównym mechanizmem zmiany cen jest nadal pobieranie lub zmiana cen. Zapytania o ceny rzeczywiste pomagają wypełnić luki, w których Google nie ma cen kombinacji hotelu i planu podróży.

Zasady korzystania z zapytań o rzeczywiste ceny

Brak danych w pamięci podręcznej dla danego planu podróży, ponieważ jest on nietypowy, np. daty są bardzo odległe lub hotel jest bardzo rzadko wyszukiwany.
Żądana data nie jest datą domyślną.

Uwaga: daty domyślne nie kwalifikują się do zapytań o ceny rzeczywiste. Zapytania o ceny w czasie rzeczywistym są wysyłane tylko w przypadku dat innych niż domyślne.

Google zwykle zapisuje w pamięci podręcznej wyniki rzeczywistych cen, aby nie wysyłać ponownie zapytań o ten sam hotel lub plan podróży. Może wysyłać żądania dotyczące zarówno kombinacji pojedynczego hotelu lub planu podróży, jak i kombinacji wielu hoteli lub pojedynczego planu podróży.

Funkcja Ceny rzeczywiste z kontekstem umożliwia Google wysyłanie konkretnych żądań cen rzeczywistych na podstawie typu urządzenia użytkownika, kraju, z którego wyszukuje on informacje, oraz liczby osób, w tym dzieci. Zarówno wiadomość z zapytaniem, jak i wiadomość transakcyjna są rozszerzane o element <Context>, który definiuje parametry zapytania. Ceny otrzymane z zapytań o rzeczywiste ceny z kontekstem mogą być przechowywane w pamięci podręcznej jako pakiet z pokojem, jeśli jest to cena dla określonej liczby osób, lub jako cena warunkowa, jeśli jest to cena dla kraju użytkownika lub urządzenia użytkownika.

Zapytania z kontekstem

Zapytania kontekstowe to zwykłe prośby o zaktualizowanie naszej bazy danych w przypadku określonych kombinacji usług lub tras. Zawierają one listę kontekstów użytkowników, które są popularne w przypadku tych kombinacji. Jeśli używane są stawki warunkowe, wysyłanie stawek dla wszystkich możliwych kontekstów użytkownika może być kosztowne, dlatego możesz użyć tej listy kontekstów użytkownika, aby ograniczyć odpowiedź. Zwracanie cen tylko w przypadku określonych kontekstów użytkownika obejmuje zdecydowaną większość odpowiednich zapytań użytkowników.

Jeśli chcesz otrzymywać zapytania z kontekstem, skontaktuj się z Technicznym menedżerem konta (TAM). Mogą potwierdzić, że jesteś gotowy(-a) na otrzymywanie takich wiadomości, a następnie dostosować konfigurację, aby zacząć wysyłać do Ciebie w zapytaniach konteksty użytkowników.

Wiadomości z zapytaniami o metadane

Wiadomości z zapytaniami o metadane zawierają szczegółowe informacje o pokojach i pakietach w przypadku określonych obiektów.

Gdy otrzymasz wiadomość z zapytaniem o metadane, musisz odpowiedzieć wiadomością <Transaction>, która określa ceny żądanych właściwości w elementach <Result>.

Więcej informacji znajdziesz w artykule Definiowanie metadanych pokoju i pakietu.

Przykłady wiadomości z zapytaniem

Ta sekcja zawiera kilka przykładów wiadomości z zapytaniem o ceny i wiadomości z zapytaniem o metadane. Dodatkowe przykłady znajdziesz w dokumentacji XML zapytania.

Przykładowy plan podróży

Poniższy przykład pokazuje <Query> z cenami, który wysyła żądanie aktualizacji cen dla 4 hoteli, dostępnych przez 3 noce, począwszy od 23 maja 2023 r.:

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

W tym przykładzie żądane są aktualizacje cen dla każdego hotelu:

5/23/18 - 6/26/18

Przykład zapytania o rzeczywistą cenę

Poniższy przykład pokazuje zapytanie o rzeczywistą cenę z limitem czasu odpowiedzi wynoszącym 500 milisekund:

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

W tym przykładzie żądana jest cena jednego hotelu:

6/23/23 - 6/25/23

Przykładową odpowiedź na to zapytanie znajdziesz w pliku XML dotyczącym cen i zasobów reklamowych pokoi (transakcje).

Przykłady zapytań z kontekstem

Przykłady zapytania „Z kontekstem”:

Podstawowe zapytanie z kontekstem

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, 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>

Zapytanie z kontekstem, w tym informacjami o zajętości

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2025-07-10</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <Context>
        <UserCountry>US</UserCountry>
      </Context>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="7"/>
        </Children>
      </OccupancyDetails>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Context>
        <UserCountry>GB</UserCountry>
      </Context>
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
    </PropertyContext>
  </PropertyContextList>
</Query>

W przypadku zapytań kontekstowych określa tylko kontekst kraju użytkownika. W przyszłości takie zapytania mogą też określać urządzenie użytkownika.

Zakresy dat zameldowania

Jeśli używasz zmiennych cen, struktura wiadomości z zapytaniem zależy od typu wskazówki, którego używasz w przypadku zakresów dat zameldowania, dokładnych planów podróży lub planów podróży w zakresie. Więcej informacji o każdym z tych typów podpowiedzi znajdziesz w artykule Wiadomości z odpowiedzią na podpowiedź.

Poniższy przykład pokazuje komunikat o cenach <Query> dla zakresów dat zameldowania:

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

W tym przykładzie wysyłamy prośbę o aktualizację cen w przypadku tych pobytów (dla każdego hotelu):

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

Pobyty w określonym przedziale cenowym

Poniższy przykład pokazuje komunikat o cenie <Query> w przypadku pobytów o zmiennym czasie trwania:

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