Wiadomości o transakcjach wysyłają do Google informacje o pokojach, cenach i pakietach. Istnieją 2 główne typy wiadomości transakcji:
Dane planu podróży: zdefiniuj pakiet pokoi i dane planu podróży, w tym:
Ceny hoteli i zasoby reklamowe: ustaw minimalną cenę dla planu podróży, który spełnia określone wymagania. Więcej informacji znajdziesz w artykule Aktualizowanie cen. Możesz też usunąć salę z spisu. Więcej informacji znajdziesz w artykule Usuwanie zasobów reklamowych.
Pakiety pokojów: ustaw ceny w planie podróży obejmującym fizyczny pokój i pakiet usług dodatkowych. Więcej informacji znajdziesz w sekcji Pakiety pokojów. Google przechowuje treść wiadomości dotyczących transakcji w pamięci podręcznej, dzięki czemu ceny są 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 komunikaty
<Query>(lub w niektórych przypadkach zapytania o cenę w czasie rzeczywistym), aby uzyskać zaktualizowane ceny. Te dane zwykle zmieniają się bardzo często. Aby określić ceny i dostępność wiadomości dotyczących transakcji, użyj narzędzia<Result>.
Metadane pokoju i pakietu: określa szczegółowe informacje o pokojach i pakietach, np. opisy, zdjęcia i maksymalną liczbę osób. Dane te nie zmieniają się zbyt często. Do definiowania metadanych wiadomości transakcji służy
<PropertyDataSet>. Google przechowuje te metadane, aby można było się do nich odwoływać w informacjach o cenach, zamiast powtarzać informacje o salach i pakietach w każdym z nich. Więcej informacji znajdziesz w artykule Definiowanie metadanych pokoju i pakietu.
Głównym elementem wiadomości dotyczącej transakcji jest <Transaction>. Wiadomości korzystające z elementu <Transaction> jako elementu głównego wymagają co najmniej 1 z elementów podrzędnych. Wiadomości dotyczące transakcji mogą mieć dowolną liczbę elementów podrzędnych, o ile łączny rozmiar wiadomości nie przekracza 100 MB.
Przykłady wiadomości o transakcjach w odpowiedziach na żądania Google znajdziesz w artykule Informacje o formacie XML dotyczącym cen i zasobów reklamowych sal (transakcje).
Tryby dostawy
Typ i częstotliwość, z jaką wysyłasz wiadomości o transakcjach, zależy od wybranego trybu dostarczania:
- W trybie dostarczania pull wiadomości związane z transakcjami wysyłasz po otrzymaniu od Google
<Query>. - W przypadku trybu dostawy ze zmienionymi cenami wysyłasz wiadomość dotyczącą transakcji po otrzymaniu wiadomości
<HintRequest>oraz<Query>i udzieleniu na nie odpowiedzi.
Więcej informacji znajdziesz w artykule na temat cenników trybów dostawy.
Zapytania o aktualne ceny
Niezależnie od trybu dostawy Google może też wysyłać do Ciebie żądania nazywane zapytaniami o rzeczywistą cenę. Te wiadomości z zapytaniami szukają cen w odpowiedzi na aktualne wyszukiwanie. Jeśli zareagujesz w wyznaczonym terminie, czyli zazwyczaj w ciągu kilkuset milisekund, Twoja reklama może wziąć udział w aukcji. Dzięki temu wyniki będą też lepiej dopasowane do klienta, np. do jego kraju i typu urządzenia oraz podanej przez niego liczby gości. Więcej informacji znajdziesz w sekcji Zapytania o aktualną cenę.
Rozmiar wiadomości
W pojedynczej wiadomości dotyczącej transakcji możesz zawrzeć dowolną kombinację aktualizacji danych, ale obowiązuje limit 100 MB dla każdej wiadomości. Zwykle wszystkie żądania pull i wskazówki mają limit czasu odpowiedzi wynoszący 100 sekund. Limit czasu to pole, które można skonfigurować, które może być zmieniane przez Google zgodnie z żądaniem. Google zaleca ustawienie limitu na 10 minut w przypadku bardzo dużych wiadomości.
Aby znacznie zmniejszyć rozmiar wiadomości i potencjalnie uniknąć problemów z rozmiarem wiadomości i limitami czasu ich wyświetlania, użyj opcji wiadomości transakcji do wstępnego zdefiniowania metadanych pokoju i pakietu.
Możesz też dodać do wiadomości zawartość skompresowaną przez GNU, dodając Content-Encoding: gzip do nagłówków wiadomości.