Wiadomości o transakcjach wysyłają do Google dane o pokojach, cenach i pakietach. Istnieją 2 podstawowe typy wiadomości transakcyjnych:
Dane planu podróży: określ dane dotyczące pakietu pokoi i planu podróży, w tym:
Ceny i asortyment hoteli: 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 zasobów. Więcej informacji znajdziesz w artykule Usuwanie zasobów reklamowych.
Pakiety pokoi: ustalaj ceny za plan podróży obejmujący pokój i pakiet dodatkowych usług. Więcej informacji znajdziesz w artykule Pakiet pokoju. Google przechowuje w pamięci podręcznej zawartość wiadomości o transakcjach, aby ceny były dostępne przez cały czas. W niektórych przypadkach Google stwierdza, że wartości w pamięci podręcznej są nieaktualne, więc może wysłać dodatkowe
<Query>wiadomości (lub w niektórych przypadkach zapytania o ceny w czasie rzeczywistym), aby uzyskać aktualne ceny. Dane te zwykle zmieniają się bardzo często. Aby zdefiniować ceny i dostępność komunikatów dotyczących transakcji, użyj elementu<Result>.
Metadane pokoi i pakietów: określają szczegóły 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 dotyczące 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 o cenach, zamiast powtarzać informacje o pokojach i pakietach w każdej wiadomości. Więcej informacji znajdziesz w artykule Definiowanie metadanych sal i pakietów.
Elementem głównym wiadomości transakcyjnej jest <Transaction>. Wiadomości, które używają elementu <Transaction> jako elementu rdzeniowego, wymagają co najmniej jednego z elementów podrzędnych. Wiadomości transakcyjne mogą mieć dowolną liczbę elementów podrzędnych, o ile łączny rozmiar wiadomości nie przekracza 100 MB.
Przykłady wiadomości Transaction odpowiadających na żądania Google znajdziesz w artykule Plik XML dotyczący cen i zasobów reklamowych (Transakcje).
Tryby wyświetlania
Typ i częstotliwość wysyłania wiadomości transakcyjnych zależą od trybu dostarczania:
- W przypadku trybu dostawy „wyciąganie” wysyłasz wiadomości transakcyjne, gdy otrzymasz
<Query>od Google. - W trybie dostarczania „Zmienione ceny” wysyłasz wiadomość transakcyjną po otrzymaniu i odpowiedzeniu na wiadomość
<HintRequest>i<Query>.
Więcej informacji znajdziesz w artykule Tryby dostarczania cen.
Zapytania o rzeczywistą cenę
Niezależnie od trybu dostarczania Google może też wysyłać do Ciebie żądania zwane zapytaniami o ceny na żywo. Te komunikaty z zapytaniami odnoszą się do obecnego wyszukiwania. Jeśli odpowiesz w określonym czasie, który wynosi zwykle kilkaset milisekund, Twoja reklama może się pojawić w aukcji. Wyniki mogą też lepiej pasować do klienta, uwzględniając jego kraj, typ urządzenia i liczbę wskazanych przez niego gości. Więcej informacji znajdziesz w artykule Pytania dotyczące cen w czasie rzeczywistym.
Rozmiar wiadomości
W jednym komunikacie Transaction możesz uwzględnić dowolną kombinację aktualizacji danych, ale rozmiar każdego komunikatu nie może przekraczać 100 MB. Zwykle czas odpowiedzi na wszystkie żądania pull i hint wynosi 100 sekund. Limit czasu to konfigurowalne pole, które Google może dostosować zgodnie z prośbą. Google zaleca, aby w przypadku bardzo dużych wiadomości ustawić limit czasu na 10 minut.
Aby znacznie zmniejszyć rozmiar wiadomości i uniknąć problemów z ich rozmiarem i czasem oczekiwania, użyj wiadomości transakcyjnych do wstępnego zdefiniowania metadanych pokoju i pakietu.
Możesz też dodawać do wiadomości skompresowane treści GNU, dodając Content-Encoding: gzip do nagłówków wiadomości.