Ta strona została przetłumaczona przez Cloud Translation API.

Stawki warunkowe

Ceny warunkowe to rodzaj reguły dotyczącej cen, która umożliwia Ci oferowanie różnych cen w przypadku planów podróży na podstawie takich kryteriów jak urządzenie użytkownika, kraj lub to, czy użytkownik zalogował się w Google.

Jeśli masz więcej niż 1 cenę publiczną lub warunkową w przypadku planu podróży lub pakietu pokoi, użytkownik zobaczy najniższą z nich. Google zawsze wybiera najniższą możliwą cenę dla użytkownika.

Opis

Ceny warunkowe są widoczne w standardowych przedziałach cenowych i wyświetlane tylko użytkownikom, których wyszukiwania spełniają kryteria powiązanej ceny warunkowej. Mogą one być oparte na tych kryteriach:

Aby włączyć ceny warunkowe, zmień te elementy:

Plik XML z regułami dotyczącymi cen: określ warunki, w jakich stosowane są ceny warunkowe.
Plik danych o cenach: aby ustawić stawki, użyj elementu <Rate> w wiadomości dotyczącej transakcji.
Plik strony docelowej: dodaj do precyzyjnych linków wartości związane z regułami dotyczącymi stawek.

Stawki warunkowe dotyczące urządzeń

Ceny według urządzenia to ceny hotelowe, które są widoczne i dostępne do zarezerwowania tylko przez użytkowników korzystających z określonego urządzenia, np. telefonu komórkowego, tabletu lub komputera. Stawki te są podawane przez partnerów Google, a użytkownicy mogą przeglądać i rezerwować te same ceny dla poszczególnych urządzeń w witrynie partnera.

fenced_rates

Ceny warunkowe obowiązujące w poszczególnych krajach

Stawki obowiązujące w danym kraju to ceny za pokoje hotelowe, które są widoczne i dostępne do zarezerwowania tylko przez użytkowników szukających hoteli w konkretnym kraju. Google określa kraj na podstawie adresu IP użytkownika. Stawki są dostarczane przez partnerów Google, a użytkownicy mogą zobaczyć i zarezerwować te same stawki obowiązujące w danym kraju na stronie partnera w konkretnym kraju.

Ceny warunkowe zależne od języka

Stawki w określonym języku są widoczne tylko dla użytkowników szukających hoteli, jeśli mają określone ustawienie języka w Google. Warunki dotyczące danego języka definiuje się za pomocą elementu <LanguageCode>.

Obniżone ceny warunkowe

Niespróbkowane ceny warunkowe są widoczne tylko dla losowego podzbioru wszystkich kwalifikujących się użytkowników. Częstotliwość próbkowania jest określana za pomocą elementu <MaxUsersPercent> i obliczana w ten sposób:

MaxUsersPercent = (number of users selected to view rate)/(total eligible users)

Ceny warunkowe po zalogowaniu

Współczynniki zalogowanych użytkowników są widoczne tylko dla użytkowników, którzy zalogowali się na konto Google. Stawki ustalają partnerzy Google, a użytkownicy mogą je wyświetlać i rezerwować na stronie partnera. Wskaźniki zalogowanych użytkowników są określane za pomocą elementu <UserSignedIn>.

Google zawsze wybiera najniższą kwalifikującą się stawkę, więc jeśli cena warunkowa jest wyższa niż cena ustawiona na poziomie <Result>, stawka warunkowa nigdy nie zostanie wybrana. Aby tego uniknąć, usuń stawkę na poziomie <Result> i warunku wszystkich stawek. Możesz też zapytać technicznego menedżera konta o użycie domyślnej reguły dotyczącej ceny dla cen ustawionych na poziomie <Result>.

Utwórz plik XML z regułami dotyczącymi cen

Reguły dotyczące cen warunkowych są definiowane za pomocą pliku XML z regułami ceny. Więcej informacji znajdziesz w dokumentacji XML reguł dotyczących stawek.

Aktualizowanie pliku danych z cenami

Stawki warunkowe ustawia się za pomocą elementu Komunikat o transakcji.

Elementu <Rate> można też używać jako wielu elementów podrzędnych elementu <Rates> w elementach <RoomBundle> lub <Result>. Aby użyć jej jako ceny warunkowej, ustaw wartość atrybutu rate_rule_id tak, by odpowiadała identyfikatorowi reguły ceny zdefiniowanym w pliku XML reguł dotyczących stawek.

Jeśli nie masz domyślnej publicznej wartości podwójnej obłożenia, ustaw element podrzędny <Baserate> komunikatu <Result> na -1. Wszystkie warunki <Rates> wysłane do Google w takim przypadku będą uznawane za prawidłowe.

Przykłady

Podstawowa + warunkowa

Ten przykład przedstawia komunikat o transakcji, który zawiera stawkę podstawową i stawkę warunkową:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>1</Nights>

    <Baserate currency="USD">200.00</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">1.00</OtherFees>

    <Rates>
      <!-- The rate_rule_id is required when using conditional rates -->
      <Rate rate_rule_id="mobile">
        <!-- Override base rate and taxes for conditional rates -->
        <Baserate currency="USD">180.00</Baserate>
        <Tax currency="USD">18.00</Tax>
        <!-- NOTE: OtherFees is inherited from the above setting -->
        <Custom1>ratecode123</Custom1>
      </Rate>
    </Rates>

  </Result>
</Transaction>

RoomBundle jeden

Ten przykład pokazuje komunikat o transakcji, który zawiera pojedynczą stawkę poniżej <RoomBundle>:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>2</Nights>

    <Baserate currency="USD">300.00</Baserate>
    <Tax currency="USD">30.00</Tax>
    <OtherFees currency="USD">2.00</OtherFees>

    <RoomBundle>
      <RoomID>single</RoomID>
      <Baserate currency="USD">300.00</Baserate>
      <Tax currency="USD">30.00</Tax>
      <OtherFees currency="USD">2.00</OtherFees>
    </RoomBundle>

    <RoomBundle>
      <RoomID>3</RoomID>  <!-- Links to data in metadata -->
      <RatePlanID>basic</RatePlanID>
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <ChargeCurrency>web</ChargeCurrency>
      <BreakfastIncluded>1</BreakfastIncluded>

      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">269.00</Baserate>
          <Tax currency="USD">2.69</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
        </Rates>
      </Rates>

    </RoomBundle>
  </Result>
</Transaction>

RoomBundle – wiele

Ten przykład pokazuje komunikat o transakcji, który zawiera wiele stawek w ramach <RoomBundle>:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>2</Nights>
    <!-- When Google receives new room bundle information for an itinerary, all
    previous room bundle pricing is dropped from Google's cache. Thus, if you
    want to delete a specific room bundle from Google's cache, you may do so
    by simply not providing that specific room bundle in subsequent transaction
    messages. -->
    <RoomBundle>
     ...
      <!-- RoomID is required, PackageID is recommended. -->
      <RoomID>5</RoomID>
      <PackageID>ABC</PackageID>
      <!-- Baserate is required. -->
      <Baserate currency="USD">275.00</Baserate>
      <Tax currency="USD">27.50</Tax>
      <OtherFees currency="USD">2.00</OtherFees>

      <!-- RatePlanID is optional and represents the unique identifier for a
      room and package data combination. We strongly recommend using RatePlanID
      as a variable to build your dynamic landing page (formerly Point of Sale)
      URL. For details, see Using Variables and Conditions. -->
      <RatePlanID>5-ABC</RatePlanID>

      <!-- Occupancy is mandatory for RoomBundle elements. -->
      <!-- Elements below will get inherited to nested rate elements. -->
      <Occupancy>2</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
      </OccupancyDetails>
      <InternetIncluded>1</InternetIncluded>


      <!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
      <ChargeCurrency>web</ChargeCurrency>
      <Custom1>ratebasic</Custom1>
      <!-- Neither rate overrides Custom2. -->
      <Custom2>ratebasic</Custom2>

      <Rates>
        <Rate rate_rule_id="mobile">
          <Baserate currency="USD">258.33</Baserate>
          <Tax currency="USD">25.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides ChargeCurrency from roombundle. -->
          <ChargeCurrency>hotel</ChargeCurrency>
          <!-- The value below overrides Custom1 from roombundle. -->
          <Custom1>ratecode321</Custom1>
          <!-- Custom2 is inherited from roombundle. -->
        </Rate>
        <Rate rate_rule_id="us_or_gb">
          <Baserate currency="USD">268.33</Baserate>
          <Tax currency="USD">26.83</Tax>
          <OtherFees currency="USD">1.00</OtherFees>
          <!-- The value below overrides Custom1 from roombundle. -->
          <Custom1>ratecode432</Custom1>
          <!-- Custom2 is inherited from roombundle. -->
        </Rate>
      </Rates>
    </RoomBundle>
  </Result>
</Transaction>

Brak ogólnodostępnych pokoi dla dwóch osób

Ten przykład przedstawia komunikat transakcji zawierający cenę warunkową bez publicznego poziomu podwójnego obłożenia:

<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">

  <Result>
    <Property>1234</Property>
    <Checkin>2023-04-10</Checkin>
    <Nights>1</Nights>

    <!-- <Unavailable/> should not be specified when available nested rates
    exist. -->
    <Baserate currency="USD">-1</Baserate>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>

    <Rates>
      <!-- The rate_rule_id is required when using conditional rates. -->
      <Rate rate_rule_id="mobile">
        <Baserate currency="USD">180.00</Baserate>
        <Tax currency="USD">18.00</Tax>
        <OtherFees currency="USD">1.00</OtherFees>
        <Custom1>ratecode123</Custom1>
      </Rate>
    </Rates>

  </Result>
</Transaction>

Zaktualizuj plik strony docelowej

Aby mieć pewność, że kwalifikujący się użytkownicy mogą zarezerwować obniżoną cenę za pomocą precyzyjnego linku, zmodyfikuj plik strony docelowej. Aby prawidłowo wyświetlać i wyświetlać obniżone stawki, może być też potrzebna dodatkowa implementacja na stronie rezerwacji.

Oczekujemy, że partnerzy będą uwzględniać cenę widoczną w przypadku precyzyjnego linku w przypadku ceny warunkowej.

W precyzyjnym linku dynamicznym możesz uwzględnić regułę dotyczącą ceny, podając jej nazwę, atrybut id elementu <RateRule>, ze zmienną RATE-RULE-ID.

Ten przykład dodaje identyfikator reguły dotyczącej ceny:

https://bookingsite.com/landing.do?id=(PARTNER-HOTEL-ID)&arrival=(CHECKINDAY)-(CHECKINMONTH)-(CHECKINYEAR)&departure=(CHECKOUTDAY)-(CHECKOUTMONTH)-(CHECKOUTYEAR)&lang=(USER-LANGUAGE)&currency=(USER-CURRENCY)&prid=(RATE-RULE-ID)

Plik strony docelowej obsługuje też dyrektywę IF-RATE-RULE-ID, która pozwala warunkowo definiować części adresu URL w zależności od tego, czy istnieje reguła dotycząca ceny:

https://bookingsite.com/(IF-RATE-RULE-ID)privatelanding.do(RATE-RULE-ID)(ELSE)landing.do(ENDIF)?id=(PARTNER-HOTEL-ID)&arrival=(CHECKINDAY)-(CHECKINMONTH)-(CHECKINYEAR)&departure=(CHECKOUTDAY)-(CHECKOUTMONTH)-(CHECKOUTYEAR)&lang=(USER-LANGUAGE)&currency=(USER-CURRENCY)

W tym przykładzie wybieramy 2 strony docelowe w zależności od tego, czy ustawiono identyfikator reguły dotyczącej stawek.

Więcej informacji znajdziesz w artykule Używanie zmiennych i warunków.