本頁面由 Cloud Translation API 翻譯而成。

條件式費率

條件式費率是一種費率規範，可用來提供不同的費率根據使用者裝置、國家/地區或無論使用者是否已登入 Google 帳戶

如果行程具有多個公開或條件式費率，或是「房型套裝組合」會顯示最低價。Google 一律會選擇最低值符合資格的費率

總覽

條件式費率會顯示在標準價格版位中，且只會顯示向使用者搜尋內容符合相關條件式費率條件的使用者。這些條件的判斷依據如下：

如要啟用條件式費率，請修改下列項目：

費率規範 XML 檔案：定義套用條件式費率的條件，
價格動態饋給：使用 <Rate> 元素來設定費率。
到達網頁檔案：新增費率規範的專屬價值。

裝置專屬的條件式費率

裝置專屬費率是指，只有符合下列條件者才能查看並預訂的飯店房價：行動裝置、平板電腦或桌機等特定裝置的使用者。費率如下：使用者也能查看並預訂網站上的裝置專屬費率。

fenced_rates

特定國家/地區的條件式費率

特定國家/地區專屬費率是指僅供瀏覽且可預訂的飯店房價由使用者搜尋特定國家/地區的飯店時觸發。Google 敬上會根據使用者的 IP 位址來判斷國家/地區。已提供房價使用者瀏覽及預訂相同的國家/地區版本費率。

各語言的條件式費率

只有搜尋飯店的使用者才會看到特定語言的費率使用特定 Google 語言設定時特定語言條件是使用 <LanguageCode> 元素定義。

降低取樣條件式費率

只有一部分的隨機子集才能查看縮減的條件式費率符合資格的使用者。取樣率是使用 <MaxUsersPercent> 定義元素，並透過下列程式碼計算：

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

登入的條件式費率

只有登入 Google 服務的使用者才能查看登入費率讓他們使用服務帳戶Google 的合作夥伴提供房價，使用者可查看並預訂在合作夥伴自家網站上刊登費率登入費率是使用 <UserSignedIn> 元素。

由於設有條件式費率，Google 一律會選擇符合資格的最低費率高於 <Result> 層級設定的價格，則條件式費率則一律不會選取為避免這種情況發生，請將 <Result>時的比率以及設定條件的所有費率此外，您也可以請客戶技術顧問協助。針對在 <Result> 層級設定的價格使用預設費率規範。

建立費率規範 XML 檔案

條件式費率的費率規範是以費率規範 XML 檔案定義。適用對象詳情請參閱費率規範 XML 參考資料。

更新價格動態饋給

如要設定條件式費率，請使用交易訊息：

<Rate> 元素也可做為 <Rates> 的多個子元素使用 <RoomBundle> 或 <Result> 元素內。做為條件式使用費率，您必須將 rate_rule_id 屬性的值設為您在費率規範 XML 檔案中定義的費率規範 ID。

如果沒有預設的公開雙人入住費率，請設定 <Baserate> 傳送至 -1 的 <Result> 訊息子元素。任何條件式在此情況下，傳送給 Google 的 <Rates> 將視為有效。

範例

底座 + 條件式

以下範例顯示包含基本原則的 Transaction 訊息費率和條件式費率：

<?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 單人

以下範例顯示包含 1 低於 <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 多個

以下範例顯示包含多個低於 <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>

無公共雙人房

以下範例顯示包含下列內容的「交易」訊息： 無公共雙人入住費率的條件式費率：

<?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>

更新到達網頁檔案

確保符合資格的使用者可透過深入連結，請修改您的到達網頁檔案。其他實作方式你可能也需要在預訂網站上正確顯示折扣費率

我們希望合作夥伴採用條件式費率深層連結中顯示的價格。

在動態深層連結中，您可以使用費率規範的名稱、名稱、 <RateRule> 元素的 id 屬性，搭配 RATE-RULE-ID 變數。

以下範例會新增費率規範 ID：

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)

到達網頁檔案也支援可讓您使用的 IF-RATE-RULE-ID 指令你在套用費率規範之後已存在：

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)

本例將根據房價規則 ID。

詳情請參閱使用變數和條件。