Wiadomości transakcyjne przesyłają do Google dane o pokojach, cenach i pakietach. Istnieją 2 główne typy wiadomości transakcyjnych:
Dane planu podróży: zdefiniuj pakiet pokoi i dane planu podróży, w tym:
Ceny hoteli i dostępność: ustaw minimalną cenę planu podróży, który spełnia określone wymagania. Więcej informacji znajdziesz w artykule Aktualizowanie cen. Możesz też usunąć pokój z asortymentu. Więcej informacji znajdziesz w artykule Usuwanie zasobów reklamowych.
Pakiety pokoi: ustaw ceny planu podróży dla połączenia pokoju fizycznego i pakietu usług dodatkowych. Więcej informacji znajdziesz w sekcji Pakiety sal. Google buforuje treść wiadomości transakcyjnych, aby ceny były zawsze dostępne. W niektórych przypadkach Google stwierdza, że wartości w pamięci podręcznej są nieaktualne, więc może wysyłać dodatkowe wiadomości
<Query>(lub w niektórych przypadkach zapytania o ceny w czasie rzeczywistym), aby uzyskać zaktualizowane ceny. Dane te zwykle zmieniają się bardzo często. Aby określić ceny i dostępność w komunikatach dotyczących transakcji, użyj elementu<Result>.
Metadane pokoju i pakietu: określają szczegóły dotyczące pokoi i pakietów, takie jak opisy, zdjęcia i maksymalna liczba osób. Te dane nie zmieniają się zbyt często. Aby zdefiniować metadane wiadomości o transakcjach, użyj elementu
<PropertyDataSet>. Google przechowuje te metadane, aby można było się do nich odwoływać w wiadomościach z cenami, zamiast w każdej z nich podawać powtarzające się informacje o pokojach i pakietach. Więcej informacji znajdziesz w artykule Definiowanie metadanych pokoju i pakietu.
Elementem głównym wiadomości transakcyjnej jest <Transaction>. Wiadomości, które używają elementu <Transaction> jako elementu głównego, wymagają co najmniej jednego elementu podrzędnego. Wiadomości transakcyjne mogą zawierać dowolną liczbę elementów podrzędnych, o ile łączny rozmiar wiadomości nie przekracza 100 MB.
Przykłady wiadomości o transakcjach odpowiadających na żądania Google znajdziesz w artykule Plik XML dotyczący cen i zasobów reklamowych pokoi (transakcje).
Tryby wyświetlania
Rodzaj i częstotliwość wysyłania wiadomości transakcyjnych zależą od trybu dostarczania:
- W przypadku trybu dostarczania Pull wysyłasz wiadomości o transakcjach, gdy otrzymasz od Google
<Query>. - W przypadku trybu dostawy Zmienione ceny wysyłasz wiadomość o transakcji po otrzymaniu odpowiedzi na
<HintRequest>i<Query>.
Więcej informacji znajdziesz w sekcji Tryby dostawy.
Zapytania o rzeczywistą cenę
Niezależnie od trybu dostarczania Google może też wysyłać do Ciebie żądania znane jako zapytania o ceny w czasie rzeczywistym. Te wiadomości z zapytaniem o cenę są wysyłane w odpowiedzi na bieżące wyszukiwanie. Jeśli odpowiesz w określonym czasie, który zwykle wynosi kilkaset milisekund, Twoja reklama może wziąć udział w aukcji. Wyniki mogą być lepiej dopasowane do klienta, w tym do jego kraju i typu urządzenia, a także do liczby gości, którą podał. Więcej informacji znajdziesz w artykule Zapytania o ceny w czasie rzeczywistym.
Rozmiar wiadomości
W jednej wiadomości transakcji możesz uwzględnić dowolną kombinację aktualizacji danych, ale rozmiar każdej wiadomości jest ograniczony do 100 MB. Zwykle wszystkie żądania Pull i Hint mają limit czasu odpowiedzi wynoszący 100 sekund. Limit czasu to pole konfigurowalne, które Google może dostosować na żądanie. W przypadku bardzo dużych wiadomości Google zaleca ustawienie limitu czasu na 10 minut.
Aby znacznie zmniejszyć rozmiar wiadomości i potencjalnie uniknąć problemów z rozmiarem wiadomości i przekroczeniem limitu czasu, użyj wiadomości transakcyjnych, aby wstępnie zdefiniować metadane pokoju i pakietu.
Możesz też dodawać do wiadomości skompresowane treści GNU, dodając do nagłówków wiadomości
Content-Encoding: gzip.