Tryby dostawy

Tryb dostawy określa sposób przesyłania do Google informacji o zmianach cen w przypadku kombinacji hoteli i planów podróży. Podczas początkowej konfiguracji trybu dostarczania łączysz się z technicznym menedżerem konta.

Omówienie trybów dostarczania

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

Im więcej masz planów podróży, tym więcej aukcji weźmiesz udział. Jednak im więcej planów podróży obsługujesz, tym więcej danych musisz przesłać do Google, aby dane o cenach były dokładne.

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

• ARI (Push): plik danych z cenami dostawy, który wykorzystuje plany stawek, dostępność i metadane hoteli do ustawiania zdefiniowanych wstępnie strategii cenowych dla Twoich obiektów. W przeciwieństwie do pobierania i zmiany cen pliki danych ARI nie wysyłają zapytań o konkretne ceny ani plany podróży. Zamiast tego przesyłasz wiadomości zawierające podzbiór informacji, które reprezentują model cenowy Twoich usług oparty na różnych szczegółach cen, ograniczeniach i dostępności. Pliki ARI używają specyfikacji OTA XML (OTA_HotelRateAmountNotifRQ i OTA_HotelAvailNotifRQ) do określania dostępności i cen. Skontaktuj się z menedżerem konta, aby dowiedzieć się więcej o trybie dostarczania danych ARI i określić, czy ten typ pliku danych byłby odpowiedni w przypadku Twojego konta. Więcej informacji znajdziesz w artykule o korzystaniu z ARI.

• Pobieranie: Google regularnie wysyła zapytania do 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, który w odpowiedzi wysyła zaktualizowane dane. Ten model sprawdza się najlepiej, gdy nie wiesz, kiedy dokładnie zmieniają się informacje o cenach lub nie zmieniają się one nieregularnie w ciągu dnia. Ceny pozostają w pamięci podręcznej, dopóki algorytmy Google nie ustalą, że ceny stały się nieaktualne (na podstawie historii zmian cen poszczególnych partnerów). Więcej informacji znajdziesz w artykule o korzystaniu z trybu dostarczania pull.

• Zmiana cen (wcześniej pobieranie za pomocą podpowiedzi): podobnie jak pobieranie, ale Google żąda danych tylko dla podzbioru usług, a nie wszystkich usług. Ten tryb może znacznie ograniczyć ruch sieciowy podczas aktualizowania cen i dostępności usług. Ceny są przechowywane w pamięci podręcznej bez ograniczeń czasowych do momentu aktualizacji. Więcej informacji znajdziesz w artykule na temat korzystania ze zmian cen.

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

Więcej informacji o aktualizowaniu cen, w tym przykłady komunikatów o transakcjach, znajdziesz w sekcji Aktualizowanie cen.

Zapytania o ceny w czasie rzeczywistym

Google może też prosić o pewne zmiany cen w czasie aukcji za pomocą zapytania o rzeczywistą cenę. Zapytania o rzeczywistą cenę to zapytania przesyłane przez Google do cen uczestniczących w bieżącej aukcji. Jeśli odpowiesz w określonym terminie, Twoja reklama powinna pojawić się w aukcji.

Google przechowuje odpowiedź na zapytanie o rzeczywistą cenę tak jak w przypadku innych komunikatów o transakcjach. Dzięki temu Google może wyświetlić cenę ze swojej pamięci podręcznej, zamiast wysyłać w przyszłości kolejne zapytanie o rzeczywistą cenę.

Więcej informacji znajdziesz w sekcji Zapytania o rzeczywiste ceny.

Ważne: w związku z nową funkcją wyszukiwania bieżące zapytanie nie jest już dostępne dla użytkowników z EOG.

Kontekst

Zapytania typu „pobieranie i zmienianie cen” zwykle nie określają informacji o użytkowniku, ponieważ Google używa Twoich odpowiedzi do wypełnienia pamięci podręcznej, która może służyć do obsługi różnych użytkowników.

Zwracanie cen odpowiadających pełnemu zbiorowi możliwego kontekstu użytkownika może być kosztowne, dlatego testujemy funkcję, w której w zapytaniu określone są popularne konteksty użytkowników. Konteksty użytkowników opierają się na żądaniach użytkowników, w przypadku których można było podać cenę, i są obliczane w taki sposób, aby uwzględniać większość żądań użytkowników. W przypadku bardzo popularnych usług lub planów podróży możesz zobaczyć dużą liczbę kontekstów użytkownika, 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ć za dane zapytanie. Zignorowanie sugerowanego kontekstu użytkownika może jednak spowodować zmniejszenie ruchu.

Wskazówka: jeśli chcesz otrzymywać popularne konteksty użytkowników w zapytaniach wysyłanych przez Google, skontaktuj się z technicznym menedżerem konta (TAM). Potwierdzi on, że możesz już otrzymywać takie wiadomości, a następnie dostosuje konfigurację, aby zacząć wysyłać do Ciebie konteksty użytkownika w zapytaniach.

Tryb dostarczania danych push ARI

W trybie dostarczania danych push ARI wysyłasz przyrostowe aktualizacje do Google 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 funkcja ARI Push umożliwia użycie innego modelu cenowego do efektywnego aktualizowania w Google różnych komponentów informacji o cenach.

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

Krok 1. Wyślij komunikaty ARI do Google

Aby zaktualizować dane za pomocą ARI Push, wyślij wiadomość z żądaniem ARI po każdej zmianie danych. Tryb dostarczania wiadomości push ARI obsługuje różne typy wiadomości i strategie cenowe. Szczegółowe informacje o wysyłaniu wiadomości w trybie push znajdziesz w artykule o używaniu ARI.

Twoje 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 Google zapisuje dane w pamięci podręcznej

Na każdą otrzymaną wiadomość push ARI Google przekazuje stan połączenia HTTP i wyniki przetwarzania ARI. Jeśli połączenie z serwerem się powiedzie, Google w odpowiedzi przesyła HTTP 200 OK. Zawiera też treść z odpowiedzią wskazującą, 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, otwórz stronę ustawień cen ARI Hotel Center. Dowiedz się, jak zaktualizować ustawienia cen w Hotel Center.

Aktualizowanie metadanych sali i pakietu za pomocą funkcji ARI Push

Aby określić typy aktywnych pokojów i plany stawek (pakiety) w przypadku każdej usługi, użyj typu komunikatu Transakcja (Dane obiektu). Aktualizacje należy wysyłać za każdym razem, gdy zostaną dodane, usunięte lub zmienione typy pokojów lub abonamenty. W takim przypadku wysyłasz wiadomość w formacie XML z nowymi informacjami zawartymi w elementach <RoomData> i <PackageData>. Te elementy są elementami podrzędnymi elementu <PropertyDataSet>.

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

Jeśli wystąpi błąd trybu przesyłania spowodowany nieprawidłowym lub nieprawidłowym formatem pliku XML, znajdź zalecany sposób rozwiązania problemu w sekcji Komunikaty o błędach stanu pliku danych.

Jeśli podczas wysyłania wiadomości ARI do Google wystąpi błąd połączenia HTTP, ponów żądanie co 1, 5 lub 20 minut. Jeśli po 3 próbach problem nie ustąpi, przestań wysyłać wiadomości i skontaktuj się z zespołem pomocy Google.

Tryb pobierania pull

W trybie dostarczania pull Google okresowo wysyła wiadomości zapytań na Twój serwer, aby prosić o aktualizację cen. Serwer odpowiada na te wiadomości wiadomościami o transakcjach, które zawierają zaktualizowane dane o cenach i dostępności.

Ten diagram przedstawia przepływ żądań i odpowiedzi w ramach pull:

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

W poniższych sekcjach opisano szczegółowo każdy z tych kroków.

Krok 1. Wyślij zapytanie do wiadomości

Domyślnie Google wysyła wiadomości dotyczące zapytania dotyczące wszystkich miejsc zakwaterowania zdefiniowanych na liście hoteli. Może to oznaczać, że w trakcie procesów ponownej wyceny możesz otrzymywać wiele wiadomości dotyczących zapytań.

Komunikaty o zapytaniach o cenę wysyłane przez Google na Twój serwer mają te cechy:

• Elementem głównym jest <Query>.
• Wysyłana do punktu końcowego zdefiniowanego podczas początkowej konfiguracji. Aby dowiedzieć się więcej, skontaktuj się z technicznym menedżerem konta.
• Używa metody HTTP POST. Jeśli używasz protokołu HTTPS, domena musi podpisać 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.

Ważne: może się pojawić wiele komunikatów typu Zapytanie, które zaktualizują wszystkie ceny wszystkich hoteli, a wyniki transakcji mogą być bardzo duże. Aby zmniejszyć rozmiar i liczbę wiadomości, zalecamy użycie zmiany cen.

Krok 2. Wiadomość dotycząca transakcji

Gdy serwer odbiera komunikat zapytania, musi w odpowiedzi wysłać komunikat o transakcji zawierający informacje o cenach wybranych planów podróży.

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

Aktualizowanie metadanych pokoju i pakietu

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

Zmiana cenowego trybu dostawy

Zmiana cen pomaga zmniejszyć rozmiar i liczbę wiadomości dotyczących zapytań i transakcji dotyczących aktualizacji cen. Gdy używasz zmiany cen, wysyłasz do Google listę miejsc zakwaterowania ze zaktualizowanymi cenami. W odpowiedzi Google wyświetla zapytanie, w którym pojawia się prośba o podanie tylko cen tych miejsc zakwaterowania.

Aby skonfigurować punkt końcowy, do którego Google wysyła wiadomości z prośbą o podpowiedź, skontaktuj się z technicznym menedżerem konta (TAM). Możesz to zrobić podczas konfiguracji początkowej.

Ważne: jeśli nie wdrożysz odpowiedzi na podpowiedź, funkcja Wiadomości z zapytań Google będzie prosić o dostęp do danych dotyczących obiektów all znajdujących się na Twojej liście hoteli.

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

W kolejnych sekcjach opisano każdy krok tego procesu.

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

Wiadomości żądania podpowiedzi, 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 dowiedzieć się więcej, skontaktuj się z technicznym menedżerem konta (TAM).
• Użyj metody HTTP POST. Jeśli używasz protokołu HTTPS, domena musi być podpisana przez oficjalny urząd certyfikacji.
• Nagłówek Content-Type jest ustawiony na application/xml.
• Z określoną częstotliwością Google wysyła do Twojego serwera sygnaturę czasową, która określa czas ostatniej odpowiedzi na wiadomość z żądaniem podpowiedzi.
• Nagłówek User-Agent jest ustawiony na Google-HotelAdsPrices.

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

Gdy otrzymasz od Google wiadomość z prośbą o podpowiedź, w odpowiedzi podajesz wszystkie ceny, które zostały zmienione od tej sygnatury czasowej. Więcej informacji znajdziesz w artykule Komunikaty z prośbą o podpowiedź.

Krok 2. Wiadomość z odpowiedzią na podpowiedź

Serwer odpowiada na komunikat z żądaniem podpowiedzi, wysyłając wiadomość z odpowiedzią. Ta wiadomość zawiera identyfikatory hoteli i plany podróży do miejsc zakwaterowania, których ceny zmieniły się od czasu Twojej ostatniej wiadomości z prośbą o podpowiedź i odpowiedzi na nią.

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

Krok 3. Wyślij zapytanie do wiadomości

Google otrzymuje odpowiedź z podpowiedzią i w odpowiedzi wysyła zapytanie, tak jak w standardowym trybie pull. Różnica polega na tym, że wiadomość z zapytaniem zawiera teraz tylko identyfikatory hoteli i plany podróży do miejsc zakwaterowania określonych w odpowiedzi na podpowiedź. Elementem głównym wiadomości w zapytaniu jest <Query>.

Podczas ustalania, o które identyfikatory hoteli poprosić w przypadku zmiany cen, Google ignoruje treść pliku danych z listą hoteli. W ten sposób znacznie zmniejsza się rozmiar wiadomości z zapytaniami otrzymywanej od Google oraz komunikatu dotyczącego transakcji.

Krok 4. Wiadomość dotycząca transakcji

W odpowiedzi na zapytania Google wysyłasz wiadomość dotyczącą transakcji z aktualizacją cen. Elementem głównym wiadomości dotyczącej transakcji jest <Transaction>. Więcej informacji znajdziesz w sekcji Tryb dostawy pull.