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

費率規範 XML 參考資料

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

每個費率規範都需要 id，可參考 <Rate> 的訊息。內含的 <Rate> 費率規範 ID 只會在以下條件下向使用者放送套用費率規範您也可以使用費率規範 ID 來參照費率規範 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。這個 ID 參照的是交易中 `<Rate>` 的 `rate_rule_id` 屬性訊息提供條件式或不公開費率費率規範也可以使用變數和條件來參照 `id` 到達網頁中網址。長度上限為 40 個半形字元。

id

必要

字串

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

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

子元素

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

子項元素	必填與否	類型	說明
`<RateIneligibility>`	Optional	`<RateIneligibility>`	指定值，以決定使用者的特定 UI 處理方式 `<MembershipProgram>` 比率。只有在指定 `<MembershipProgram>` 時才會生效位置：`<UserRateCondition>`。
`<UserRateCondition>`	Required	`<UserRateCondition>`	定義一或多個比對結果的條件提供的條件式或不公開費率。您可以使用 `<UserRateCondition>` 內嵌定義條件子項元素，透過參照其他`<UserRateCondition>`的方式 `reference_id` 屬性，或內嵌及參照。但請注意，當 `<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	指定費率將使用會員方案 UI 處理方式判斷依據為：`<IneligibilityReason>` `<RateIneligibility>`。 `<MembershipProgram>` 的有效性必須指定 `<RateIneligibility>`。 `<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` 表示使用者必須與飯店位於同一個國家/地區。A 罩杯 `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>

不限、全部和無

以下是 op 的條件式費率範例您可以運用屬性，以不同方式比對多個條件使用 any、all 和 none 值。例如， 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

這個不公開費率示例說明如何指定公開顯示的會員費率多份目標對象名單的使用者介面處理方式：

<?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>，必須也為 <MembershipProgram> 必須在 <RateRule> 的 <UserRateCondition> 元素中指定。

<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% 折扣」。折扣會顯示「最低 5 折」字樣。更高的折扣以 5 個百分點為單位顯示，例如「享有 5-10% 折扣」或「獲得 10-15% 。」 `existence`：非特定提示。在這種情況下，系統會顯示「免費享有優惠價」註冊。」如要進一步瞭解 UI 處理方式，請前往：不公開費率詳細資料和範例。
`<IneligibilityReason>`	Required	enum	有效值如下： `program_member`：顯示費率隱藏使用會員費率的使用者介面設定

<IneligibilityType>

Required

enum

定義文字 (顯示在劃定率旁) 如何並描述隱藏費率

有效值如下：

exact：折扣百分比。系統隨即會顯示「免費註冊即享 X% 折扣」。
price_band：折扣範圍。系統隨即會顯示「免費註冊即享 X-Y% 折扣」。折扣會顯示「最低 5 折」字樣。更高的折扣以 5 個百分點為單位顯示，例如「享有 5-10% 折扣」或「獲得 10-15% 。」
existence：非特定提示。在這種情況下，系統會顯示「免費享有優惠價」註冊。」

如要進一步瞭解 UI 處理方式，請前往：不公開費率詳細資料和範例。

<IneligibilityReason>

Required

enum

有效值如下：

program_member：顯示費率隱藏使用會員費率的使用者介面設定

不公開費率示例

這個部分包含隱藏會員費率的範例 (基本) 和會員費率隱藏的範例 (多重條件)。你也可以在以下位置顯示會員費率：做為目標如需範例，請參閱「不公開費率範例」。

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

確切折扣

<?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 樣式，這項資訊會向使用者顯示，而非向目標對象顯示請參考閱讀清單，進一步瞭解如何選擇 Kubeflow Pipelines SDK 或 TFX系統會向目標對象名單中的使用者顯示目標對象率。

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

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

這個不公開費率示例會指定隱藏會員費率的 exact 類型修改使用者介面，加上額外文字「加上免費 Wi-Fi」。這個使用者介面系統會向符合目標對象名單的使用者顯示實驗組。

<?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 處理方式指定會員費率 (透明且可見的使用者介面) 對目標對象名單和隱藏費率中的使用者顯示供其他使用者使用

<?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>` 可用於修改會員費率隱藏 UI 的處理方式。有效值如下： `free_wifi`：新增 `plus free wifi` 來生成文字
`<PriceMultiplier>`	Optional	float	如要修改價格，請將這個值乘以基本費率、稅金、及其他費用舉例來說，如果 `PriceMultiplier` = 0.9，那麼底數稅率 = $100 美元，稅金 = $20 美元，手續費 = $10 美元；之後套用調節係數：基本費率 = $90 美元，稅金 = $18 美元，費用 = $9 美元。這樣就能針對適用特定費率的所有費率套用折扣規則。

<HotelAmenity>

Optional

enum

結合 <MembershipProgram> 和 <RateIneligibility> 可用於修改會員費率隱藏 UI 的處理方式。

有效值如下：

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>

費率規範 XML 參考資料

<RateRuleSettings>

語法

屬性

子元素

條件式費率範例

行動使用者

美國使用者

<RateRule>

語法

屬性

子元素

<UserRateCondition>

語法

屬性

子元素

條件式費率範例

使用者百分比

英國和行動裝置使用者

日本和非日本

不限、全部和無

不公開費率示例

顯示會員費率 1

顯示會員費率 2

目標對象名單率 1

目標對象名單率 2

<RateIneligibility>

語法

屬性

子元素

不公開費率示例

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

確切折扣

錶帶折扣

提示折扣

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

op=&quot;any&quot;

op=&quot;all&quot;

透明/可見的使用者介面

<RateModification>

屬性

子元素

不公開費率示例

飯店設施

價格調節係數

`<RateRuleSettings>`

`<RateRule>`

`<UserRateCondition>`

`<RateIneligibility>`

op="any"

op="all"

`<RateModification>`