Wiadomości o transakcjach wysyłają do Google dane o pokojach, cenach i pakietach. Są 2 główne typy wiadomości o transakcjach:
Dane planu podróży: określ dane dotyczące pakietu sal 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 sekcji Aktualizowanie cen. Możesz też usunąć salę z zasobów reklamowych. Więcej informacji znajdziesz w artykule Usuwanie zasobów reklamowych.
Pakiety pokojów: ustaw ceny w planie podróży, które obejmują połączenie fizycznego pomieszczenia i pakietu usług dodatkowych. Więcej informacji znajdziesz w artykule Pakiety pokoi. Google zapisuje w pamięci podręcznej treść wiadomości transakcji, dzięki czemu ceny są zawsze dostępne. W niektórych przypadkach Google ustali, że wartości w jej pamięci podręcznej są nieaktualne, więc może wysłać dodatkowe wiadomości
<Query>(lub w niektórych przypadkach zapytania o rzeczywistą cenę), aby uzyskać zaktualizowane ceny. Dane te zmieniają się zwykle bardzo często. Aby określić ceny i dostępność wiadomości o transakcjach, użyj<Result>.
Metadane sal i pakietów: pozwalają określić szczegółowe informacje o pokojach i pakietach, takie jak opisy, zdjęcia i maksymalna liczba osób. Dane te nie zmieniają się zbyt często. Aby zdefiniować komunikaty dotyczące transakcji z metadanymi, użyj właściwości
<PropertyDataSet>. Google przechowuje te metadane, dzięki czemu możesz się do nich odwołać w komunikatach o cenach, zamiast podawać powtarzające się informacje o salach i pakietach w każdym z nich. Więcej informacji znajdziesz w artykule Definiowanie metadanych sal i pakietów.
Elementem głównym wiadomości dotyczącej transakcji jest <Transaction>. Wiadomości, w których element <Transaction> jest elementem głównym, muszą zawierać co najmniej 1 element podrzędny. Wiadomości dotyczące transakcji mogą zawierać dowolną liczbę elementów podrzędnych, o ile łączny rozmiar wiadomości nie przekracza 100 MB.
Przykłady komunikatów dotyczących transakcji, które odpowiadają na żądania Google, znajdziesz w dokumentacji dotyczącej pliku XML dotyczącego cen i zasobów reklamowych (transakcje).
Tryby dostawy
Typ i częstotliwość wysyłania wiadomości o transakcjach zależy od trybu dostarczania:
- W trybie dostarczania pull wiadomości o transakcjach są wysyłane, gdy otrzymasz od Google
<Query>. - W przypadku trybu dostawy w przypadku zmiany cen wysyłasz wiadomość dotyczącą transakcji po otrzymaniu odpowiedzi na te e-maile oraz odpowiedzi na nie:
<HintRequest>i<Query>.
Więcej informacji znajdziesz w artykule Modele cenowe dostawy.
Zapytania o rzeczywistą cenę
Niezależnie od trybu dostarczania Google może też wysyłać Ci żądania, tzw. zapytania o rzeczywistą cenę. Te wiadomości z zapytaniami szukają cen w odpowiedzi na bieżące wyszukiwanie. Jeśli odpowiesz w określonym terminie, który wynosi zwykle kilkaset milisekund, Twoja reklama może wziąć udział w aukcji. Twoje wyniki mogą być też lepiej dopasowane do potrzeb klienta, w tym jego kraju, typu urządzenia i określonej liczby gości. Więcej informacji znajdziesz w sekcji Zapytania o rzeczywistą cenę.
Rozmiar wiadomości
W jednej wiadomości dotyczącej transakcji możesz zawrzeć dowolną kombinację aktualizacji danych, ale jej rozmiar nie może przekraczać 100 MB. Zwykle czas odpowiedzi na wszystkie żądania pull i podpowiedzi wynosi 100 sekund. Limit czasu jest konfigurowalnym polem, które Google może odpowiednio dostosować. W przypadku bardzo dużych wiadomości Google zaleca ustawienie czasu oczekiwania na 10 minut.
Aby znacznie zmniejszyć rozmiar wiadomości i uniknąć problemów z rozmiarami i limitami czasu wiadomości, użyj funkcji Wiadomości transakcji do wstępnego zdefiniowania metadanych sal i pakietów.
Możesz też dodawać do wiadomości zawartość skompresowaną w formacie GNU, dodając do jej nagłówków parametr Content-Encoding: gzip.