ARI – omówienie

Dostępność, stawki i zasoby reklamowe to tryb określania cen, który kontroluje stawki za noc, dostępność i zasoby reklamowe oraz określa ograniczenia dotyczące ich łączenia. ARI zapewnia też elastyczność w zakresie uwzględniania podatków, opłat i promocji.

W odróżnieniu od trybów dostawy cen opartych na planie podróży (pobieranie i zmiana cen) pliki danych ARI nie są wysyłane do plików danych ARI bez zapytań o konkretne ceny czy plany podróży. Zamiast tego przekazujesz komunikaty, gdy Twój model cenowy ma nowe lub zmienione dane – na przykład informacje o zmianach dotyczących cen, ograniczeniach czy dostępności.

Zalety

ARI zapewnia następujące korzyści:

  • Wydajność przepustowości: zwiększa wydajność przepustowości, zmniejszając ilość danych do przesłania. Wysyłając co noc dane ARI i tylko stopniowe zmiany, Google może obliczać i aktualizować ceny i aktualizacje dla szerokiego zakresu wartości zakupionych z wyprzedzeniem i długości pobytu.

  • Dokładność cen: poprawia dokładność cen przez korzystanie z modelu zdarzeń push-on-change do wprowadzania aktualizacji na żywo.

  • Większy zasięg cenowy: zapewnia większy zasięg cenowy (liczbę planów podróży z cenami) dzięki użyciu szczegółowych danych połączonych w różne plany podróży.

  • Elastyczność: daje większą swobodę podczas oferowania promocji i pakietów.

  • Łatwość użycia: dane przesyła dane w sposób zgodny ze sposobem ich przechowywania w systemie, dzięki czemu nie trzeba obliczać cen ani zapisywać ich w pamięci podręcznej w przypadku wielu planów podróży.

Typy wiadomości w żądaniach

Wiadomości ARI wysyłane do Google są określane jako wiadomości „żądania” ARI. Następnie Google wyświetla komunikaty „odpowiedź” o powodzeniu lub niepowodzeniu.

W przypadku niektórych głównych typów wiadomości służących do definiowania dostępności i zasobów reklamowych ARI przestrzega standardowych protokołów OpenTravel Alliance (OTA).

ARI używa następujących komunikatów z żądaniami:

  • Transaction (Dane usługi). Określa typ pokoju i informacje o pakiecie (abonament).

  • OTA_HotelRateAmountNotifRQ. Określa wielkość obłożenia na dzień lub na podstawie LOS w usłudze (kombinacja typu pokoju i planu stawek) dla określonych zakresów dat.

  • OTA_HotelAvailNotifRQ. Określa dostępność i ograniczenia na podstawie typu pokoju i abonamentów. Za pomocą tego komunikatu można też aktualizować asortyment, ale preferowana jest OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ. Wskazuje asortyment sal fizycznych lub liczbę sal dostępnych do sprzedaży.

  • TaxFeeInfo. (Opcjonalnie) Określa podatki i opłaty obowiązujące w poszczególnych obiektach. Ta wiadomość nie jest wymagana, jeśli w komunikacie OTA_HotelRateAmountNotifRQ określono atrybut AmountAfterTax.

  • Promotions. (Opcjonalnie) Określa stawki promocyjne za określone rezerwacje, pobyty i użytkowników.

  • RateModifications. (Opcjonalnie) Określa reguły modyfikowania cen dla niektórych rezerwacji, pobytu i użytkowników.

  • ExtraGuestCharges. (Opcjonalnie) Określa sposób konfigurowania cen dla dzieci i dodatkowych dorosłych.

Każda wiadomość zawiera podzbiór informacji, których Google używa do obliczania cen i dostępności wyświetlanych użytkownikom, którzy szukają Twoich obiektów, z określonymi datami zameldowania i wymeldowania oraz wybraną liczbą osób.

Więcej informacji o ARI znajdziesz w dokumentacji XML.

Komunikaty push

Aby zaktualizować informacje o ARI i właściwościach, wysyłaj powiązane komunikaty po każdej zmianie danych w systemie.

Podczas wysyłania wiadomości postępuj zgodnie z tymi wskazówkami:

  • Skorzystaj z narzędzia samoobsługowego na stronie Ustawienia cen w Hotel Center, aby dodać lub zaktualizować adresy IP w naszym systemie.

  • Użyj tej ścieżki bazowej punktu końcowego:

    • https://www.google.com lub Host: www.google.com Port: 443

  • Wysyłaj wiadomości przy użyciu metody HTTP POST.

  • Ustaw nagłówek Content-Type na application/xml.

  • Na poziomie konta maksymalna częstotliwość aktualizacji to 400 wiadomości na sekundę. Jeśli przekroczysz ten limit, zwracany jest kod błędu 6032.

  • W zależności od aktualizowanych danych skorzystaj z tych ścieżek:

    • Transaction (dane usługi): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: /travel/hotels/uploads/taxes
    • Promotions: /travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

Na każdą otrzymaną wiadomość z żądaniem Google wyśle komunikat HTTP 200 OK, jeśli połączenie z serwerem nawiązało połączenie z serwerem, i dołączy treść z komunikatem informującym o tym, czy aktualizacje zostały zastosowane, czy wystąpiły ostrzeżenia lub błędy. Jeśli Google w odpowiedzi wyświetli kod błędu HTTP, wyślij wiadomość jeszcze raz. Jeśli treść odpowiedzi HTTP zawiera ostrzeżenia lub błędy, musisz je poprawić przed ponownym wysłaniem wiadomości. Możesz też przejrzeć problemy dotyczące konkretnych komunikatów na stronie Stan pliku danych w Hotel Center.

Opublikowane w Google (LoG)

Funkcja „Live on Google” pozwala wyświetlać hotele w witrynach Google. Ponieważ domyślna wartość LoG dla hotelu to true, wszystkie nowe hotele będą automatycznie wyświetlane w Google.

Korzystaj z LoG, aby włączać i wyłączać reklamy oraz bezpłatne linki do rezerwacji na koncie Hotel Center, niezależnie od stanu Google Ads czy tego, czy obiekt ma ceny w Google. Dotyczy to tylko hoteli, ale nie kwater wakacyjnych.

Wartość LoG hotelu można ustawić na 2 sposoby: Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API..

Więcej informacji na temat LoG znajdziesz w Centrum pomocy Hotel Center.

Korzystanie z programu Travel Partner API, you can do the following:

  • Wyświetl stan swoich miejsc zakwaterowania w Hotel Center lub użyj punktu końcowego hotelViews.list.

  • Pobierz listę wszystkich hoteli wyświetlanych w Google, używając parametru filter z liveOnGoogle = TRUE w punkcie końcowym hotelViews.list.

  • Aby wyświetlić podsumowanie właściwości danego konta, w tym liczbę miejsc zakwaterowania dostępnych w Google, skorzystaj z elementu hotelViews.summary.

Więcej informacji o konfigurowaniu LoG za pomocą interfejsu API znajdziesz w hotelViews.listartykulei dokumentacji API.