此页面由 Cloud Translation API 翻译。

费率规则 XML 参考

费率规则 XML 文件定义了条件式费率和不公开费率的投放规则。您可以使用 Hotel Center 中的费率规则页面添加或修改费率规则 XML 文件。如需详细了解条件式费率和不公开费率，请参阅条件式费率和不公开费率。

每条费率规则都需要一个 id，后者可以在 Transaction 消息的 <Rate> 中引用。引用费率规则 ID 的 <Rate> 仅在符合费率规则定义的条件下向用户传送。您也可以使用着陆页网址中的变量引用费率规则 ID。

`<RateRuleSettings>`

费率规则 XML 文件的根元素。<RateRuleSettings>（以前称为 <PrivateRates>）元素包含：

<UserRateCondition> 元素，用于定义要匹配的条件式费率和不公开费率的条件。例如，您可以创建条件式费率，用于匹配特定国家/地区所有用户的条件。
<RateRule> 元素，其中每个元素都定义了一条费率规则，以供在 Transaction 消息的 <Rate> 中引用。每个 <RateRule> 都会指定构建条件费率或不公开费率的条件和界面处理方式。

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

用于指定以下内容的容器：

费率的适用条件
对价格和界面处理方式的修改（如果有）
针对不公开费率使用隐藏界面处理方式

<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`	必需	string	费率规则的唯一标识符。在交易消息中使用 `<Rate>` 的 `rate_rule_id` 属性引用此 ID，以提供条件式费率或不公开费率。您也可以使用着陆页网址中的变量和条件来引用费率规则 `id`。允许的最大字符数为 40。

id

必需

string

费率规则的唯一标识符。在交易消息中使用 <Rate> 的 rate_rule_id 属性引用此 ID，以提供条件式费率或不公开费率。您也可以使用着陆页网址中的变量和条件来引用费率规则 id。

允许的最大字符数为 40。

子元素

<RateRule> 元素具有以下子元素：

子元素	是否必需？	类型	说明
`<RateIneligibility>`	Optional	`<RateIneligibility>`	指定的值用于确定 `<MembershipProgram>` 比率的具体界面处理方式。仅当 `<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>` 的唯一标识符。可由 `<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> 的唯一标识符。可由 <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	指定费率将使用会员费率在界面上可见。此元素的值可以是任意会员计划名称。
`<Description>`	Optional	string	描述 `<UserRateCondition>`。这仅供记录之用，对其功能没有影响。
`<LanguageCode>`	Optional	string	指定向所用语言与这个由两个字母组成的语言代码相符的用户提供费率。
`<MaxUsersPercent>`	Optional	float	指定向此百分比的最终用户随机提供费率。该值必须是 0 到 100（含 0 和 100）之间的整数。例如，选择 20 将定位到 20% 的最终用户。
`<MembershipProgram>`	Optional	string	指定此费率将使用会员计划界面处理方式，由 `<RateIneligibility>` 的 `<IneligibilityReason>` 确定。为使 `<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>` 条件。

条件式费率示例

用户百分比

以下条件式费率示例指定费率将随机提供给 2% 的用户：

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

指示如何显示会员费率隐藏界面处理方式。如果未包含该属性，系统将不会显示会员费率隐藏界面处理方式。

如需在 <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 分的增量显示，例如“五折到九折优惠”或“九五折到八五折”。 `existence`：非具体提示。在这种情况下，系统会显示文本：“免费注册即可享受更低的价格。” 如需详细了解界面处理方式，请参阅不公开费率详情和示例。
`<IneligibilityReason>`	Required	enum	有效值包括： `program_member`：使用会员房价隐藏界面处理方式显示房价。

<IneligibilityType>

Required

enum

定义文本（显示在被划掉的比率旁边）将如何描述隐藏比率。

有效值包括：

exact：折扣百分比。该页面上会显示“免费注册即可享受 X% 的折扣”。
price_band：折扣范围。该页面上会显示“免费注册即可享受 X-Y% 的折扣”。对于 1-5% 的折扣，系统将显示“最高可享受 5% 的折扣”。较大的折扣将以 5 分的增量显示，例如“五折到九折优惠”或“九五折到八五折”。
existence：非具体提示。在这种情况下，系统会显示文本：“免费注册即可享受更低的价格。”

如需详细了解界面处理方式，请参阅不公开费率详情和示例。

<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="任意"

会员的受众群体名单费率 + 隐藏的非会员会员费率（存在折扣）

下面的不公开费率示例指定了 existence 类型的会员房价隐藏界面处理方式，该样式将向用户显示，而不是受众群体名单。受众群体名单中的用户将会看到受众群体率。

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

透明/可见的界面

此示例展示了如何通过两种界面处理方式（透明和可见界面）为受众群体名单中的用户指定会员费率，并为所有其他用户指定隐藏费率。

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

价格调节系数

对价格 Feed 中的移动设备费率应用 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>