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

費率規範 XML 參考資料

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

每個費率規範都需要一個 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 處理方式的費率 (如有)
針對不公開費率使用隱藏的 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。如要讓 `<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`，表示使用者必須和飯店位於相同的國家/地區。如果值為 `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`：非特定提示。在此情況下，系統會顯示「免費註冊即享優惠價格」。如要進一步瞭解 UI 處理方式，請參閱不公開費率詳細資料與範例。
`<IneligibilityReason>`	Required	enum	以下為有效值： `program_member`：使用會員費率隱藏 UI 方式顯示費率。

<IneligibilityType>

Required

enum

定義文字 (顯示在打破率旁邊) 如何描述隱藏率。

以下為有效值：

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

如要進一步瞭解 UI 處理方式，請參閱不公開費率詳細資料與範例。

<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>`，修改隱藏會員費率 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>