Tryby dostawy

Tryb dostarczania określa sposób wysyłania do Google aktualizacji cen w przypadku kombinacji hoteli i planów podróży. Podczas początkowej konfiguracji wspólnie z technicznym menedżerem konta skonfigurujesz tryb dostarczania.

Omówienie trybów wyświetlania

Domyślnie hotel może być wyszukiwany z domyślnym wyprzedzeniem do 330 dni przed dostępnością pokoju i z maksymalnie 30 noclegami, ale możesz określić maksymalną liczbę planów podróży (kombinację daty zameldowania i długości pobytu).

Im więcej planów podróży obsługujesz, tym w większej liczbie aukcji możesz uczestniczyć. Im więcej obsługiwanych przez Ciebie planów podróży, tym więcej danych musisz przesyłać do Google, aby zapewnić dokładność danych o cenach.

Typowe metody aktualizowania cen używają komunikatów Transakcja w jednym z tych sposobów:

• ARI (Push): plik danych o cenach, który wykorzystuje plany cenowe, dostępność i metadane hoteli do ustawiania wstępnie zdefiniowanych strategii cenowych dla Twoich obiektów. W odróżnieniu od pobierania cen z podpowiedziami i zmiany cen pliki danych ARI nie zawierają zapytań dotyczących konkretnych cen lub planów podróży. 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 cen, ograniczeń i dostępności. Pliki danych ARI używają specyfikacji XML OTA (OTA_HotelRateAmountNotifRQ i OTA_HotelAvailNotifRQ), aby określić dostępność i ceny. Aby dowiedzieć się więcej o trybie dostarczania ARI i sprawdzić, czy ten typ pliku jest najlepszy dla Twojego konta, skontaktuj się z menedżerem konta. Więcej informacji znajdziesz w artykule Korzystanie z interfejsu ARI.

• Pobieranie: Google regularnie wysyła zapytania do Twojej usługi, aby odświeżyć pamięć podręczną z danymi o cenach i dostępności. W tym modelu Google wysyła żądanie do Twojego serwera, a serwer odpowiada z aktualnymi 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 określą, że stały się nieaktualne na podstawie historii zmian cen dla danego partnera. Więcej informacji znajdziesz w artykule Korzystanie z trybu dostawy „pull”.

• Zmiana cen (wcześniej znane jako pobieranie z podpowiedziami): podobnie jak w przypadku pobierania, 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 Twoich obiektów. Ceny pozostają w pamięci podręcznej bezterminowo, dopóki nie zostaną zaktualizowane. Więcej informacji znajdziesz w artykule Używanie zmienionych cen.

Oprócz aktualizowania cen możesz też używać wiadomości o transakcjach, aby usuwać obiekty ze swojego zasobu. 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 transakcji, znajdziesz w artykule Aktualizowanie cen.

Zapytania o rzeczywistą cenę

Google może też poprosić o aktualizację niektórych cen w czasie aukcji za pomocą zapytań o ceny w czasie rzeczywistym. Zapytania o rzeczywistą cenę to prośby o cenę od Google dotyczące bieżącej aukcji. Jeśli odpowiesz w określonym czasie, Twoja reklama powinna się pojawić w aukcji.

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

Więcej informacji znajdziesz w artykule Pytania dotyczące cen na żywo.

Kontekst

Zapytania dotyczące pobierania i zmian cen zwykle nie zawierają informacji o użytkowniku, ponieważ Google używa Twoich odpowiedzi do wypełniania pamięci podręcznej, która może być używana do wyświetlania informacji 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 w ramach zapytania można określić popularne konteksty użytkownika. Konteksty użytkownika są oparte na żądaniach użytkownika, w których masz możliwość wyświetlenia ceny, i są obliczane w taki sposób, aby obejmować zdecydowaną większość żądań użytkownika. Możesz zobaczyć dużą liczbę kontekstów użytkowników w przypadku bardzo popularnych obiektów lub planów podróży, ale średnia liczba kontekstów użytkownika powinna być mniejsza niż 10. Możesz zwracać dodatkowe ceny lub zignorować określone konteksty użytkownika – to od Ciebie zależy, jakie ceny zwracać w przypadku danego zapytania. Ignorowanie sugerowanego kontekstu użytkownika może jednak spowodować spadek liczby wizyt.

Tryb przesyłania ARI (push)

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

Na poniższym diagramie pokazano przepływ żądań i odpowiedzi w przypadku trybu przesyłania ARI Push:

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

Aby zaktualizować dane za pomocą ARI Push, wyślij wiadomość z żądaniem ARI za każdym razem, gdy dane ulegną zmianie. Tryb dostarczania ARI Push obsługuje różne typy wiadomości i strategie cenowe. Szczegółowe informacje o przesyłaniu wiadomości znajdziesz w artykule Korzystanie z interfejsu 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 przez Google

W przypadku każdej otrzymanej wiadomości ARI Push Google odpowiada stanem połączenia HTTP i wynikami przetwarzania ARI. Jeśli połączenie z serwerem zostało nawiązane, Google odpowie obiektem HTTP 200 OK. Zawiera on też treść z komunikatem z odpowiedzią, który wskazuje, czy aktualizacje zostały zastosowane, czy wystąpiły ostrzeżenia lub błędy dotyczące trybu dostawy.

Dozwolone adresy IP

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

Aktualizowanie metadanych pokoju i pakietu za pomocą ARI Push

Użyj typu wiadomości Transakcja (dane obiektu), aby zdefiniować aktywne typy pokoi i plany cenowe (pakiety) dla każdego obiektu. Aktualizacje należy przesyłać zawsze, gdy dodajesz, usuwasz lub modyfikujesz 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 źle sformatowanego pliku XML, znajdziesz zalecane rozwiązanie w sekcji Messages (Wiadomości) w sekcji Feed Status Error (Błąd stanu pliku danych).

Jeśli podczas wysyłania wiadomości ARI do Google pojawi się błąd połączenia HTTP, spróbuj ponownie wysłać żądanie 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 „pociągaj” Google okresowo wysyła wiadomości zapytania do Twojego serwera, aby poprosić o aktualizację cen. Twój serwer odpowiada na te wiadomości wiadomościami dotyczącymi transakcji zawierającymi zaktualizowane dane o cenie i dostępności.

Poniższy diagram przedstawia przepływ żądania/odpowiedzi w przypadku metody pull:

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

W sekcjach poniżej znajdziesz więcej informacji o każdym z tych kroków.

Krok 1. Zapytanie

Domyślnie Google wysyła wiadomości z zapytaniami dotyczącymi wszystkich obiektów zdefiniowanych na liście hoteli. Może to oznaczać, że podczas procesu zmiany cen otrzymujesz wiele zapytań.

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 początkowej konfiguracji. Aby uzyskać więcej informacji, skontaktuj się z menedżerem technicznym konta.
• Używa metody HTTP POST. (jeśli używasz protokołu HTTPS, musisz uzyskać domenę podpisaną przez oficjalny urząd certyfikacji).
• Nagłówek Content-Type ma wartość application/xml.
• Każda wiadomość zawiera maksymalnie 100 usług, dla których Google prosi o dane dotyczące cen i dostępności.
• Nagłówek User-Agent ma wartość Google-HotelAdsPrices.

Krok 2. Wiadomość dotycząca transakcji

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 artykułach 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 o transakcjach do aktualizowania metadanych pokoi i pakietów. Więcej informacji znajdziesz w artykule Definiowanie metadanych sal i pakietów.

Zmieniono tryb dostawy cen

Zmiana cen pomaga zmniejszyć rozmiar i liczbę wiadomości z zapytaniami oraz transakcji dotyczących aktualizacji cen. Gdy używasz funkcji Zmienione ceny, wysyłasz do Google listę obiektów, w których zmieniły się ceny. Google odpowiada wiadomością z zapytaniem, która zawiera tylko ceny tych usług.

Aby skonfigurować punkt końcowy, do którego Google wysyła wiadomości z prośbami o wskazówki, skontaktuj się z menedżerem konta ds. technicznych (TAM). Należy to skonfigurować podczas pierwszej konfiguracji.

Na diagramie poniżej przedstawiono przepływ żądań i odpowiedzi w przypadku zmiany cen:

W sekcjach poniżej opisano poszczególne kroki tego procesu.

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

Wiadomości z prośbą o wskazanie, 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 pierwszej konfiguracji. Aby uzyskać więcej informacji, skontaktuj się z menedżerem technicznym konta (TAM).
• Użyj metody HTTP POST. (jeśli używasz protokołu HTTPS, musisz uzyskać domenę podpisaną przez oficjalny urząd certyfikacji).
• Nagłówek Content-Type ma wartość application/xml.
• W określonych odstępach czasu Google wysyła na Twój serwer sygnaturę czasową, która określa ostatni czas odpowiedzi 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ść wysyłania wiadomości z prośbą o wskazówki, skontaktuj się z nami.

Gdy otrzymasz od Google wiadomość z prośbą o podpowiedź, odpowiedz, podając wszystkie ceny, które zostały zaktualizowane od tego momentu. Więcej informacji znajdziesz w artykule [GA4] Wiadomości z prośbą o wskazanie.

Krok 2. Wiadomość z odpowiednią podpowiedzią

Serwer odpowiada na wiadomość z prośbą o wskazanie odpowiedzi wiadomością z odpowiedzią. Wiadomość zawiera identyfikatory hoteli i plany podróży dotyczące obiektów, których ceny uległy zmianie od czasu, gdy po raz ostatni otrzymano i odpowiedziano na wiadomość z prośbą o wskazówkę.

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

Krok 3. Zapytanie

Google otrzymuje odpowiedź na podpowiedź i odpowiada wiadomością z zapytaniem, tak jak w standardowym trybie Pull. Różnica polega na tym, że wiadomość z zapytaniem zawiera teraz tylko identyfikatory hoteli i plany podróży dla obiektów określonych w wiadomości z odpowiedzią na podpowiedź. Elementem głównym wiadomości z zapytaniem jest element <Query>.

Podczas określania, których identyfikatorów hoteli ma poprosić o ceny z opcją „Zmienione ceny”, Google ignoruje zawartość pliku danych z listą hoteli. Dzięki temu znacznie zmniejszysz rozmiar wiadomości zapytania, którą otrzymujesz od Google, oraz rozmiar wiadomości transakcyjnej w odpowiedzi.

Krok 4. Wiadomość dotycząca transakcji

W odpowiedzi na wiadomości z zapytaniem Google wysyłasz wiadomość transakcyjną z aktualizacją cen. Elementem głównym wiadomości transakcyjnej jest <Transaction>. Więcej informacji znajdziesz w artykule o trybie przesyłania pobierania.