ARI – omówienie

Dostępność, stawki i zasoby reklamowe (ARI) to tryb dostarczania 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 przeciwieństwie do form dostawy, metod pobierania i zmian cen, pliki danych ARI nie są przeszukiwane pod kątem konkretnych cen ani planów podróży. Zamiast tego wysyłaj wiadomości push, gdy w Twoim modelu cenowym pojawią się nowe dane lub zmienią się dane, które już masz, np. szczegóły stawek, ograniczenia i dostępność.

Zalety

ARI zapewnia te korzyści:

  • Skuteczne wykorzystanie przepustowości: zwiększa efektywność wykorzystania przepustowości przez ograniczenie ilości danych, które muszą zostać przesłane. Dzięki temu, że dane ARI są wysyłane codziennie, a zmiany są tylko przyrostowe, Google może obliczać ceny i aktualizacje dla szerokiego zakresu wartości długości pobytu i czasu rezerwacji.

  • Zgodność cen: zwiększa zgodność cen dzięki modelowi push-on-change, który umożliwia aktualizowanie cen w czasie rzeczywistym.

  • Większy zasięg cen: osiąga większy zasięg cen (liczbę planów podróży z cenami) dzięki korzystaniu z danych szczegółowych, które są łączone w różne plany podróży.

  • Elastyczność: zapewnia większą elastyczność w oferowaniu promocji i pakietów.

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

Typy żądań

Wiadomości ARI wysyłane do Google są nazywane „żądaniami” ARI. Google zwraca następnie komunikaty „response” (odpowiedź), które wskazują na powodzenie lub niepowodzenie.

ARI stosuje standardowe protokoły OpenTravel Alliance (OTA) w przypadku niektórych głównych typów wiadomości, aby określić dostępność i zasoby reklamowe.

<OTA_HotelRateAmountNotifRQ>

ARI używa tych komunikatów z prośbą:

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

  • OTA_HotelRateAmountNotifRQ Określa stawki za pobyt na podstawie daty lub LOS za poszczególne produkty (kombinacja typu pokoju i abonamentu) w określonych zakresach dat.

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

  • OTA_HotelInvCountNotifRQ. Określa liczbę pokoi dostępnych do sprzedaży.

  • TaxFeeInfo (opcjonalnie) – definiuje podatki i opłaty za poszczególne usługi. Ta wiadomość nie jest wymagana, jeśli w wiadomości OTA_HotelRateAmountNotifRQ podano wartość AmountAfterTax.

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

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

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

Więcej informacji o interfejsie ARI znajdziesz w dokumentacji XML.

Komunikaty push

Aby zaktualizować informacje o ARI i usłudze, wyślij powiązane wiadomości, gdy tylko dane w Twoim systemie ulegną zmianie.

Podczas wysyłania wiadomości przestrzegaj tych wskazówek:

  • Aby dodać lub zaktualizować adresy IP w naszym systemie, użyj narzędzia samoobsługowego na stronie Ustawienia cen w Hotel Center.

  • Użyj tego ś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.

  • Maksymalna częstotliwość aktualizacji na poziomie konta wynosi 400 wiadomości na sekundę. Jeśli przekroczysz ten limit, zwrócony zostanie kod błędu 6032.

  • W zależności od aktualizowanych danych użyj jednej 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 odpowie HTTP 200 OK, jeśli połączenie z serwerem się powiedzie, oraz dołączy treść wiadomości z odpowiedzią, która wskaże, czy aktualizacje zostały zastosowane, czy wystąpiły ostrzeżenia lub błędy. Jeśli Google odpowie z kodem błędu HTTP, ponownie wyślij wiadomość. Jeśli treść odpowiedzi HTTP zawiera ostrzeżenia lub błędy, należy je naprawić przed ponownym wysłaniem wiadomości. Problemy dotyczące konkretnych wiadomości możesz też wyświetlić na stronie Stan pliku danych w Hotel Center.

Na żywo w Google (NaŻ)

Usługa Live on Google (LoG) umożliwia wyświetlanie informacji o hotelach w witrynach Google. Ponieważ domyślna wartość LoG dla hotelu to true, wszystkie nowe hotele będą automatycznie wyświetlane w Google.

Używaj LoG, aby włączać i wyłączać swoje obiekty w reklamach i bezpłatnych linkach do rezerwacji na koncie Hotel Center niezależnie od stanu konta Google Ads lub tego, czy obiekt ma ceny w Google.

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

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

  • Stan swoich obiektów możesz sprawdzić w Hotel Center lub za pomocą 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 danym koncie, w tym liczby usług dostępnych w Google, użyj polecenia hotelViews.summary.

Więcej informacji o ustawianiu logowania za pomocą interfejsu API znajdziesz w artykule hotelViews.list i w dokumentacji interfejsu API.