Omówienie ARI

Dostępność, stawki i zasoby reklamowe (ARI) to tryb dostarczania cen, który kontroluje stawki za nocleg, dostępność i zasoby reklamowe oraz określa ograniczenia dotyczące sposobu, w jaki można je łączyć. ARI zapewnia też elastyczność w zakresie uwzględniania podatków, opłat i promocji.

W przeciwieństwie do trybów dostarczania danych opartych na planie podróży, takich jak Pull i Changed Pricing, pliki danych ARI nie są sprawdzane pod kątem konkretnych cen ani planów podróży. Zamiast tego wysyłasz wiadomości, gdy w Twoim modelu cenowym pojawią się nowe lub zmienione dane, np. zmiany szczegółów stawek, ograniczeń i dostępności.

Zalety

ARI zapewnia te korzyści:

  • Wydajność przepustowości: zwiększa wydajność przepustowości, zmniejszając ilość danych, które trzeba przesłać. Wysyłając dane ARI co noc i tylko przyrostowe zmiany, Google może obliczać ceny i aktualizacje dla szerokiego zakresu wartości dotyczących zakupu z wyprzedzeniem i długości pobytu.

  • Dokładność ceny: zwiększa dokładność ceny dzięki wykorzystaniu modelu zdarzenia push-on-change, który zapewnia aktualizacje na żywo.

  • Większy zasięg cen: większy zasięg cen (liczba tras z cenami) dzięki wykorzystaniu szczegółowych danych, które są łączone w różne trasy.

  • Elastyczność: większa elastyczność w oferowaniu promocji i pakietów.

  • Łatwość użycia: przesyła dane w sposób zgodny z tym, jak są one przechowywane w Twoim systemie, co eliminuje konieczność obliczania lub buforowania cen dla wielu tras.

Typy wiadomości z żądaniami

Wiadomości ARI wysyłane do Google są nazywane wiadomościami „z prośbą” ARI. Google następnie zwraca komunikaty „response” wskazujące powodzenie lub niepowodzenie.

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

<OTA_HotelRateAmountNotifRQ>

Interfejs ARI używa tych wiadomości z żądaniem:

  • Transaction (Dane usługi) Określa typ pokoju i pakiet (plan cenowy).

  • OTA_HotelRateAmountNotifRQ. Określa kwoty stawek za pokój na podstawie daty lub długości pobytu dla poszczególnych produktów (kombinacji typu pokoju i planu cenowego) w określonych zakresach dat.

  • OTA_HotelAvailNotifRQ. Określa dostępność i ograniczenia na podstawie typu pokoju i planów cenowych. Za pomocą tej wiadomości można też aktualizować zasoby reklamowe, ale zalecane jest używanie elementu OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQOkreśla fizyczne zasoby pokoi lub liczbę pokoi dostępnych do sprzedaży.

  • TaxFeeInfo(Opcjonalny) Określa podatki i opłaty dla poszczególnych usług. Ten komunikat nie jest wymagany, jeśli w komunikacie OTA_HotelRateAmountNotifRQ określono AmountAfterTax.

  • Promotions. (Opcjonalnie) Określa ceny promocyjne dla niektórych rezerwacji, pobytów i użytkowników.

  • RateModifications(Opcjonalnie) Określa reguły modyfikacji stawek w przypadku określonych rezerwacji, pobytów i użytkowników.

  • ExtraGuestCharges. (Opcjonalnie) Określa, jak należy skonfigurować stawki dla dzieci i dodatkowych osób 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, gdy szukają Twoich obiektów z określonymi datami zameldowania i wymeldowania oraz liczbą osób.

Więcej informacji o ARI znajdziesz w dokumentacji XML.

Wiadomości push

Aby zaktualizować ARI i informacje o obiekcie, wysyłaj powiązane wiadomości za każdym razem, gdy w Twoim systemie zmienią się dane.

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

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

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

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

  • Wysyłaj wiadomości za pomocą metody HTTP POST.

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

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

  • Wybierz jedną z tych ścieżek w zależności od aktualizowanych danych:

    • 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

W odpowiedzi na każdą otrzymaną wiadomość z żądaniem Google wyśle HTTP 200 OK, jeśli połączenie z serwerem się powiedzie, i dołączy treść z wiadomością z odpowiedzią wskazującą, czy aktualizacje zostały zastosowane prawidłowo, czy wystąpiły ostrzeżenia lub błędy. Jeśli Google odpowie kodem błędu HTTP, wyślij wiadomość ponownie. Jeśli treść odpowiedzi HTTP zawiera ostrzeżenia lub błędy, należy je naprawić przed ponownym wysłaniem wiadomości. Problemy napotkane w przypadku konkretnych wiadomości możesz też wyświetlić na stronie Stan pliku danych w Hotel Center.

Wyświetlanie w Google (LoG)

Live on Google (LoG) umożliwia wyświetlanie hoteli w witrynach Google. Domyślna wartość LoG dla hotelu to true, więc wszystkie nowe hotele będą automatycznie wyświetlane w Google.

Użyj LoG, aby włączać i wyłączać nieruchomości w reklamach i bezpłatnych linkach do rezerwacji na koncie Hotel Center, niezależnie od stanu Google Ads lub tego, czy nieruchomość ma ceny w Google.

Wartość LoG hotelu można ustawić na 2 sposoby: za pomocą parametru 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 o LoG znajdziesz w Centrum pomocy Hotel Center.

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

  • Sprawdź stan swoich obiektów 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 wartością liveOnGoogle = TRUE w punkcie końcowym hotelViews.list.

  • Aby uzyskać podsumowanie usług na określonym koncie, w tym liczbę usług aktywnych w Google, użyj parametru hotelViews.summary.

Więcej informacji o tym, jak ustawić LoG za pomocą interfejsu API, znajdziesz w hotelViews.listartykule i w dokumentacji API.