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:
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ź.
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.
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.