Oceń wiadomość

Przegląd

Wiadomość Rate (OTA_HotelRateAmountNotifRQ) określa stawki za noc w przypadku każdej kombinacji typu pokoju i planu cenowego w określonych zakresach dat. W ramach wiadomości o stawce Google obsługuje ceny zależne od obłożenia, co umożliwia określanie różnych stawek za noc w zależności od maksymalnej liczby planowanych gości.

W kolejnych sekcjach znajdziesz ogólne wytyczne, podstawowy przykład oraz scenariusze, które pomogą Ci zacząć dodawać i aktualizować stawki oraz wysyłać wiadomość o stawkach.

Działanie współczynnika dopasowania

Gdy użytkownicy wysyłają prośby o określoną liczbę osób, wyświetlana cena zależy od tego, jak zdefiniujesz ceny w wiadomości o stawkach. Z tej sekcji dowiesz się, jak te żądania użytkowników są dopasowywane do Twoich cen w zależności od obłożenia w żądaniu i określonych przez Ciebie cen.

Kluczowe zasady

  • Stawka określona dla konkretnego obłożenia dotyczy wszystkich mniejszych obłożeń, chyba że określono inaczej.

  • Żądania dotyczące liczby osób powyżej zdefiniowanych wartości są uznawane za niemożliwe.

  • Ceny oparte na obłożeniu dotyczą zarówno cen za datę, jak i cen opartych na długości pobytu, które opisujemy poniżej. Oznacza to, że możesz określić stawki dla każdego poziomu obłożenia. Jeśli stawka dla określonej liczby osób nie istnieje, używana jest stawka dla następnej wyższej liczby osób. Możesz też określić opłaty za dodatkowych gości i dzieci za pomocą elementów AdditionalGuestAmounts lub ExtraGuestCharges, które są stosowane do maksymalnej liczby osób określonej dla pokoju.

    .

Korzyści i przykłady

Wydajność reakcji chemicznej

W przypadku wielu rodzajów obłożenia o tej samej kwocie stawki nie musisz ustawiać stawki dla każdego rodzaju obłożenia. Możesz uprościć wiadomości, ustawiając tylko najwyższą wartość obłożenia obsługiwaną przez typ pokoju i abonament. Użytkownicy zobaczą tę stawkę dla każdego obłożenia mniejszego lub równego ustawionej wartości.

Przykład: stawki za typ pokoju i plan cenowy są takie same w przypadku 1–4 osób. Użyj wiadomości Rate, aby ustawić jedną stawkę dla maksymalnej liczby osób (4). Użytkownicy wyszukujący pobyt 1-, 2- i 3-osobowy zobaczą tę samą cenę. Użytkownicy, którzy szukają ocen 5 i wyższych, nie zobaczą stawek.

Kontrola

Możesz podać wyraźnie różne stawki dla alternatywnych obłożeń. Wysyłaj różne stawki dla każdej wartości zajętości, jeśli chcesz mieć większą kontrolę nad tym, jak Google dopasowuje żądania do stawek za zajętość.

Przykład: jeśli ceny są zdefiniowane dla 3 osób i 1 osoby, w przypadku wyszukiwania pobytu dla 1 osoby wyświetli się cena za pobyt 1-osobowy, w przypadku wyszukiwania pobytu dla 2 osób wyświetli się cena za pobyt 3-osobowy, a użytkownicy wyszukujący pobyt dla 4 osób i większej liczby osób nie zobaczą cen.

Więcej przykładów różnych scenariuszy związanych ze stawkami znajdziesz w sekcji Instrukcje.

Elementy wymagane i opcjonalne

W dokumentacji XML znajdziesz opisy elementów wymaganych i opcjonalnych. Szczegółowe informacje o atrybutach i elementach podrzędnych znajdziesz w artykule Elementy i atrybuty stawki.

Składnia i schematy

Podczas tworzenia wiadomości z oceną korzystaj z przykładu składni oceny, aby mieć pewność, że używasz prawidłowego formatu.

Przed przesłaniem plików danych do Google możesz sprawdzić je za pomocą narzędzia XML innej firmy, np. xmllint. Informacje o schemacie wiadomości o cenie znajdziesz w artykule Schematy reklam hoteli.

Modele cenowe

Ceny za dzień

Jest to standardowy model cenowy stosowany w przypadku większości usług. Model cenowy per-date opiera się na ustalaniu stawek, które są sumowane w okresie pobytu, aby uzyskać cenę całkowitą. W tym modelu wszystkie stawki w elemencie Rate są interpretowane jako obowiązujące w zakresie dat pobytu określonym w elemencie <StatusApplicationControl>.

Ceny zależne od długości pobytu

Model cenowy oparty na długości pobytu (LOS) jest oparty na stawkach ustalonych dla kombinacji daty przyjazdu i długości pobytu. Stawki określone w ramach modelu cenowego opartego na długości pobytu są stawkami dziennymi. Jeśli na przykład wyślesz cenę 100 USD za pobyt trwający 3 dni, łączna cena zostanie obliczona jako 3 x 100 USD=300 USD.

Możesz skorzystać z modelu cenowego opartego na długości pobytu, określając RatePlanType="26" w elementach StatusApplicationControl. Musisz też ustawić atrybuty RateTimeUnit i UnitMultiplier w elementach Rate w pliku XML. Powoduje to, że wszystkie stawki w danym elemencie Rate mają zastosowanie do pobytów określonych przez daty przyjazdu podane w <StatusApplicationControl> i wartość LOS określoną dla UnitMultiplier.

Na jednym koncie możesz korzystać z modeli cenowych opartych na dacie i długości pobytu, ale każda nieruchomość powinna używać tylko jednego modelu cenowego. Podczas wdrażania cen na podstawie długości pobytu pamiętaj o tych kwestiach:

  • W przypadku cen opartych na długości pobytu stawki za różne długości pobytu nie są łączone. Na przykład stawka LOS 3 nie jest łączona ze stawką LOS 1 w celu ustalenia ceny stawki LOS 4. Musisz wyraźnie określić stawkę LOS wynoszącą 4.
  • Cena za 1 noc w przypadku cen opartych na długości pobytu nie jest używana jako cena za poszczególne noce w przypadku cen za datę.
  • Każda usługa powinna korzystać tylko z ceny opartej na długości pobytu lub ceny za dzień, w zależności od tego, jak stawki są przedstawione w Twoim systemie.

Aby włączyć na swoim koncie ceny oparte na LOS, prześlij prośbę za pomocą TAM lub skontaktuj się z nami.

Wytyczne lub działania

Ceny za dzień

Delta: dodaj lub zaktualizuj stawki za osobę tylko w przypadku określonych kombinacji typu pokoju, planu cenowego i dat pobytu podanych w <StatusApplicationControl>.

  • Aktualizacje stawek domyślnie korzystają z działania Delta.
  • Aktualizacja Delta nie zmienia żadnych wcześniej zapisanych stawek dla innych obłożeń. Jeśli na przykład masz określone ceny za pokoje jednoosobowe i dwuosobowe i wyślesz Delta aktualizację ceny za pokój jednoosobowy, cena za pokój dwuosobowy pozostanie bez zmian.

Overlay: usuń wszystkie dotychczasowe stawki za pobyt w przypadku typu pokoju, planu cenowego i dat określonych w <StatusApplicationControl> i zastąp je nowymi stawkami. Jeśli na przykład masz określone ceny za pokoje jednoosobowe i dwuosobowe, a wyślesz aktualizację Overlay dla pokoju jednoosobowego, Google usunie wszystkie poprzednie ceny (zarówno za pokoje jednoosobowe, jak i dwuosobowe), a po aktualizacji pozostanie tylko cena za pokój jednoosobowy.

Remove: usuń wszystkie dotychczasowe stawki za osobę dla typu pokoju, planu cenowego i dat określonych w <StatusApplicationControl>.

Ceny zależne od długości pobytu

Delta: dodaj lub zaktualizuj stawki dla każdej wartości LOS tylko w przypadku określonych kombinacji typu pokoju, planu cenowego i dat zameldowania podanych w <StatusApplicationControl>. Zastępuje wszystkie stawki za pobyt związane ze zaktualizowanymi wartościami długości pobytu.

  • Aktualizacje stawek domyślnie korzystają z działania Delta.
  • Aktualizacja Delta nie zmienia żadnych wcześniej zapisanych stawek za inne długości pobytu. Jeśli na przykład masz określone stawki za długość pobytu 1 i 2 i wyślesz Delta aktualizację stawki za długość pobytu 1, stawki za długość pobytu 2 za osobę pozostaną bez zmian.
  • Aktualizacja Delta zastępuje wszystkie wcześniej zapisane stawki za pobyt dla danej długości pobytu. Jeśli na przykład masz określone ceny za pobyt 1 osoby i 2 osób w przypadku długości pobytu 1 i wyślesz aktualizację ceny Delta dla długości pobytu 1 tylko z ceną za pobyt 1 osoby, cena za pobyt 2 osób zostanie usunięta.

Overlay: usuń wszystkie dotychczasowe stawki za pobyt dla długości pobytu, typu pokoju, planu cenowego i dat zameldowania określonych w <StatusApplicationControl> i zastąp je nowymi stawkami. Jeśli na przykład masz określone stawki dla LOS 1 i 2, a wyślesz aktualizację Overlay dla LOS 1, Google usunie wszystkie poprzednie stawki (zarówno dla LOS 1, jak i 2), a po aktualizacji pozostanie tylko stawka dla LOS 1.

Remove: usuwa wszystkie dotychczasowe stawki za pokój dla wszystkich długości pobytu w przypadku typu pokoju, planu cenowego i dat zameldowania określonych w <StatusApplicationControl>.

Związane z podatkami

Jeśli podatki i opłaty są proste, łączną kwotę można określić za pomocą elementu AmountAfterTax. Złożone podatki, np. podatki i opłaty naliczane za pobyt (a nie za noc), nie mogą być reprezentowane w AmountAfterTax.

Ogólnie zalecamy używanie protokołu TaxFeeInfo zamiast AmountAfterTax.

Jeśli to możliwe, uwzględnij atrybut AmountBeforeTax (nawet jeśli określisz atrybut AmountAfterTax), ponieważ w niektórych regionach (np. w Stanach Zjednoczonych) domyślnie wyświetlana jest cena przed opodatkowaniem.

Należy uwzględnić wszystkie podatki i opłaty, które użytkownik musi zapłacić (podatek VAT, podatek pobytowy, opłaty za sprzątanie, podatek miejski itp.), nawet jeśli nie są one płacone w momencie rezerwacji lub nie są płacone bezpośrednio w obiekcie.

Przykład

W tej sekcji znajdziesz podstawowy przykład wiadomości z prośbą o ocenę, która zawiera elementy wymagane i opcjonalne. Po przygotowaniu pliku musisz wysłać go do Google za pomocą wiadomości POST do tego punktu końcowego: https://www.google.com/travel/hotels/uploads/property_data

Więcej informacji o wysyłaniu wiadomości metodą push/POST znajdziesz w artykule Wysyłanie wiadomości.

W przypadku HotelCode użyj unikalnego identyfikatora hotelu, którego używasz w systemie do identyfikacji obiektu. Ta wartość musi być zgodna z identyfikatorem hotelu określonym za pomocą <id> w elemencie <listing> w pliku danych z listą hoteli. W przypadku atrybutów <PackageID> i <RoomID> użyj tych samych identyfikatorów, których używasz w swoim systemie w przypadku planów cenowych i rodzajów pokoi (odpowiednio). Spójność z Twoim systemem ma kluczowe znaczenie dla prawidłowego wyświetlania cen i danych w Google.

Ten przykład pokazuje, jak ustawić stawki za pomocą działania Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Instrukcje

W tej sekcji znajdziesz rozwiązania problemów, które mogą wystąpić podczas wysyłania wiadomości z oceną.

Przykłady dodawania, usuwania i aktualizowania stawek znajdziesz w sekcji Przykłady stawek.

Scenariusz 1. Jak zmienić cenę za osobę

Opis

Ceny za noc były wcześniej określane tylko dla pokoju dwuosobowego (co dotyczyło też pokoju jednoosobowego), ale teraz jest dostępna niższa cena za pokój jednoosobowy.

Rozwiązanie

Wyślij nową stawkę 1 za zajętość za pomocą domyślnej aktualizacji w zakresie Delta. Ta nowa wartość nie ma wpływu na współczynnik zajętości 2.

Scenariusz 2. Jak zastąpić stawki za pobyt w przypadku obiektu

Opis

Wcześniej zdefiniowano stawki dla 1–4 osób, ale teraz tylko 1–2 osoby są prawidłowe.

Rozwiązanie

Użyj NotifType="Overlay", aby zastąpić wszystkie stawki obłożenia dla danego obiektu, typu pokoju, planu cenowego i dat. W tym scenariuszu działanie Overlay wyświetli stawki dla zajętości 1 i 2.

Scenariusz 3. Jak ustawić tę samą stawkę dla różnych obłożeń

Opis

Stawkę za określone obłożenie można sprzedać grupie z mniejszą liczbą osób. W takim przypadku możesz uprościć wiadomości, wysyłając tylko aktualizację ceny dla maksymalnego obłożenia.

Rozwiązanie

Jeśli masz tę samą cenę dla wielu rodzajów obłożenia, ustaw najwyższą wartość obłożenia obsługiwaną przez typ pokoju i plan cenowy, a system automatycznie użyje tej wartości dla mniejszego obłożenia. Oznacza to, że nie musisz powtarzać tej samej ceny za noc dla liczby osób od 1 do 6, jeśli jest ona taka sama. Wystarczy, że ustawisz ją dla 6 osób.