Tryby dostawy

Tryb dostawy określa sposób, w jaki przesyłasz do Google aktualizacje cen dla kombinacji hoteli i planów podróży. Podczas wstępnej konfiguracji tryb dostarczania musisz współpracować z technicznym menedżerem konta (TAM).

Omówienie trybów wyświetlania

Domyślnie można wysyłać zapytania do hotelu na maksymalnie 330 dni przed dostępnością pokoi i do 30 nocy pobytu. Możesz jednak określić maksymalną liczbę planów podróży (czyli kombinację daty zameldowania i długości pobytu).

Im więcej wspieranych planów podróży, tym więcej aukcji weźmie udział. Jednak im więcej obsługiwanych planów podróży, tym więcej danych musisz wysyłać do Google, aby informacje o cenach były dokładne.

Typowe metody aktualizowania cen korzystają z komunikatów Transakcja na jeden z tych sposobów:

• ARI (Push): plik danych z cenami dostawy, który wykorzystuje metadane abonamentów, dostępności i metadanych hoteli do ustawiania zdefiniowanych wstępnie strategii cenowych dla Twoich usług. W przeciwieństwie do pobierania cen lub zmian cen pliki danych ARI nie wysyłają zapytań o konkretne ceny ani plany podróży. Zamiast tego wysyłasz wiadomości zawierające podzbiór informacji, które reprezentują model cenowy Twoich usług na podstawie różnych szczegółów dotyczących stawki, ograniczeń i dostępności. Pliki danych ARI używają specyfikacji XML OTA (OTA_HotelRateAmountNotifRQ i OTA_HotelAvailNotifRQ) do określania dostępności i cen. Aby dowiedzieć się więcej o trybie przesyłania ARI i ustalić, czy ten typ pliku danych będzie najlepszy dla Twojego konta, skontaktuj się z menedżerem konta. Więcej informacji znajdziesz w artykule o korzystaniu z ARI.

• Pobieranie: Google regularnie wysyła zapytania do usługi, aby odświeżać jej pamięć podręczną danych o cenach i dostępności. W tym modelu Google wysyła żądanie do serwera, który w odpowiedzi przekazuje zaktualizowane dane. Ten model jest najlepszy, jeśli nie wiesz dokładnie, kiedy zmieniają się informacje o cenach lub jeśli informacje o cenach zmieniają się nieregularnie w ciągu dnia. Ceny pozostają w pamięci podręcznej, dopóki na podstawie historii zmian cen u danego partnera algorytmy Google nie wykryją, że ceny stały się nieaktualne. Więcej informacji znajdziesz w artykule o używaniu trybu pull Delivery (w języku angielskim).

• Zmiana cen (wcześniej pull z podpowiedziami): funkcja podobna do Pull, z tym że Google żąda danych tylko dla podzbioru usług, a nie wszystkich usług. Ten tryb może znacznie zmniejszyć ilość ruchu sieciowego podczas aktualizowania cen i dostępności w przypadku Twoich miejsc zakwaterowania. Ceny pozostają w pamięci podręcznej bezterminowo, dopóki nie zostaną zaktualizowane. Więcej informacji znajdziesz w sekcji Korzystanie ze zmienionych cen.

Za pomocą wiadomości dotyczących transakcji możesz nie tylko aktualizować ceny, ale też usuwać usługi ze swoich zasobów reklamowych. Więcej informacji znajdziesz w artykule Usuwanie zasobów reklamowych.

Więcej informacji o przekazywaniu aktualizacji cen, w tym przykłady komunikatów dotyczących transakcji, znajdziesz w sekcji Aktualizowanie cen.

Zapytania o ceny transmisji na żywo

Google może też poprosić o aktualizację cen w czasie aukcji za pomocą zapytań w czasie rzeczywistym. Bieżące zapytania o ceny to zapytania o ceny od Google dotyczące bieżącej aukcji. Jeśli zareagujesz w wyznaczonym terminie, Twoja reklama powinna wziąć udział w aukcji.

Google przechowuje odpowiedź na zapytanie o cenę w czasie rzeczywistym tak samo jak w przypadku każdej innej wiadomości dotyczącej transakcji. W rezultacie Google może wyświetlić cenę ze swojej pamięci podręcznej, zamiast wysyłać w przyszłości kolejne zapytanie o cenę w czasie rzeczywistym.

Więcej informacji znajdziesz w zapytaniach o cenę w czasie rzeczywistym.

Kontekst

Zapytania dotyczące pobierania i zmiany cen zwykle nie określają informacji o użytkowniku, ponieważ Google korzysta z Twoich odpowiedzi do wypełniania pamięci podręcznej, która może służyć do obsługi różnych użytkowników.

Zwrócenie cen odpowiadających pełnym możliwym kontekstom użytkownika może być kosztowne, dlatego testujemy funkcję, w której w zapytaniu określono popularne konteksty użytkowników. Konteksty użytkownika opierają się na żądaniach użytkowników, w przypadku których udało Ci się wyświetlić cenę i są obliczane w taki sposób, aby obsłużyć większość żądań od użytkowników. Możesz zauważyć dużą liczbę kontekstów użytkownika w przypadku bardzo popularnych usług lub planów podróży, ale średnia liczba takich kontekstów powinna być mniejsza niż 10. Możesz zwrócić dodatkowe ceny lub zignorować określone konteksty użytkownika – to Ty decydujesz, jakie ceny zwrócić w przypadku danego zapytania. Zignorowanie sugerowanego kontekstu użytkownika może jednak spowodować zmniejszenie ruchu.

Tryb przesyłania push ARI

Tryb dostarczania ARI Push pozwala wysyłać do Google przyrostowe aktualizacje za każdym razem, gdy zmienią się stawki za noc, dostępność, liczba zasobów reklamowych lub inne ograniczenia. W przeciwieństwie do pobierania lub zmiany cen ARI Push pozwala używać innego modelu cenowego w celu efektywnego aktualizowania różnych komponentów informacji o cenach do Google.

Poniższy diagram przedstawia przepływ żądań i odpowiedzi w trybie dostarczania ARI Push:

Krok 1. Wyślij komunikaty push ARI do Google

Aby aktualizować dane za pomocą ARI Push, wysyłaj żądanie ARI po każdej zmianie danych. Tryb dostarczania push ARI obsługuje różne typy wiadomości i strategie cenowe. Szczegółowe informacje o przekazywaniu wiadomości znajdziesz w artykule Korzystanie z ARI.

Twoje ceny powinny zostać wyświetlone przez Google i widoczne dla użytkowników w ciągu 15–20 minut od otrzymania wiadomości.

Krok 2. Sprawdź, czy dane są zapisywane w pamięci podręcznej Google

W odpowiedzi na każdą otrzymaną wiadomość ARI Push Google podaje stan połączenia HTTP i wyniki przetwarzania ARI. Jeśli uda się nawiązać połączenie z serwerem, Google w odpowiedzi przesyła HTTP 200 OK. Zawiera też treść z komunikatem z informacją, czy aktualizacje zostały zastosowane, czy wystąpiły ostrzeżenia lub błędy trybu dostarczania.

Adresy IP na liście 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 zaktualizować ustawienia cen w Hotel Center.

Aktualizowanie metadanych pokoju i pakietu za pomocą ARI Push

Użyj opcji Typ wiadomości dotyczącej transakcji (dane usługi), aby zdefiniować aktywne typy pokojów i abonamenty (pakiety) dla każdej usługi. Należy przekazywać aktualizacje za każdym razem, gdy typy pokojów lub abonamenty są dodawane, usuwane lub modyfikowane. W takim przypadku wyślesz wiadomość XML z nowymi informacjami w elementach <RoomData> i <PackageData>. Elementy te są elementami podrzędnymi elementu <PropertyDataSet>.

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

Jeśli zobaczysz błąd trybu dostawy z powodu nieprawidłowego lub nieprawidłowego formatu pliku XML, zapoznaj się z zalecaną procedurą rozwiązania tego problemu w artykule Komunikaty o błędach stanu pliku danych.

Jeśli podczas wysyłania wiadomości ARI do Google pojawi się błąd połączenia HTTP, ponawiaj żądanie w 1, 5 i 20 minutach. Jeśli po 3 próbach problem nie ustąpi, 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 komunikaty z zapytaniem, aby zażądać aktualizacji cen. Serwer odpowiada na te wiadomości komunikatami o transakcjach, które zawierają zaktualizowane dane o cenach i dostępności.

Ten diagram przedstawia przepływ żądań/odpowiedzi w 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 bardziej szczegółowe informacje o każdym z tych kroków.

Krok 1. Wyślij zapytanie o komunikat

Domyślnie Google wysyła komunikaty dotyczące zapytań do wszystkich obiektów zdefiniowanych na liście hoteli. Może to oznaczać, że podczas procesu ponownej wyceny możesz otrzymywać wiele komunikatów dotyczących zapytań.

Komunikaty dotyczące cen, które Google wysyła na Twój serwer, mają następujące cechy:

• Element główny to <Query>.
• Wysyłana do punktu końcowego zdefiniowanego podczas początkowej konfiguracji. Aby dowiedzieć się więcej, skontaktuj się z technicznym menedżerem konta (TAM).
• 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 jest ustawiony na application/xml.
• Każda wiadomość zawiera maksymalnie 100 usług, w przypadku których Google prosi o dane o cenach i dostępności.
• Nagłówek User-Agent jest ustawiony na Google-HotelAdsPrices.

Krok 2. Wiadomość dotycząca transakcji

Gdy serwer otrzyma wiadomość z zapytaniem, musi odpowiedzieć, przesyłając wiadomość o transakcji zawierającą informacje o cenach żądanych planów podróży.

Głównym elementem wiadomości dotyczącej transakcji jest <Transaction>. Więcej informacji znajdziesz w sekcjach Komunikaty dotyczące transakcji i Aktualizowanie cen.

Zaktualizuj metadane pokoju i pakietu

Oprócz aktualizowania danych o cenach za pomocą Pull możesz też używać komunikatów o transakcjach do aktualizowania metadanych pokoju i pakietu. Więcej informacji znajdziesz w artykule Definiowanie metadanych pomieszczenia i pakietu.

Zmieniono tryb dostarczania cen

Zmiana cen pomaga zmniejszyć rozmiar i liczbę wiadomości dotyczących zapytań i transakcji w celu aktualizacji cen. Korzystając ze zmiany cen, przesyłasz do Google listę miejsc zakwaterowania ze zaktualizowanymi cenami. W odpowiedzi Google przesyła komunikat „Zapytanie”, który zawiera tylko prośbę o ceny tych miejsc.

Aby skonfigurować punkt końcowy, do którego Google wysyła komunikaty żądania podpowiedzi, skontaktuj się z technicznym menedżerem konta (TAM). Możesz to zrobić podczas konfiguracji początkowej.

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

W sekcjach poniżej opisujemy każdy z kroków w ramach tego procesu.

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

Żądania podpowiedzi, które Google wysyła na Twój serwer, mają te cechy:

• Element główny to <HintRequest>.
• Wysyłana do punktu końcowego zdefiniowanego podczas konfiguracji początkowej. Aby dowiedzieć się więcej, skontaktuj się z technicznym menedżerem konta (TAM).
• Używaj metody HTTP POST. (Jeśli używasz protokołu HTTPS, musisz uzyskać domenę podpisaną przez oficjalny urząd certyfikacji).
• Nagłówek Content-Type jest ustawiony na application/xml.
• Google z określoną częstotliwością wysyła do Twojego serwera sygnaturę czasową, która określa, kiedy po raz ostatni odpowiadasz na wiadomość dotyczącą żądania podpowiedzi.
• Nagłówek User-Agent jest ustawiony na Google-HotelAdsPrices.

Zalecamy ustawienie częstotliwości na 5 minut. Aby ustawić lub zmienić częstotliwość wysyłania wiadomości z prośbą o podpowiedź, skontaktuj się z nami.

Gdy otrzymasz od Google wiadomość z prośbą o podpowiedź, będziesz odpowiadać, podając wszystkie ceny, które zostały zaktualizowane od tej sygnatury czasowej. Więcej informacji znajdziesz w artykule Komunikaty dotyczące próśb o wskazówki.

Krok 2. Wiadomość z odpowiedzią

Serwer odpowiada na żądanie podpowiedzi, przesyłając wiadomość z odpowiedzią. Zawiera ona identyfikatory hoteli i plany podróży obiektów, których ceny uległy zmianie od ostatniego otrzymania wiadomości z prośbą o podpowiedź i odpowiedzi na nią.

Główny element wiadomości z odpowiedzią to <Hint>. Więcej informacji znajdziesz w artykule Wiadomości z odpowiedzią na podpowiedzi.

Krok 3. Utwórz zapytanie o komunikat

Google otrzymuje wiadomość z odpowiedzią i odpowiada za pomocą zapytania, tak jak w standardowym trybie pobierania. Różnica polega na tym, że wiadomość w zapytaniu zawiera teraz tylko identyfikatory hoteli i plany podróży do miejsc zakwaterowania określonych w odpowiedzi. Elementem głównym wiadomości zapytania jest <Query>.

Podczas ustalania identyfikatorów hoteli, których dotyczy prośba o cenę w przypadku zmiany cen, Google zignoruje zawartość pliku danych z listą hoteli. Zmniejsza to rozmiar wiadomości w zapytaniu, jaką otrzymujesz od Google, oraz rozmiaru komunikatu transakcji w odpowiedzi.

Krok 4. Wiadomość dotycząca transakcji

W odpowiedzi na wiadomości wysyłane przez Google do zapytań wysyłasz wiadomość dotyczącą transakcji z aktualizacją cen. Głównym elementem wiadomości dotyczącej transakcji jest <Transaction>. Więcej informacji znajdziesz w artykule o trybie dostarczania pull.