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

費率規範 XML 參考資料

費率規範 XML 檔案定義了提供條件式費率和不公開費率的規則。如要新增或編輯費率規範 XML 檔案，請使用 Hotel Center 的「費率規則」頁面。如要進一步瞭解條件式費率和不公開費率，請參閱「條件式和不公開費率」一文。

每個費率規範都需要 id，可在交易訊息的 <Rate> 中參照。參照費率規範 ID 的 <Rate> 只會在費率規範定義的條件下向使用者提供。您也可以使用到達網頁網址中的變數來參照費率規範 ID。

`<RateRuleSettings>`

費率規範 XML 檔案的根元素。<RateRuleSettings> (舊稱 <PrivateRates>) 元素包含：

<UserRateCondition> 元素會定義條件式和不公開費率的比對條件。例如，您可以建立符合特定國家/地區所有使用者條件的條件式費率。
<RateRule> 元素，每項元素都定義交易訊息中 <Rate> 參照的費率規範。每個 <RateRule> 都會指定建構條件式或不公開費率的條件和 UI 處理方式。

<RateRuleSettings> 元素會顯示在費率規範 XML 階層中的以下位置：

+ <RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

語法

<RateRuleSettings> 元素使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="some_id" op="[all|any|none]">
    ...
  </UserRateCondition>
  <!-- Required -->
  <RateRule id="rate_rule_id">
    <!-- Required -->
    <UserRateCondition op="[all|any|none]">
      ...
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

屬性

<RateRuleSettings> 元素不含任何屬性。

子元素

<RateRuleSettings> 元素包含下列子元素：

子項元素必填與否類型說明

子項元素	必填與否	類型	說明
`<RateRule>`	Required	`<RateRule>`	定義相符條件、修改項目和提供條件式/不公開費率的放送資格。必須提供 `id` 屬性，可在交易訊息的 `<Rate>` 或到達網頁網址中參照。
`<UserRateCondition>`	Optional	`<UserRateCondition>`	定義一或多個符合條件式或不公開費率的條件。您可以使用 `<UserRateCondition>` 子元素以內嵌方式定義條件，方法是使用 `reference_id` 屬性參照其他 `<UserRateCondition>` 元素，或是透過內嵌和參照方式定義條件。但是，任何含有 `reference_id` 的 `<UserRateCondition>` 都必須有 0 子項。 `<RateRuleSettings>` 下的頂層 `<UserRateCondition>` 必須含有 `id` 屬性。

<RateRule>

Required

<RateRule>

定義相符條件、修改項目和提供條件式/不公開費率的放送資格。必須提供 id 屬性，可在交易訊息的 <Rate> 或到達網頁網址中參照。

<UserRateCondition>

Optional

<UserRateCondition>

定義一或多個符合條件式或不公開費率的條件。

您可以使用 <UserRateCondition> 子元素以內嵌方式定義條件，方法是使用 reference_id 屬性參照其他 <UserRateCondition> 元素，或是透過內嵌和參照方式定義條件。但是，任何含有 reference_id 的 <UserRateCondition> 都必須有 0 子項。

<RateRuleSettings> 下的頂層 <UserRateCondition> 必須含有 id 屬性。

條件式費率範例

以下舉例說明定義條件式費率的基本方式。

建議您參照預先定義的條件，如「行動裝置使用者」範例所示。

行動使用者

以下條件式費率範例會參照預先定義的 <UserRateCondition>，定義符合所有行動裝置使用者的費率規範：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="mobile">
    <UserDeviceType>mobile</UserDeviceType>
  </UserRateCondition>
  <RateRule id="mobile">
    <!-- Referencing pre-defined conditions is recommended -->
    <UserRateCondition reference_id="mobile"/>
  </RateRule>
</RateRuleSettings>

美國使用者

以下條件式費率範例會參照預先定義的 <UserRateCondition>，定義費率規範，以比對在美國搜尋的所有使用者：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="us">
    <UserCountry>US</UserCountry>
  </UserRateCondition>
  <RateRule id="us">
    <UserRateCondition reference_id="us"/>
  </RateRule>
</RateRuleSettings>

`<RateRule>`

用來指定下列內容的容器：

提供費率的條件
修改費率的價格和使用者介面處理方式 (如果有的話)
針對不公開費率使用隱藏 UI 處理方式

<RateRule> 元素會顯示在費率規範 XML 階層中的以下位置：

+ 
<RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

語法

<RateRule> 元素使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
  <UserRateCondition ...>
  ...
  </UserRateCondition>
  <!-- At least one RateRule is required. The id attribute is required -->
  <RateRule id="rate_rule_id">
    <!-- One or more UserRateCondition elements (inline or referenced) are required. -->
    <UserRateCondition op="[all|any|none]"> // Inline example
      <Description>user_rate_condition_description</Description>
      <!-- Uses the member rate visible UI treatment -->
      <AlwaysEligibleMembershipProgram>program_name</AlwaysEligibleMembershipProgram>
      <LanguageCode>language_code</LanguageCode>
      <MaxUsersPercent>20</MaxUsersPercent> // 20% of users
      <!-- Requires <RateIneligibility> -->
      <MembershipProgram>program_name</MembershipProgram>
      <UserRateCondition reference_id="user_rate_condition_id"/>
      <UserCountry>country_code</UserCountry>
      <UserDeviceType>[mobile|desktop|tablet]</UserDeviceType>
      <UserListId>id</UserListId>
      <UserSignedIn>[true|false]</UserSignedIn>
      <IsDomestic>[true|false]</IsDomestic>
    </UserRateCondition>
    <RateIneligibility>
      <IneligibilityType>[exact|price_band|existence]</IneligibilityType>
      <IneligibilityReason>[program_member]</IneligibilityReason>
    </RateIneligibility>
    <RateModification>
      <HotelAmenity>[free_wifi]</HotelAmenity>
    </RateModification>
  </RateRule>
</RateRuleSettings>

屬性

<RateRule> 元素的屬性如下：

屬性必填與否類型說明

屬性	必填與否	類型	說明
`id`	必要	字串	費率規範的專屬 ID。系統會使用交易訊息中 `<Rate>` 的 `rate_rule_id` 屬性參照這個 ID，提供條件式或不公開費率。您也可以在到達網頁網址中使用變數和條件來參照費率規範 `id`。長度上限為 40 個半形字元。

id

必要

字串

費率規範的專屬 ID。系統會使用交易訊息中 <Rate> 的 rate_rule_id 屬性參照這個 ID，提供條件式或不公開費率。您也可以在到達網頁網址中使用變數和條件來參照費率規範 id。

長度上限為 40 個半形字元。

子元素

<RateRule> 元素包含下列子元素：

子項元素	必填與否	類型	說明
`<RateIneligibility>`	Optional	`<RateIneligibility>`	指定值，決定 `<MembershipProgram>` 率的特定 UI 處理方式。只有在 `<UserRateCondition>` 中指定 `<MembershipProgram>` 時才能使用。
`<UserRateCondition>`	Required	`<UserRateCondition>`	定義一或多個符合條件式或不公開費率的條件。您可以使用 `<UserRateCondition>` 子元素、使用 `reference_id` 屬性參照其他 `<UserRateCondition>`，或透過內嵌和參照方式，以內嵌方式定義條件。不過請注意，如果 `<UserRateCondition>` 是 `<RateRule>` 的子項，則 `<UserRateCondition>` 元素不能含有 `id` 屬性，且其他 `<UserRateCondition>` 無法參照。
`<RateModification>`	Optional	`<RateModification>`	針對不公開費率修改使用者介面的處理方式。
`<PromoCode>`	Optional	string	如果套用這個費率規範，指定要與費率相關聯的代碼，反映在 `PROMO-CODE` 到達網頁變數中。

`<UserRateCondition>`

定義一或多個符合條件式或不公開費率的條件。

<UserRateCondition> 元素會顯示在費率規則 XML 階層中的以下位置：

+ <RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

語法

<UserRateCondition> 元素使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
  <!-- "op" is required for more than one child element -->
  <UserRateCondition id="some_id" op="[all|any|none]">
    <UserDeviceType>device_type</UserDeviceType>
  </UserRateCondition>
  <UserRateCondition id="some_other_id" op="[all|any|none]">
    <UserDeviceType>device_type</UserDeviceType>
  </UserRateCondition>
  <!-- At least one RateRule is required -->
  <RateRule id="rate_rule_id">
    <UserRateCondition reference id="some_id"/>
  </RateRule>
  <RateRule id="rate_rule_id">
    <UserRateCondition reference id="some_other_id"/>
  </RateRule>
  <RateRule id="rate_rule_id">
    <UserRateCondition>
      <UserDeviceType>device_type</UserDeviceType>
    </UserRateCondition>
  </RateRule>
<span class="nocode"></RateRuleSettings></span>

屬性

<UserRateCondition> 元素的屬性如下：

屬性必填與否類型說明

屬性	必填與否	類型	說明
`id`	Required (if top-level under `<RateRuleSettings>`)	string	此`<UserRateCondition>`的專屬 ID。可由 `<RateRule>` `id` 屬性或 `<UserRateCondition>` `reference_id` 屬性參照。
`op`	Optional	enum	如果 `<UserRateCondition>` 有多個子元素，就必須提供 `op` 屬性。屬性值可以是下列任一項目： `all`：納入符合這個費率規範定義的所有條件的使用者。當其中一個條件為 `<UserListId>` 時，除非只定義另外一個條件 (`<AlwaysEligibleMembershipProgram>` 或 `<MembershipProgram>`)，否則這個值無法使用這個值。 `any`：納入符合這個費率規範定義的任何條件的使用者。 `none`：排除符合這個費率規範定義的任何條件的使用者。如有其中一個條件為 `<UserListId>`，則「無法」使用這個值。
`reference_id`	Optional	string	將此元素定義為對另一個具有相符 `id` 的預先定義 `<UserRateCondition>` 的參照。當 `reference_id` 存在時：不剖析子元素 `id` 和 `op` 不應出現

id

Required (if top-level under <RateRuleSettings>)

string

此<UserRateCondition>的專屬 ID。可由 <RateRule> id 屬性或 <UserRateCondition> reference_id 屬性參照。

op

Optional

enum

如果 <UserRateCondition> 有多個子元素，就必須提供 op 屬性。屬性值可以是下列任一項目：

all：納入符合這個費率規範定義的所有條件的使用者。當其中一個條件為 <UserListId> 時，除非只定義另外一個條件 (<AlwaysEligibleMembershipProgram> 或 <MembershipProgram>)，否則這個值無法使用這個值。
any：納入符合這個費率規範定義的任何條件的使用者。
none：排除符合這個費率規範定義的任何條件的使用者。如有其中一個條件為 <UserListId>，則「無法」使用這個值。

reference_id

Optional

string

將此元素定義為對另一個具有相符 id 的預先定義 <UserRateCondition> 的參照。

當 reference_id 存在時：

不剖析子元素
id 和 op 不應出現

子元素

<UserRateCondition> 元素包含下列子元素：

子項元素	必填與否	類型	說明
`<AlwaysEligibleMembershipProgram>`	Optional	string	指定費率將使用畫面上顯示的會員費率 UI 處理方式。這個元素的值可以是任何會員方案名稱。
`<Description>`	Optional	string	說明 `<UserRateCondition>`。這份文件僅供說明文件使用，對其功能沒有任何影響。
`<LanguageCode>`	Optional	string	指定系統會向語言與這個雙字母語言代碼相符的使用者提供費率。
`<MaxUsersPercent>`	Optional	float	指定系統將隨機向指定比例的使用者提供費率。這個值必須是介於 0 至 100 (含) 之間的整數。例如，20 會指定 20% 的使用者。
`<MembershipProgram>`	Optional	string	指定費率將使用 `<RateIneligibility>` 的 `<IneligibilityReason>` 判定的會員方案 UI 處理方式。必須指定 `<RateIneligibility>`，`<MembershipProgram>` 才會生效。 `<MembershipProgram>` 的值可以是任何會員方案名稱。
`<UserRateCondition>`	Optional	`<UserRateCondition>`	定義一或多個符合條件式或不公開費率的條件。具有 `reference_id` 的 `<UserRateCondition>` 必須有 0 子項。
`<UserCountry>`	Optional	string	CLDR 國家/地區代碼，例如 `DE` 或 `FR`。請注意，在部分國家/地區，CLDR 代碼與 2 個字母的 ISO 代碼不同。系統不支援 CLDR 區碼。指定使用者必須位於指定國家/地區。 Google 會根據使用者的 IP 位址判斷他們所在的國家/地區。
`<UserDeviceType>`	Optional	enum	定義裝置類型條件。允許的值如下： `mobile` `desktop` `tablet`
`<UserListId>`	Optional	string	目標對象名單的 Google Ads 使用者名單 ID。這項條件只能與 `<AlwaysEligibleMembershipProgram>`、`<MembershipProgram>` 或 `op` 為 `any` 搭配使用。
`<UserSignedIn>`	Optional	boolean	布林值，用於指定使用者是否必須登入自己的 Google 帳戶。`true` 值表示使用者必須登入。`false` 值表示使用者不得登入。如果您不關心使用者登入的狀態，請勿加入 `<UserSignedIn>` 條件。
`<IsDomestic>`	Optional	boolean	布林值，用於指定使用者是否必須來自飯店所在的國家/地區。如果值為 `true`，表示使用者必須與飯店位於相同的國家/地區。`false` 值表示使用者可能來自飯店所在國家/地區以外的任何國家/地區。如果您想更精細的控制，請使用 `<UserCountry>` 條件。

條件式費率範例

使用者百分比

下列條件式費率範例會指定系統隨機向所有使用者提供費率的 20%：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="20_percent_users">
    <UserRateCondition>
      <MaxUsersPercent>20</MaxUsersPercent>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

英國和行動裝置使用者

以下條件式費率範例使用內嵌 <UserRateCondition> 定義費率規範，以比對在英國透過行動裝置搜尋的所有使用者：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="gb_mobile">
    <UserRateCondition op="all">
      <UserCountry>GB</UserCountry>
      <UserDeviceType>mobile</UserDeviceType>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

日本和非日本

以下條件式費率範例，顯示一個符合日本使用者的費率規範，以及另一項符合世界其他地方使用者的費率規範 (RoW)：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="jp">
    <UserRateCondition>
      <UserCountry>jp</UserCountry>
    </UserRateCondition>
  </RateRule>
  <RateRule id="row_not_jp">
    <UserRateCondition op="none">
      <UserCountry>jp</UserCountry>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

不限、全部和無

以下條件式費率範例說明如何使用 any、all 和 none 值，以不同方式使用 op 屬性比對多項條件。舉例來說，如 au_nz 條件所示，您可以使用任一國家/地區來比對其中一個國家/地區的使用者。如 au_nz_mobile_tablet 費率規範所示，您可以使用 all 要求使用者符合多項條件。row_mobile_tablet 費率規範會將全球其他國家/地區 (列) (不含澳洲和紐西蘭) 且符合 mobile_tablet 條件的使用者進行比對。

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="au_nz" op="any">
    <UserCountry>AU</UserCountry>
    <UserCountry>NZ</UserCountry>
  </UserRateCondition>
  <UserRateCondition id="mobile_tablet" op="any">
    <UserDeviceType>mobile</UserDeviceType>
    <UserDeviceType>tablet</UserDeviceType>
  </UserRateCondition>
  <RateRule id="au_nz_mobile_tablet">
    <UserRateCondition op="all">
      <UserRateCondition reference_id="au_nz"/>
      <UserRateCondition reference_id="mobile_tablet"/>
    </UserRateCondition>
  </RateRule>
  <RateRule id="row_mobile_tablet">
    <UserRateCondition op="all">
      <UserRateCondition op="none">
        <UserRateCondition reference_id="au_nz"/>
      </UserRateCondition>
      <UserRateCondition reference_id="mobile_tablet"/>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

不公開費率示例

顯示會員費率 1

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="member_visible">
    <UserRateCondition>
      <AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

顯示會員費率 2

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="member_visible_es_only">
    <UserRateCondition op="all">
      <AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
      <UserCountry>es</UserCountry>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

目標對象名單率 1

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="audience_list">
    <UserRateCondition>
      <UserListId>[enter an audience list id]</UserListId>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

目標對象名單率 2

以下示例說明如何為多個目標對象名單指定會員費率 UI 處理方式：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <UserRateCondition op="all">
      <AlwaysEligibleMembershipProgram>[enter the program name here]</AlwaysEligibleMembershipProgram>
      <UserRateCondition op="any">
        <UserListId>[enter one audience list id here]</UserListId>
        <UserListId>[enter another audience list id here]</UserListId>
      </UserRateCondition>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

`<RateIneligibility>`

用於說明如何在隱藏 UI 樣式的情況下顯示會員費率。如果未加入，系統就不會顯示會員費率隱藏的 UI 處理方式。

如要在 <RateRule> 中使用 <RateIneligibility>，也必須在 <RateRule> 的 <UserRateCondition> 元素中指定 <MembershipProgram>。

<RateIneligibility> 元素會顯示在費率規則 XML 階層中的以下位置：

+ 
<RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

語法

<RateIneligibility> 元素使用下列語法：

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
  <UserRateCondition ...>
  ...
  </UserRateCondition>
  <RateRule ...>
    <UserRateCondition ...>
      ...
      <!-- Required when using RateIneligibility -->
      <MembershipProgram>program_name</MembershipProgram>
      ...
    </UserRateCondition>
    <RateIneligibility>
      <IneligibilityType>[exact|price_band|existence]</IneligibilityType>
      <IneligibilityReason>[program_member]</IneligibilityReason>
    </RateIneligibility>
  </RateRule>
</RateRuleSettings>

屬性

<RateIneligibility> 元素不含任何屬性。

子元素

<RateIneligibility> 元素包含下列子元素：

子項元素必填與否類型說明

子項元素	必填與否	類型	說明
`<IneligibilityType>`	Required	enum	定義文字 (顯示在大範圍輸出率旁邊) 如何描述隱藏率。以下為有效值： `exact`：折扣百分比。系統隨即會顯示「免費註冊即享 X% 折扣」。 `price_band`：折扣範圍。系統隨即會顯示「免費註冊即享 X-Y% 折扣」。如為 1% 至 5% 的折扣，則會顯示「最低 5% 折扣」。較大的折扣會以 5 個百分點的增幅顯示，例如「享有 5-10% 折扣」或「享有 10-15% 折扣」。 `existence`：非特定提示。在這種情況下，系統會顯示「免費註冊即享優惠價格」。如要進一步瞭解使用者介面的處理方式，請參閱不公開費率詳細資料和範例。
`<IneligibilityReason>`	Required	enum	以下為有效值： `program_member`：使用隱藏費率的 UI 處理方式顯示費率。

<IneligibilityType>

Required

enum

定義文字 (顯示在大範圍輸出率旁邊) 如何描述隱藏率。

以下為有效值：

exact：折扣百分比。系統隨即會顯示「免費註冊即享 X% 折扣」。
price_band：折扣範圍。系統隨即會顯示「免費註冊即享 X-Y% 折扣」。如為 1% 至 5% 的折扣，則會顯示「最低 5% 折扣」。較大的折扣會以 5 個百分點的增幅顯示，例如「享有 5-10% 折扣」或「享有 10-15% 折扣」。
existence：非特定提示。在這種情況下，系統會顯示「免費註冊即享優惠價格」。

如要進一步瞭解使用者介面的處理方式，請參閱不公開費率詳細資料和範例。

<IneligibilityReason>

Required

enum

以下為有效值：

program_member：使用隱藏費率的 UI 處理方式顯示費率。

不公開費率示例

本節包含隱藏會員費率的範例 (基本) 和會員費率隱藏範例 (多個條件)。你也可以向部分使用者顯示會員費率。如需範例，請參閱「不公開費率範例」。

隱藏會員費率示例 (基本)

確切折扣

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>exact</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition>
      <MembershipProgram>[enter program name here]</MembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

錶帶折扣

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>price_band</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition>
      <MembershipProgram>[enter program name here]</MembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

提示折扣

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>existence</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition>
      <MembershipProgram>[enter program name here]</MembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

隱藏會員費率的示例 (多個條件)

op="any"

針對非會員的會員目標對象名單費率 + 隱藏會員費率 (存在折扣)

此不公開費率範例指定會員費率的 existence 類型隱藏 UI 處理方式，這會向使用者顯示，不會向目標對象名單顯示。系統會向目標對象名單中的使用者顯示目標對象率。

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>existence</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition op="any">
      <MembershipProgram>[enter program name here]</MembershipProgram>
      <UserListId>[enter you audience list id here]</UserListId>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

op="all"

只對目標對象名單使用者隱藏會員費率

此不公開費率示例指定隱藏式 UI 處理方式的 exact 類型，並加上「加上免費 Wi-Fi」這段額外文字。系統會向符合目標對象名單的使用者顯示這項 UI 樣式。

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program_for_audience_list">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>exact</IneligibilityType>
    </RateIneligibility>
    <RateModification>
      <HotelAmenity>free_wifi</HotelAmenity>
    </RateModification>
    <UserRateCondition op="all">
      <MembershipProgram>[enter program name here]</MembershipProgram>
      <UserListId>[enter you audience list id here]</UserListId>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

透明/可見的使用者介面

本例說明如何透過兩個 UI 處理方式 (透明且可見的 UI)，針對目標對象名單中的使用者指定會員費率，以及為其他使用者指定隱藏費率。

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>existence</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition op="any">
      <MembershipProgram>[enter program name here]</MembershipProgram>
      <UserRateCondition op="all">
        <UserListId>[enter you audience list id here]</UserListId>
        <AlwaysEligibleMembershipProgram>program_name</AlwaysEligibleMembershipProgram>
      </UserRateCondition>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

`<RateModification>`

針對不公開費率修改使用者介面的處理方式。

<RateModification> 元素會顯示在費率規則 XML 階層中的以下位置：

+ 
<RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

屬性

<RateModification> 元素不含任何屬性。

子元素

<RateModification> 元素包含下列子元素：

子項元素必填與否類型說明

子項元素	必填與否	類型	說明
`<HotelAmenity>`	Optional	enum	搭配使用 `<MembershipProgram>` 和 `<RateIneligibility>`，修改會員費率隱藏使用者介面的處理方式。以下為有效值： `free_wifi`：在文字中加入 `plus free wifi`。
`<PriceMultiplier>`	Optional	float	如要修改價格，請將這個值乘以基本費率、稅金和相關費用。舉例來說，如果 `PriceMultiplier` = 0.9，基本費率 = $100 美元，稅金 = $20 美元，費用 = $10 美元；套用係數後，基本費率 = $90 美元，稅金 = $18 美元，稅金 = $9 美元。這樣就能對設有特定費率規範的所有費率套用折扣。

<HotelAmenity>

Optional

enum

搭配使用 <MembershipProgram> 和 <RateIneligibility>，修改會員費率隱藏使用者介面的處理方式。

以下為有效值：

free_wifi：在文字中加入 plus free wifi。

<PriceMultiplier>

Optional

float

如要修改價格，請將這個值乘以基本費率、稅金和相關費用。舉例來說，如果 PriceMultiplier = 0.9，基本費率 = $100 美元，稅金 = $20 美元，費用 = $10 美元；套用係數後，基本費率 = $90 美元，稅金 = $18 美元，稅金 = $9 美元。

這樣就能對設有特定費率規範的所有費率套用折扣。

不公開費率示例

飯店設施

對所有使用者隱藏會員費率 (頻帶折扣) + 免費 Wi-Fi

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>price_band</IneligibilityType>
    </RateIneligibility>
    <RateModification>
      <HotelAmenity>free_wifi</HotelAmenity>
    </RateModification>
    <UserRateCondition>
      <MembershipProgram>[enter program name here]</MembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

價格調節係數

在價格動態饋給中為行動裝置費率套用 5% 折扣

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="mobile">
    <RateModification>
      <PriceMultiplier>0.95</PriceMultiplier>
    </RateModification>
    <UserRateCondition>
      <UserDeviceType>mobile</UserDeviceType>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>