Zapytania dotyczące zapytań

Wiadomości z zapytaniami to prośby Google o aktualizacje cen lub metadanych. Są one używane w przypadku obu trybów dostarczania: pobierania z podpowiedziami i zmiany 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 aktualizację cen w wybranych hotelach.

  • Metadane: Google wysyła wiadomość z zapytaniem o dane o pokoju i informacje o pakietach w wybranych hotelach.

Podczas początkowej konfiguracji określasz punkt końcowy, którego Google używa do obsługi zapytań i zapytań o ceny na żywo. Aby uzyskać więcej informacji, skontaktuj się z menedżerem technicznym konta (TAM).

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ątkiem od tej reguły jest ręczne testowanie integracji punktu końcowego cen za pomocą Google-TravelAds-Live. Te przykładowe zapytania mogą zawierać nagłówek User-Agent lub nie.

Szczegółowe informacje o formatowaniu wiadomości z zapytaniami znajdziesz w dokumentacji dotyczącej pliku zapytania XML.

wiadomości z zapytaniami dotyczącymi cen,

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

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

Więcej informacji znajdziesz w artykule Omówienie cen.

Istnieją 3 specjalne typy wiadomości zapytania:

  1. Ceny w czasie rzeczywistym: 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 czas na odpowiedź.

  2. Z kontekstem: jeśli ta opcja jest włączona, w każdym zapytaniu, które Google wysyła do Ciebie, uwzględniane są rekomendacje kontekstu użytkownika. Rekomendacje te odzwierciedlają najczęstsze typy użytkowników, którzy szukają danej usługi lub kombinacji planów podróży. Postępowanie zgodnie z tymi zaleceniami może zwiększyć skuteczność Twoich odpowiedzi.

  3. Metadane: to prośba o szczegóły dotyczące pokoi i pakietów w określonych obiektach.

Zapytania o rzeczywistą cenę

Zapytania o ceny na żywo 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 prosi o aktualizację cen w momencie wyszukiwania. W przypadku zapytań o ceny na żywo Google próbuje uzyskać cenę i wyświetlić ją w wynikach w momencie wyszukiwania.

Wszystkie żądania dotyczące rzeczywistej ceny mają limit czasu odpowiedzi, który wynosi zwykle do 4000 ms. Ten limit jest określony w żądaniu dotyczącej zapytania o ceny na żywo. Jeśli nie uda się przesłać odpowiedzi w określonym czasie, oznacza to utratę możliwości udziału w danej akcji. Zalecamy jednak podanie ceny, aby można było ją zapisać w pamięci podręcznej i wykorzystać w przyszłości. Połączenie służące do wysłania odpowiedzi pozostaje otwarte przez 10 minut lub przez czas określony w konfiguracji partnera.

Zapytania o ceny na żywo są również kontekstowe i mogą zwracać ceny dla tych parametrów: kraj użytkownika, typ urządzenia, liczba osób (liczba gości) oraz czy są to dorośli czy dzieci. Dzięki zapytaniom o rzeczywistą cenę możesz wyświetlać bardziej aktualne ceny, które pasują do tego, czego szuka klient.

Zapytania o rzeczywistą cenę mają być dodatkowym mechanizmem aktualizacji cen. Głównym mechanizmem ponownego ustalania cen jest nadal metoda „Pull” lub „Changed pricing”. Zapytania o rzeczywistą cenę pomagają wypełnić luki, w których Google nie ma cen hoteli lub kombinacji planów podróży.

Zasady korzystania z zapytań o ceny na żywo

  • Dane w pamięci podręcznej dla danego planu podróży nie istnieją, ponieważ ten plan jest nietypowy, na przykład ze względu na odległą datę lub rzadko wyszukiwany hotel.

  • Wybrana data jest inna niż domyślna.

: Uwaga: do zapytań o rzeczywiste ceny nie można używać domyślnych dat. Żądania rzeczywistej ceny są przesyłane tylko w przypadku dat innych niż domyślne.

Google zazwyczaj przechowuje w pamięci podręcznej wyniki wyszukiwania cen w czasie rzeczywistym, aby nie wysyłać ponownie zapytania o ten sam hotel lub ten sam plan podróży. Może ono obejmować zarówno pojedyncze hotele, jak i kombinacje hoteli oraz pojedyncze lub wielokrotne plany podróży.

Funkcja Cennik na żywo z kontekstem umożliwia Google wysyłanie konkretnych zapytań o ceny na żywo na podstawie typu urządzenia użytkownika, kraju, w którym prowadzi wyszukiwanie, oraz liczby osób, w tym dzieci. Zarówno wiadomość z zapytaniem, jak i wiadomość Transaction są rozwijane, aby uwzględnić element <Context>, który definiuje parametry zapytania. Ceny otrzymane z zapytań o ceny na żywo z kontekstem mogą zostać zapisane w pamięci podręcznej jako pakiet z pokojem, jeśli jest to cena za określoną liczbę osób, lub jako cena warunkowa, jeśli jest to cena dla kraju lub urządzenia użytkownika.

Zapytania z kontekstem

Zapytania kontekstowe to zwykłe prośby o zaktualizowanie naszej bazy danych w przypadku określonej usługi lub kombinacji planów podróży. Zawierają one listę kontekstów użytkownika, które są popularne w przypadku tych kombinacji. Jeśli używasz stawek warunkowych, wysyłanie stawek dla wszystkich możliwych kontekstów użytkownika może być kosztowne. Możesz więc 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ę ze swoim opiekunem klienta ds. technicznych (TAM). Mogą potwierdzić, że jesteś gotowy/gotowa do otrzymywania takich wiadomości, a potem dokonać zmiany konfiguracji, aby zacząć wysyłać do Ciebie konteksty użytkowników w zapytaniach.

Wiadomości z zapytaniami o metadane

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

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

Więcej informacji znajdziesz w artykule Definiowanie metadanych sal i pakietów.

Zarządzanie zapytaniami

W tej sekcji dowiesz się, jak kontrolować, które obiekty i plany podróży mogą być tematem wiadomości z zapytaniami od Google.

Granice planu podróży

Możliwe granice zapytań dotyczących cen określasz za pomocą <ItineraryCapabilities>. Określasz reguły, które określają zakres dat i maksymalny czas pobytu.

Możesz ustawić domyślne wartości dla <MaxAdvancePurchase> i <MaxLengthOfStay>, które będą obowiązywać we wszystkich kombinacjach hoteli lub planów podróży. Możesz też zdefiniować te ustawienia dla grup hoteli.

Przykłady wiadomości z zapytaniem

Ta sekcja zawiera kilka przykładów wiadomości z zapytaniami o ceny i wiadomości z zapytaniami o metadane. Dodatkowe przykłady znajdziesz w pliku referencyjnym zapytań XML.

Przykładowy plan podróży

Ten przykład pokazuje cenę <Query>, która prosi o aktualizację cen dla 4 hoteli na 3 noce 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 żądamy aktualizacji cen w każdym 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 ms:

<?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 podano cenę za jeden hotel:

6/23/23 - 6/25/23

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

Przykład zapytania z kontekstem

Poniżej przykład zapytania 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, 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>

Zapytania kontekstowe określają tylko kontekst kraju użytkownika. W przyszłości takie zapytania mogą też określać urządzenie użytkownika i liczbę osób.

Zakresy dat zameldowania

Jeśli korzystasz z funkcji Zmienione ceny, struktura wiadomości z zapytaniem zależy od typu podpowiedzi, który używasz do zakresów dat zameldowania, dokładnych planów podróży lub planów podróży z zakresem. Więcej informacji o każdym z tych typów znajdziesz w artykule Wiadomości z odpowiądzią na podpowiedź.

Ten przykład pokazuje komunikat <Query> dotyczący cen w przypadku 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 żądamy aktualizacji cen dla 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

Zakwaterowanie w ramach pobytu w różnych miejscach

Ten przykład pokazuje wiadomość <Query> dotyczącą cen za pobyty o zróżnicowanej długości:

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

W tym przykładzie żądamy aktualizacji cen w każdym 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/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

Plusowe pobyty, które rozpoczęły się przed (ale obejmują) daną noc:

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

wiadomość z zapytaniem o metadane,

Ten przykład pokazuje wiadomość <Query>, która prosi o aktualizację metadanych informacji o pokoju i pakiecie dla kilku obiektów:

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

Na tego typu wiadomość zapytania odpowiadasz wiadomością transakcyjną, która definiuje metadane pokoju i pakietu. Więcej informacji znajdziesz w artykule Definiowanie metadanych sal i pakietów.