Tryby dostawy

Tryb dostarczania określa sposób wysyłania do Google aktualizacji cen w przypadku kombinacji hotelu i planu podróży. Podczas wstępnej konfiguracji wspólnie z technicznym menedżerem konta ustawisz tryb dostarczania.

Omówienie trybów wyświetlania

Domyślnie można wysyłać zapytania o dostępność pokoi w hotelu z wyprzedzeniem do 330 dni i na maksymalnie 30 nocy, ale możesz określić maksymalną liczbę planów podróży (kombinacji daty zameldowania i długości pobytu).

Im więcej obsługujesz planów podróży, tym więcej aukcji możesz brać udział. Im więcej obsługujesz planów podróży, tym więcej danych musisz wysyłać do Google, aby zachować dokładność danych o cenach.

Typowe metody aktualizacji cen wykorzystują wiadomości Transaction w jeden z tych sposobów:

• ARI (Push): plik danych do przesyłania cen, który wykorzystuje plany cenowe, dostępność i metadane hotelu do ustawiania wstępnie zdefiniowanych strategii cenowych dla Twoich obiektów. W przeciwieństwie do pobierania cen z podpowiedziami i zmiany cen pliki danych ARI nie wysyłają zapytań o konkretne ceny ani trasy. Zamiast tego wysyłasz wiadomości zawierające podzbiór informacji, które reprezentują model cenowy Twoich obiektów na podstawie różnych szczegółów dotyczących stawek, ograniczeń i dostępności. Pliki danych ARI korzystają ze specyfikacji OTA XML (OTA_HotelRateAmountNotifRQ i OTA_HotelAvailNotifRQ) do określania dostępności i cen. Aby dowiedzieć się więcej o trybie dostarczania ARI i określić, czy ten typ pliku danych będzie najlepiej pasować do Twojego konta, skontaktuj się z menedżerem konta. Więcej informacji znajdziesz w artykule Korzystanie z ARI.

• Pobieranie: Google regularnie wysyła zapytania do Twojej usługi, aby odświeżać pamięć podręczną danych o cenach i dostępności. W tym modelu Google wysyła żądanie do Twojego serwera, a serwer odpowiada zaktualizowanymi danymi. Ten model jest najlepszy, jeśli nie wiesz dokładnie, kiedy zmieniają się informacje o cenach, lub jeśli zmieniają się one nieregularnie w ciągu dnia. Ceny pozostają w pamięci podręcznej, dopóki algorytmy Google nie stwierdzą, że są już nieaktualne. Odbywa się to na podstawie historii poprzednich zmian cen u danego partnera. Więcej informacji znajdziesz w artykule Korzystanie z trybu dostarczania typu pull.

• Zmiana cen (wcześniej znane jako pobieranie z podpowiedziami): podobnie jak pobieranie, z tą różnicą, że Google prosi o dane tylko w przypadku podzbioru obiektów, a nie wszystkich. Ten tryb może znacznie zmniejszyć ilość ruchu w sieci podczas aktualizowania cen i dostępności obiektów. Ceny pozostają w pamięci podręcznej bezterminowo, dopóki nie zostaną zaktualizowane. Więcej informacji znajdziesz w artykule Korzystanie ze zmienionych cen.

Oprócz aktualizowania cen możesz używać wiadomości o transakcjach do usuwania obiektów z zasobów reklamowych. Więcej informacji znajdziesz w artykule Usuwanie zasobów reklamowych.

Więcej informacji o przesyłaniu aktualizacji cen, w tym przykłady wiadomości o transakcjach, znajdziesz w artykule Aktualizowanie cen.

Zapytania o ceny w czasie rzeczywistym

Google może też w czasie aukcji wysyłać zapytania dotyczące cen w czasie rzeczywistym. Zapytania o ceny rzeczywiste to żądania cen od Google dotyczące bieżącej aukcji. Jeśli odpowiesz w określonym czasie, Twoja reklama powinna pojawić się na aukcji.

Google przechowuje odpowiedź na zapytanie o ceny w czasie rzeczywistym tak samo jak w przypadku innych wiadomości transakcyjnych. Dzięki temu Google może wyświetlać cenę z pamięci podręcznej, zamiast wysyłać w przyszłości kolejne zapytanie o rzeczywistą cenę.

Więcej informacji znajdziesz w artykule Zapytania o ceny na żywo.

Ważne: ze względu na nowy interfejs wyszukiwania funkcja Live Query jest dostępna w ograniczonym zakresie dla użytkowników z Europejskiego Obszaru Gospodarczego.

Kontekst

Zapytania Pull i Changed Pricing zwykle nie zawierają informacji o użytkowniku, ponieważ Google wykorzystuje Twoje odpowiedzi do wypełnienia pamięci podręcznej, która może być używana do wyświetlania wyników różnym użytkownikom.

Zwracanie cen odpowiadających pełnemu zestawowi możliwych kontekstów użytkownika może być kosztowne, dlatego testujemy funkcję, w której popularne konteksty użytkownika są określane w ramach zapytania. Konteksty użytkowników są oparte na żądaniach użytkowników, w których miałeś okazję wyświetlić cenę, i są obliczane tak, aby obejmować zdecydowaną większość żądań użytkowników. W przypadku bardzo popularnych obiektów lub planów podróży możesz zobaczyć dużą liczbę kontekstów użytkownika, ale średnia liczba kontekstów użytkownika powinna być mniejsza niż 10. Możesz zwracać dodatkowe ceny lub ignorować określone konteksty użytkownika. To Ty decydujesz, jakie ceny mają być zwracane w przypadku danego zapytania. Ignorowanie sugerowanego kontekstu użytkownika może jednak spowodować spadek ruchu.

Najważniejsza uwaga: kraj użytkownika to jedyny obsługiwany kontekst w przypadku pobierania lub zmieniania cen. Szczegóły dotyczące obłożenia i konteksty typu urządzenia należy przesyłać za pomocą zapytania o ceny na żywo z kontekstem. Zapoznaj się z przykładami w sekcji Zapytania z kontekstem.

Wskazówka: jeśli chcesz otrzymywać w zapytaniach wysyłanych przez Google popularne konteksty użytkowników, skontaktuj się z Techniczną obsługą klienta. Potwierdzą, że możesz otrzymywać takie wiadomości, a potem dostosują konfigurację, aby zacząć wysyłać do Ciebie konteksty użytkowników w zapytaniach.

Tryb wyświetlania ARI Push

W trybie dostarczania ARI Push wysyłasz do Google przyrostowe aktualizacje, gdy zmieniają się ceny za noc, dostępność, liczba pokoi lub inne ograniczenia. W przeciwieństwie do pobierania lub zmiany cen ARI Push umożliwia korzystanie z innego modelu cenowego, aby skutecznie aktualizować różne komponenty informacji o cenach w Google.

Poniższy diagram przedstawia przepływ żądania i odpowiedzi w przypadku trybu dostarczania ARI Push:

Krok 1. Wysyłanie do Google wiadomości ARI Push

Aby zaktualizować dane za pomocą ARI Push, wysyłaj wiadomość z żądaniem ARI za każdym razem, gdy zmienią się Twoje dane. Tryb dostarczania ARI Push obsługuje różne typy wiadomości i strategie cenowe. Szczegółowe informacje o wypychaniu wiadomości znajdziesz w artykule Korzystanie z ARI.

Ceny powinny być wyświetlane przez Google i widoczne dla użytkowników w ciągu 15–20 minut od otrzymania wiadomości.

Krok 2. Sprawdź, czy dane zostały zapisane w pamięci podręcznej Google

W odpowiedzi na każdą otrzymaną wiadomość ARI Push Google wysyła stan połączenia HTTP i wyniki przetwarzania ARI. Jeśli połączenie z serwerem się powiedzie, Google odpowie elementem HTTP 200 OK. Zawiera też treść z odpowiedzią wskazującą, czy aktualizacje zostały zastosowane, czy też wystąpiły ostrzeżenia lub błędy związane z trybem dostarczania.

Dodawanie adresów IP do listy dozwolonych

Aby dodać do listy dozwolonych adresy IP, których używasz do przesyłania wiadomości ARI do Google, skorzystaj ze strony ustawień cen ARI w Hotel Center. Dowiedz się, jak zmienić ustawienia cen w usłudze Hotel Center.

Aktualizowanie metadanych pokoju i pakietu za pomocą ARI Push

Użyj typu wiadomości Transaction (Property Data), aby zdefiniować aktywne typy pokoi i plany cenowe (pakiety) dla każdego obiektu. Aktualizacje należy przesyłać za każdym razem, gdy dodawane, usuwane lub modyfikowane są typy pokoi lub plany cenowe. W takim przypadku wysyłasz wiadomość XML z nowymi informacjami w elementach <RoomData> i <PackageData>. Te elementy są podrzędne wobec elementu <PropertyDataSet>.

Błędy połączenia lub treści

Jeśli otrzymasz błąd trybu dostawy z powodu nieprawidłowego lub uszkodzonego pliku XML, znajdź zalecane rozwiązanie w sekcji Komunikaty o błędach stanu pliku danych.

Jeśli podczas wysyłania wiadomości ARI do Google pojawi się błąd połączenia HTTP, ponów próbę wysłania żądania w odstępach 1, 5 i 20 minut. Jeśli problem będzie się powtarzał po 3 próbach, przestań wysyłać wiadomości i skontaktuj się z zespołem pomocy Google.

Tryb dostarczania pull

W trybie dostarczania Pull Google okresowo wysyła na Twój serwer wiadomości z zapytaniem, aby poprosić o aktualizacje cen. Serwer odpowiada na te wiadomości wiadomościami o transakcjach, które zawierają zaktualizowane dane o cenach i dostępności.

Poniższy diagram przedstawia przepływ żądania/odpowiedzi w przypadku operacji Pull:

Po otrzymaniu aktualizacji cen Google zwykle przetwarza nowe dane o cenach i dostępności w ciągu około 5 minut.

W sekcjach poniżej znajdziesz szczegółowe informacje o każdym z tych kroków.

Krok 1. Zapytanie

Domyślnie Google wysyła wiadomości z zapytaniem dotyczące wszystkich obiektów zdefiniowanych na liście hoteli. Może to oznaczać, że podczas procesu zmiany cen powinnaś otrzymywać wiele wiadomości Query.

Wiadomości z zapytaniami o ceny, które Google wysyła na Twój serwer, mają te cechy:

• Elementem głównym jest <Query>.
• Wysyłane do punktu końcowego zdefiniowanego podczas konfiguracji początkowej. Aby uzyskać więcej informacji, skontaktuj się z Technicznym menedżerem konta.
• Używa metody HTTP POST. (Jeśli używasz protokołu HTTPS, musisz uzyskać podpis domeny od oficjalnego urzędu certyfikacji).
• Nagłówek Content-Type ma wartość application/xml.
• Każda wiadomość zawiera maksymalnie 100 miejsc zakwaterowania, dla których Google prosi o dane dotyczące cen i dostępności.
• Nagłówek User-Agent ma wartość Google-HotelAdsPrices.

Ważna uwaga: może być wiele wiadomości z zapytaniem, aby zaktualizować wszystkie ceny wszystkich hoteli, a wynikowe wiadomości z transakcją mogą być bardzo duże. Aby zmniejszyć rozmiar i liczbę wiadomości, zalecamy używanie zmienionych cen.

Krok 2. Wiadomość transakcyjna

Gdy serwer otrzyma wiadomość Query, musi odpowiedzieć wiadomością Transaction zawierającą informacje o cenach dla żądanych planów podróży.

Elementem głównym wiadomości transakcyjnej jest <Transaction>. Więcej informacji znajdziesz w sekcjach Wiadomości o transakcjach i Aktualizowanie cen.

Aktualizowanie metadanych pokoju i pakietu

Oprócz aktualizowania danych o cenach za pomocą funkcji Pull możesz też używać wiadomości Transaction do aktualizowania metadanych pokoi i pakietów. Więcej informacji znajdziesz w artykule Definiowanie metadanych pokoju i pakietu.

Zmieniony tryb dostawy cen

Zmiana cen pomaga zmniejszyć rozmiar i liczbę zapytań oraz wiadomości o transakcjach dotyczących aktualizacji cen. Gdy korzystasz z funkcji zmienionych cen, wysyłasz do Google listę obiektów, w przypadku których ceny zostały zaktualizowane. Google odpowiada wiadomością Query, która zawiera tylko ceny tych właściwości.

Aby skonfigurować punkt końcowy, do którego Google wysyła wiadomości z prośbą o wskazówkę, skontaktuj się z Technicznym menedżerem konta. Ta opcja została skonfigurowana podczas konfiguracji początkowej.

Ważna informacja: jeśli nie wdrożysz wiadomości z odpowiedzią na wskazówkę, wiadomości z zapytaniem Google będą wysyłać prośby o dane dotyczące all właściwości zidentyfikowanych na liście hoteli.

Poniższy diagram przedstawia przepływ żądań i odpowiedzi w przypadku zmiany cen:

W sekcjach poniżej znajdziesz opis poszczególnych kroków tego procesu.

Krok 1. Wiadomość z prośbą o podpowiedź

Wiadomości z prośbą o wskazówkę, które Google wysyła na Twój serwer, mają te cechy:

• Element główny to <HintRequest>.
• Wysyłane do punktu końcowego zdefiniowanego podczas konfiguracji początkowej. Aby uzyskać więcej informacji, skontaktuj się z menedżerem technicznym konta.
• Użyj metody HTTP POST. (Jeśli używasz protokołu HTTPS, musisz uzyskać podpis domeny od oficjalnego urzędu certyfikacji).
• Nagłówek Content-Type ma wartość application/xml.
• Z określoną częstotliwością Google wysyła na Twój serwer sygnaturę czasową, która określa, kiedy ostatni raz odpowiedziałeś na wiadomość z prośbą o wskazówkę.
• Nagłówek User-Agent ma wartość Google-HotelAdsPrices.

Zalecamy ustawienie częstotliwości na 5 minut. Aby ustawić lub zmienić częstotliwość wyświetlania próśb o wskazówki, skontaktuj się z nami.

Gdy otrzymasz od Google wiadomość z prośbą o wskazówki, odpowiadasz, podając wszystkie ceny, które zostały zaktualizowane od tego znacznika czasu. Więcej informacji znajdziesz w sekcji Wiadomości z prośbą o wskazówkę.

Krok 2. Wiadomość z odpowiedzią

Serwer odpowiada na wiadomość z żądaniem podpowiedzi wiadomością z odpowiedzią. Ta wiadomość zawiera identyfikatory hoteli i plany podróży dotyczące obiektów, których ceny uległy zmianie od czasu, gdy ostatni raz otrzymaliśmy i odpowiedzieliśmy na wiadomość z prośbą o wskazówkę.

Elementem głównym wiadomości z odpowiedzią jest <Hint>. Więcej informacji znajdziesz w sekcji Wiadomości z odpowiedzią na podpowiedź.

Krok 3. Zapytanie o wiadomość

Google odbiera wiadomość Hint Response i odpowiada wiadomością Query, tak jak w standardowym trybie Pull. Różnica polega na tym, że wiadomość Query zawiera teraz tylko identyfikatory hoteli i plany podróży dla usług, które zostały określone w wiadomości Hint Response. Elementem głównym wiadomości zapytania jest <Query>.

Określając, dla których identyfikatorów hoteli wysyłać żądania cen w przypadku funkcji Zmienione ceny, Google ignoruje zawartość pliku danych z listą hoteli. Znacznie zmniejsza to rozmiar wiadomości zapytania otrzymywanej od Google oraz rozmiar wiadomości transakcji w odpowiedzi.

Krok 4. Wiadomość transakcyjna

Wysyłasz wiadomość o transakcji z aktualizacją cen w odpowiedzi na wiadomości z zapytaniem od Google. Elementem głównym wiadomości transakcyjnej jest <Transaction>. Więcej informacji znajdziesz w artykule Tryb dostarczania typu pull.