ARI – omówienie

Dostępność, stawki i zasoby reklamowe (ARI) to tryb cen, który kontroluje stawki za noc, dostępność i zasoby reklamowe oraz ogranicza sposoby ich łączenia. ARI umożliwia też elastyczne uwzględnianie podatków, opłat i promocji.

W przeciwieństwie do trybów dostawy opartych na cenach uwzględnianych w planie podróży, pobierania lub zmiany cen pliki danych ARI nie są wysyłane w przypadku określonych cen ani planów podróży. Zamiast tego wysyłasz wiadomości, gdy model cenowy zawiera nowe lub zmienione dane, takie jak zmiany szczegółów stawki, ograniczeń czy dostępności.

Zalety

System ARI zapewnia następujące korzyści:

  • Efektywność przepustowości: zwiększa wydajność przepustowości przez zmniejszenie ilości danych do przesłania. Wysyłając nocne dane ARI i jedynie przyrostowe zmiany, Google może obliczać ceny i aktualizacje dla szerokiego zakresu wartości związanych z wcześniejszymi zakupami i długością pobytu.

  • Dokładność cen: poprawia dokładność cen dzięki użyciu modelu zdarzeń push w momencie zmiany w celu przekazywania aktualizacji na żywo.

  • Większy zasięg cen: większy zasięg podróży (liczba planów podróży z cenami) dzięki wykorzystaniu szczegółowych danych połączonych w różne plany podróży.

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

  • Łatwość obsługi: dane są przesyłane w sposób dopasowany do sposobu ich przechowywania w systemie, co eliminuje konieczność obliczania cen i buforowania cen dla wielu planów podróży.

Typy wiadomości z prośbami

Wiadomości ARI wysyłane do Google są nazywane komunikatami „żądania” ARI. Następnie Google zwraca komunikat „odpowiedź” z informacją o powodzeniu lub niepowodzeniu.

W przypadku niektórych głównych typów wiadomości ARI jest zgodna ze standardowymi protokołami OpenTravel Alliance (OTA) i określa dostępność i zasoby reklamowe.

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

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

  • OTA_HotelRateAmountNotifRQ. Określa kwoty obłożenia według daty lub na podstawie LOS na produkt (kombinację typu pokoju i abonamentu) w określonych zakresach dat.

  • OTA_HotelAvailNotifRQ. Określa dostępność i ograniczenia na podstawie typu pokoju i abonamentów. Zasoby reklamowe można też aktualizować za pomocą tego komunikatu, ale preferowany jest parametr OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ. Określa asortyment sal lub liczbę pomieszczeń dostępnych do sprzedaży.

  • TaxFeeInfo. (Opcjonalnie) Określa podatki i opłaty dla poszczególnych obiektów. Ta wiadomość nie jest wymagana, jeśli w wiadomości OTA_HotelRateAmountNotifRQ określono AmountAfterTax.

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

  • RateModifications. (Opcjonalnie) Określa zasady zmiany stawek w przypadku określonych rezerwacji, pobytów i użytkowników.

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

Każda wiadomość zawiera podzbiór informacji, które Google wykorzystuje do obliczania cen i dostępności wyświetlanych użytkownikom szukającym Twoich miejsc zakwaterowania, z określonymi datami zameldowania i wymeldowania oraz liczbą osób.

Więcej informacji o ARI znajdziesz w dokumentacji XML.

Komunikaty push

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

Podczas wysyłania wiadomości postępuj zgodnie z tymi wytycznymi:

  • Użyj samoobsługowego narzędzia na stronie ustawień cen w Hotel Center, aby dodać lub zaktualizować adresy IP w naszym systemie.

  • Użyj tej ścieżki podstawowej 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, która wynosi 400 wiadomości na sekundę. Jeśli przekroczysz ten limit, zwracany jest kod błędu 6032.

  • W zależności od danych, które chcesz zaktualizować, użyj 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

Jeśli udało się nawiązać połączenie z serwerem, Google wysyła w odpowiedzi wiadomość HTTP 200 OK z treścią wiadomości z informacją o tym, czy aktualizacje zostały zastosowane, czy wystąpiły ostrzeżenia lub błędy. Jeśli w odpowiedzi Google przekaże kod 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, które wystąpiły w przypadku konkretnych komunikatów, możesz też wyświetlić na stronie Stan pliku danych w Hotel Center.

Transmisje na żywo w Google (LoG)

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

Za pomocą LoG możesz włączać i wyłączać miejsca zakwaterowania w przypadku reklam oraz bezpłatnych linków do rezerwacji na koncie Hotel Center niezależnie od stanu w Google Ads i tego, czy obiekt ma ceny w Google. Dotyczy to tylko hoteli, a nie kwater wakacyjnych.

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:

  • Wyświetl stan miejsc zakwaterowania w Hotel Center lub w punkcie końcowym hotelViews.list.

  • Pobierz listę wszystkich swoich hoteli wyświetlanych w Google za pomocą parametru filter z parametrem liveOnGoogle = TRUE w punkcie końcowym hotelViews.list.

  • Pobierz za pomocą hotelViews.summary podsumowanie usług dla określonego konta, w tym liczbę usług aktywnych w Google.

Więcej informacji o ustawianiu LoG za pomocą interfejsu API znajdziesz w hotelViews.listartykule i dokumentacji interfejsu API.