Oceń wiadomość

Omówienie

Wiadomość o stawce (OTA_HotelRateAmountNotifRQ) określa cenę za noc stawki obłożenia dla poszczególnych typów pokoju i abonamentów w określonym dniu zakresów. W ramach wiadomości ze stawką Google obsługuje ceny na podstawie obłożenia, dzięki czemu można określić różne stawki za noc na podstawie maksymalnej liczby zamierzonych użytkowników.

W poniższych sekcjach znajdziesz ogólne wskazówki, podstawowy przykład i instrukcje scenariusze, które pomogą Ci zacząć dodawać i aktualizować stawki oraz wysyłać Oceń wiadomość.

Działanie współczynnika dopasowania

Gdy użytkownicy zgłaszają zapotrzebowanie na określoną liczbę osób, stawka, którą widzą, zależy od tego, sposobu określania cen w wiadomości z cenami. Z tej sekcji dowiesz się, jak żądania użytkowników są dopasowywane do Twoich cen w zależności od ich liczby osób i określone stawki.

Najważniejsze zasady

  • Stawka zdefiniowana za określoną liczbę osób ma zastosowanie do wszystkich mniejszych gości. o ile nie określono inaczej.

  • Żądania dotyczące obłożenia powyżej określonych kryteriów są uznawane za niemożliwe.

  • Cena zależna od obłożenia dotyczy zarówno cen według dat, jak i cen opartych na LOS modeli cenowych opisanych poniżej. Oznacza to, że możesz określić stawkę liczba osób. Jeśli cena za określoną liczbę osób nie istnieje, cena za pobyt używane jest następne najwyższe obłożenie. Możesz też określić opłaty dodatkowych gości i dzieci korzystających z aplikacji AdditionalGuestAmounts lub ExtraGuestCharges która jest stosowana do pojemności określonej dla sali.

Korzyści i przykłady

Wydajność reakcji chemicznej

W przypadku wielu osób z tą samą ceną nie musisz ustawiać stawkę za każde miejsce. Możesz uprościć wiadomości, ustawiając tylko najwyższa wartość obłożenia obsługiwana przez typ pokoju i abonament. Użytkownicy będą widzieć tę stawkę w przypadku każdego obłożenia niższym lub równym ustalonemu .

Przykład: stawki za pokój i abonament są takie same w przypadku która jest w pokoju od jednego do czterech. Użyj wiadomości Stawka, aby ustawić jedną stawkę dla maksymalnej dla 4 osób. Użytkownicy szukający noclegu dla 1, 2 lub 3 osób odnotowujemy taki sam współczynnik. Użytkownicy, którzy wyszukują informacje o wartości 5 lub większej, nie zobaczą cen.

Kontrola

Możesz podać osobne stawki dla alternatywnych obłożenia. Wyślij inną stawkę dla każdej wartości obłożenia, jeśli chcesz mieć większą kontrolę nad tym, Google dopasowuje żądania do stawek za obłożenie.

Przykład: jeśli ceny są określone dla 3 i 1 osoby, oznacza to, że liczba osób w pokoju jest równa 1 i 1 osobom. wyszukiwania będzie podawać stawkę za nocleg, podwójna liczba osób może wzrosnąć trzykrotnie wyższy poziom obłożenia, a użytkownicy, którzy szukają dla niej 4 i więcej, nie zobaczą stawki.

Więcej przykładów różnych scenariuszy związanych z cenami znajdziesz na stronie Instrukcje.

Elementy wymagane i opcjonalne

Dokumentacja XML zawiera opisy elementów wymaganych i opcjonalnych. Więcej informacji: atrybutów i elementów podrzędnych. Patrz sekcja Elementy oceny i Atrybuty.

Składnia i schematy

Użyj składni stawki. jako przykład podczas tworzenia wiadomości z ceną, aby upewnić się, masz właściwy format.

Do weryfikacji plików danych możesz użyć narzędzia XML innej firmy, np. xmllint. opublikowane schematy przed przesłaniem do Google. W przypadku wiadomości Stawka (patrz schematy reklam hoteli).

Modele cenowe

Ceny według dat

To standardowy model cenowy stosowany w większości usług. per-date opiera się na ustalaniu cen, które są sumowane za okres pobytu uzyskać łączną cenę. W tym modelu wszystkie ceny w elemencie Rate są interpretowane jako mające zastosowanie do zakresu dat pobytu określonego w <StatusApplicationControl>

Ceny na podstawie LOS

Model cenowy oparty na LOS (długość pobytu) opiera się na stawkach za pobyt połączenie daty przyjazdu i długości pobytu. Stawki określone w Model cenowy oparty na LOS jest obliczany według dnia. Na przykład, jeśli przesyłasz stawkę 100 USD w przypadku pobytu obejmującego 3 zł łączna cena jest obliczana jako 3 x 100 zł=300 zł.

Możesz użyć modelu cenowego opartego na LOS, określając RatePlanType="26" w elementach StatusApplicationControl. Musisz także wykonać te czynności: ustaw atrybuty RateTimeUnit i UnitMultiplier w elementach Rate w Plik XML: Spowoduje to, że wszystkie ceny podane w ramach danego elementu Rate będą stosowane do pobytów. zdefiniowane przez daty przylotu określone w <StatusApplicationControl> oraz Wartość LOS określona dla UnitMultiplier.

W ramach jednej strategii możesz stosować modele cenowe zarówno na podstawie okresu, jak i na podstawie czasu rzeczywistego jednak każda usługa powinna używać tylko jednego modelu cenowego. Implementując ceny oparte na LOS, pamiętaj o następujących kwestiach:

  • Ceny za różne długości pobytu nie są łączone, jeśli korzystasz z LOS cen. Na przykład wskaźnik LOS równy 3 nie jest połączony z LOS równym 1, aby ustalić cenę LOS równą 4. Stawka LOS o wartości 4 musi być wyraźnie określona określone dane.
  • Stawka za 1 noc w cenie określonej na podstawie LOS nie jest używana jako cena indywidualna za nocleg według cennika.
  • Każda usługa powinna korzystać tylko z cen opartych na LOS lub według daty w zależności od tego, jak stawki są przedstawiane w Twoim systemie.

Aby włączyć na koncie ceny na podstawie LOS, wyślij prośbę w TAM lub skontaktuj się z nami.

Wytyczne lub działania

Ceny według dat

Delta: dodaj lub zaktualizuj stawki za obłożenie tylko w przypadku określonej liczby osób kombinacji typu pokoju, abonamentu i dat pobytu określonych w <StatusApplicationControl>

  • Aktualizowanie cen domyślnie używa działania Delta.
  • Aktualizacja Delta nie zmienia żadnych wcześniej zapisanych cen innych liczba osób. Na przykład: jeśli podajesz stawki dla pokoje dla 2 osób i wyślij zmianę ceny za pokój jednoosobowy (Delta) liczba osób w pokoju, stawka za podwójne obłożenie pozostaje bez zmian.

Overlay: usuń wszystkie istniejące stawki za obłożenie przypisane do typu pokoju. plan stawek i daty określone w <StatusApplicationControl>, a następnie zastąpić w nowych stawkach. Na przykład: jeśli podajesz stawki dla pokoje dwuosobowe i wysyłasz aktualizację Overlay dotyczącą 1 osoby pokoju, Google usunie wszystkie poprzednie ceny (zarówno pojedyncze, jak i dwuosobowe liczby osób) i po aktualizacji pozostanie tylko cena dla 1 osoby.

Remove: usuń wszystkie istniejące stawki za obłożenie przypisane do typu pokoju. plan stawek i daty podane w polu <StatusApplicationControl>.

Ceny na podstawie LOS

Delta: dodaj lub zaktualizuj stawki dla wartości długookresowej wartości klienta tylko w określonych przypadkach kombinacji typu pokoju, abonamentu i dat zameldowania określone w <StatusApplicationControl> Zastępuje wszystkie powiązane stawki za obłożenie ze zaktualizowanymi wartościami LOS.

  • Aktualizowanie cen domyślnie używa działania Delta.
  • Aktualizacja Delta nie zmienia żadnych wcześniej zapisanych cen innych długości pobytu. Jeśli na przykład określono stawki dla lotów 1 i 2, i wyślij Delta aktualizację stawki dla lotu 1 LOS, a potem stawki za liczbę osób w przypadku LOS 2 nie uległa zmianie.
  • Aktualizacja Delta zastępuje wszystkie wcześniej zapisane ceny za obłożenie dla danej długości. Na przykład, jeśli podasz jeden i stawki za podwójne obłożenie w przypadku lotu LOS 1 oraz wysłanie aktualizacji stawki Delta dla: LOS 1 jeśli określono stawkę za 1 osobę, cena podwójne obłożenie zostanie usunięta.

Overlay: usuń wszystkie istniejące stawki za obłożenie związane z rezerwacją sali konferencyjnej. typ, plan stawek i daty zameldowania podane w polu <StatusApplicationControl> i zastąpić je nowymi stawkami. Na przykład, jeśli podasz stawki za w zakresie LOS 1 i 2 oraz wyślesz aktualizację Overlay dla LOS 1, Google usunie wszystkie poprzednie stawki (LOS 1 i 2) oraz tylko stawka LOS 1 po aktualizacji.

Remove: usuń wszystkie istniejące stawki za obłożenie dla wszystkich lotów typu pokoju, abonamentu i dat zameldowania <StatusApplicationControl>

Związane z podatkami

Jeśli podatki i opłaty są proste, łączną kwotę można określić za pomocą funkcji AmountAfterTax złożone podatki, takie jak podatki i opłaty, AmountAfterTax nie przedstawia pobytu (a nie za noc).

Ogólnie rzecz biorąc, Google zaleca korzystanie z narzędzia TaxFeeInfo zamiast AmountAfterTax

Jeśli to możliwe, dodaj atrybut AmountBeforeTax (nawet jeśli określisz AmountAfterTax), ponieważ w niektórych regionach (np. w USA) wyświetlany jest parametr cenę przed naliczeniem podatku.

Wszystkie podatki i opłaty, które musi zapłacić użytkownik (VAT, podatek za pobyt, opłaty za sprzątanie, miasto podatku itp.), należy uwzględnić, nawet jeśli nie został on opłacony w momencie rezerwacji lub nie bezpośrednio na rzecz nieruchomości.

Przykład

W tej sekcji znajdziesz podstawowy przykład zastosowania stawki z użyciem wymaganych i opcjonalnych elementów. Po przygotowaniu pliku musisz go wysłać do Google za pomocą wiadomość POST do tego punktu końcowego: https://www.google.com/travel/hotels/uploads/property_data

Aby dowiedzieć się więcej o wysyłaniu i POSTĘPowaniu wiadomości, zapoznaj się z tym artykułem.

W przypadku HotelCode użyj unikalnego identyfikatora hotelu użytego w systemie do identyfikacji usługi. Ta wartość musi pasować do identyfikatora hotelu określonego za pomocą atrybutu <id> w elemencie <listing> w pliku danych z listą hoteli. W przypadku usług <PackageID> i <RoomID> użyj tych samych identyfikatorów co używać w swoim systemie do planowania stawek i typów pokoi. Spójność z Twoim systemem, jest kluczowe dla prawidłowego wyświetlania cen i danych.

Ten przykład pokazuje, jak określić ceny 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

Ta sekcja zawiera rozwiązania scenariuszy, które mogą wystąpić podczas wysyłania Oceniaj wiadomości.

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

Scenariusz 1. Jak zmienić ceny za liczbę osób

Opis

Ceny za noc były wcześniej określone tylko dla 2 osób (których dotyczy jednej osoby), ale teraz dostępna jest tańsza cena za pobyt jednoosobowy. liczba osób.

Rozwiązanie

Wyślij nową stawkę za obłożenie 1, korzystając z domyślnej aktualizacji zakresu Delta. Ten nowy Nie ma wpływu na stawkę za obłożenie 2.

Scenariusz 2. Jak zastąpić stawki za obłożenie w przypadku obiektu

Opis

Wcześniej zostały przez Ciebie określone stawki dla 1–4 osób, ale teraz tylko liczba osób 1 i 2 jest prawidłowa.

Rozwiązanie

Użyj elementu NotifType="Overlay", aby zastąpić wszystkie stawki za obłożenie w danym obiekcie. typ pokoju, abonament i daty. W tym scenariuszu działanie Overlay spowodowałoby listy stawek dla obłożenia 1 i 2.

Scenariusz 3. Jak ustawić tę samą cenę dla wielu osób

Opis

Stawka za określoną liczbę osób może zostać sprzedana grupie z mniejszą liczbą osób. W tym w tym scenariuszu, możesz uprościć swoje wiadomości, wysyłając tylko aktualizację ceny dla Maksymalna liczba osób.

Rozwiązanie

Jeśli masz tę samą cenę dla kilku osób, ustaw najwyższą liczbę osób. jest obsługiwaną przez typ pokoju i abonament. Automatycznie wykorzystuje tę wartość do obsługi mniejszej liczby osób. Oznacza to, że nie trzeba powtarzać tego samego cena za noc w przypadku osób 1–6, jeśli są takie same; Ustawiam na 6.