Trang này được dịch bởi Cloud Translation API.

Tài liệu tham khảo về quy tắc giá viết bằng XML

Tệp XML về quy tắc giá xác định các quy tắc phân phát giá phòng có điều kiện và mức giá ưu đãi chọn lọc. Bạn có thể thêm hoặc chỉnh sửa tệp XML về quy tắc giá bằng cách sử dụng Trang Quy tắc giá trong Hotel Center. Để biết thêm thông tin về giá phòng có điều kiện và mức giá ưu đãi chọn lọc, hãy xem Giá phòng có điều kiện và mức giá ưu đãi chọn lọc.

Mỗi quy tắc giá phải có một id (có thể được tham chiếu trong một thuộc tính) <Rate> của thông báo Giao dịch. Một <Rate> tham chiếu đến mã quy tắc giá chỉ được phân phát cho người dùng và theo các điều kiện được xác định theo quy tắc giá. Mã quy tắc giá cũng có thể được tham chiếu bằng cách sử dụng trong URL trang đích.

`<RateRuleSettings>`

Phần tử gốc của tệp XML về quy tắc giá. Chiến lược phát hành đĩa đơn Phần tử <RateRuleSettings> (trước đây là <PrivateRates>) chứa:

Phần tử <UserRateCondition> xác định các điều kiện để so khớp theo giá phòng có điều kiện và mức giá ưu đãi chọn lọc. Ví dụ: bạn có thể tạo một giá phòng có điều kiện khớp với điều kiện của tất cả người dùng ở một quốc gia.
<RateRule> phần tử mà mỗi phần tử xác định một quy tắc giá tham chiếu trong <Rate> trong Thông báo giao dịch. Một <RateRule> chỉ định các điều kiện và nội dung trong giao diện người dùng để tạo ra giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc.

Phần tử <RateRuleSettings> xuất hiện ở vị trí sau trong tỷ lệ hệ thống phân cấp XML của quy tắc:

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

Cú pháp

Phần tử <RateRuleSettings> sử dụng cú pháp sau:

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

Thuộc tính

Phần tử <RateRuleSettings> không có thuộc tính nào.

Phần tử con

Phần tử <RateRuleSettings> có các phần tử con như sau:

Thành phần con Bắt buộc? Loại Mô tả

Thành phần con	Bắt buộc?	Loại	Mô tả
`<RateRule>`	Required	`<RateRule>`	Xác định các điều kiện khớp, nội dung sửa đổi và điều kiện để phân phối giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc. Cần có `id` mà có thể được tham chiếu trong `<Rate>` của Giao dịch hoặc trong URL trang đích.
`<UserRateCondition>`	Optional	`<UserRateCondition>`	Xác định một hoặc nhiều điều kiện mà khi được so khớp sẽ dẫn đến giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc đang được phân phát. Bạn có thể xác định các điều kiện cùng dòng bằng cách sử dụng `<UserRateCondition>` phần tử con, bằng cách tham chiếu đến một phần tử con khác Phần tử `<UserRateCondition>` bằng cách sử dụng `reference_id` hoặc cả nội tuyến lẫn theo tham chiếu. Tuy nhiên, bất kỳ `<UserRateCondition>` có `reference_id` phải có 0 trẻ em. `<UserRateCondition>` cấp cao nhất dưới `<RateRuleSettings>` phải có thuộc tính `id`.

<RateRule>

Required

<RateRule>

Xác định các điều kiện khớp, nội dung sửa đổi và điều kiện để phân phối giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc. Cần có id mà có thể được tham chiếu trong <Rate> của Giao dịch hoặc trong URL trang đích.

<UserRateCondition>

Optional

<UserRateCondition>

Xác định một hoặc nhiều điều kiện mà khi được so khớp sẽ dẫn đến giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc đang được phân phát.

Bạn có thể xác định các điều kiện cùng dòng bằng cách sử dụng <UserRateCondition> phần tử con, bằng cách tham chiếu đến một phần tử con khác Phần tử <UserRateCondition> bằng cách sử dụng reference_id hoặc cả nội tuyến lẫn theo tham chiếu. Tuy nhiên, bất kỳ <UserRateCondition> có reference_id phải có 0 trẻ em.

<UserRateCondition> cấp cao nhất dưới <RateRuleSettings> phải có thuộc tính id.

Ví dụ về giá phòng có điều kiện

Ví dụ sau đây trình bày các cách cơ bản để xác định giá phòng có điều kiện.

Tham chiếu đến các điều kiện được xác định trước, như trong ví dụ về Người dùng thiết bị di động, .

Người dùng thiết bị di động

Ví dụ sau đây về giá phòng có điều kiện xác định một quy tắc giá là: tất cả người dùng thiết bị di động bằng cách tham chiếu đến một <UserRateCondition> được xác định trước:

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

Người dùng ở Hoa Kỳ

Ví dụ sau đây về giá phòng có điều kiện xác định một quy tắc giá là: tất cả người dùng đang tìm kiếm ở Hoa Kỳ bằng cách tham chiếu đến <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>`

Vùng chứa để chỉ định:

Các điều kiện để phân phát giá
Nội dung sửa đổi (nếu có) về giá và cách hiển thị mức giá trên giao diện người dùng
Sử dụng biện pháp xử lý giao diện người dùng bị ẩn đối với mức giá ưu đãi chọn lọc

Phần tử <RateRule> xuất hiện ở vị trí sau đây trong tệp XML về quy tắc giá hệ thống phân cấp:

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

Cú pháp

Phần tử <RateRule> sử dụng cú pháp sau:

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

Thuộc tính

Phần tử <RateRule> có các thuộc tính như sau:

Thuộc tính Bắt buộc? Loại Mô tả

Thuộc tính	Bắt buộc?	Loại	Mô tả
`id`	Bắt buộc	string	Giá trị nhận dạng duy nhất của quy tắc giá. Mã này được tham chiếu bằng cách sử dụng Thuộc tính `rate_rule_id` của `<Rate>` trong một Giao dịch để cung cấp giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc. Quy tắc giá `id` cũng có thể được tham chiếu bằng một biến và điều kiện trên một trang đích URL. Số lượng ký tự tối đa được phép là 40.

id

Bắt buộc

string

Giá trị nhận dạng duy nhất của quy tắc giá. Mã này được tham chiếu bằng cách sử dụng Thuộc tính rate_rule_id của <Rate> trong một Giao dịch để cung cấp giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc. Quy tắc giá id cũng có thể được tham chiếu bằng một biến và điều kiện trên một trang đích URL.

Số lượng ký tự tối đa được phép là 40.

Phần tử con

Phần tử <RateRule> có các phần tử con như sau:

Thành phần con	Bắt buộc?	Loại	Mô tả
`<RateIneligibility>`	Optional	`<RateIneligibility>`	Chỉ định các giá trị xác định cách hiển thị nội dung trên giao diện người dùng cho một Giá `<MembershipProgram>`. Chỉ hợp lệ khi `<MembershipProgram>` được chỉ định trong `<UserRateCondition>`.
`<UserRateCondition>`	Required	`<UserRateCondition>`	Xác định một hoặc nhiều điều kiện mà khi được so khớp sẽ dẫn đến giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc đang được phân phát. Bạn có thể xác định các điều kiện cùng dòng bằng cách sử dụng `<UserRateCondition>` các phần tử con, tham chiếu đến một `<UserRateCondition>` khác bằng cách sử dụng thuộc tính `reference_id` hoặc cả cùng dòng và tham chiếu. Tuy nhiên, hãy lưu ý rằng khi `<UserRateCondition>` là con của `<RateRule>`, phần tử `<UserRateCondition>` không được có Thuộc tính `id` và không thể được tham chiếu bởi một thuộc tính khác `<UserRateCondition>`.
`<RateModification>`	Optional	`<RateModification>`	Sửa đổi cách hiển thị nội dung trên giao diện người dùng đối với mức giá ưu đãi chọn lọc.
`<PromoCode>`	Optional	string	Chỉ định một mã được liên kết với mức giá nếu quy tắc giá này là áp dụng. Được thể hiện trên trang đích của `PROMO-CODE` biến.

`<UserRateCondition>`

Xác định một hoặc nhiều điều kiện mà khi được so khớp dẫn đến điều kiện hoặc mức giá ưu đãi chọn lọc đang được cung cấp.

Phần tử <UserRateCondition> xuất hiện ở vị trí sau đây trong hệ thống phân cấp XML của quy tắc giá:

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

Cú pháp

Phần tử <UserRateCondition> sử dụng cú pháp sau:

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

Thuộc tính

Phần tử <UserRateCondition> có các thuộc tính như sau:

Thuộc tính Bắt buộc? Loại Mô tả

Thuộc tính	Bắt buộc?	Loại	Mô tả
`id`	Required (if top-level under `<RateRuleSettings>`)	string	Giá trị nhận dạng duy nhất của `<UserRateCondition>` này. Có thể được tham chiếu bằng thuộc tính `<RateRule>` `id` hoặc bởi `<UserRateCondition>` Thuộc tính `reference_id`.
`op`	Optional	enum	Thuộc tính `op` là bắt buộc khi `<UserRateCondition>` có nhiều phần tử con. Giá trị thuộc tính có thể là một trong những sau: `all`: Bao gồm những người dùng cuối phù hợp với tất cả các điều kiện do quy tắc giá này xác định. Không thể sử dụng giá trị này khi một trong các điều kiện là `<UserListId>`, trừ khi chỉ một điều kiện khác— `<AlwaysEligibleMembershipProgram>` hoặc `<MembershipProgram>`—được định nghĩa. `any`: Bao gồm những người dùng cuối phù hợp với bất kỳ các điều kiện do quy tắc giá này xác định. `none`: Loại trừ những người dùng cuối khớp với bất kỳ các điều kiện do quy tắc giá này xác định. Giá trị này không được được sử dụng khi một trong các điều kiện là `<UserListId>`.
`reference_id`	Optional	string	Xác định phần tử này là tham chiếu đến một phần tử được xác định trước khác `<UserRateCondition>` có `id` phù hợp. Khi có `reference_id`: Các phần tử con không được phân tích cú pháp Không được dùng `id` và `op`

id

Required (if top-level under <RateRuleSettings>)

string

Giá trị nhận dạng duy nhất của <UserRateCondition> này. Có thể được tham chiếu bằng thuộc tính <RateRule> id hoặc bởi <UserRateCondition> Thuộc tính reference_id.

op

Optional

enum

Thuộc tính op là bắt buộc khi <UserRateCondition> có nhiều phần tử con. Giá trị thuộc tính có thể là một trong những sau:

all: Bao gồm những người dùng cuối phù hợp với tất cả các điều kiện do quy tắc giá này xác định. Không thể sử dụng giá trị này khi một trong các điều kiện là <UserListId>, trừ khi chỉ một điều kiện khác— <AlwaysEligibleMembershipProgram> hoặc <MembershipProgram>—được định nghĩa.
any: Bao gồm những người dùng cuối phù hợp với bất kỳ các điều kiện do quy tắc giá này xác định.
none: Loại trừ những người dùng cuối khớp với bất kỳ các điều kiện do quy tắc giá này xác định. Giá trị này không được được sử dụng khi một trong các điều kiện là <UserListId>.

reference_id

Optional

string

Xác định phần tử này là tham chiếu đến một phần tử được xác định trước khác <UserRateCondition> có id phù hợp.

Khi có reference_id:

Các phần tử con không được phân tích cú pháp
Không được dùng id và op

Phần tử con

Phần tử <UserRateCondition> có các phần tử con như sau:

Thành phần con	Bắt buộc?	Loại	Mô tả
`<AlwaysEligibleMembershipProgram>`	Optional	string	Xác định rằng giá này sẽ sử dụng giao diện người dùng nhìn thấy giá dành cho thành viên xử lý. Giá trị của phần tử này có thể là tên chương trình thành viên bất kỳ.
`<Description>`	Optional	string	Mô tả `<UserRateCondition>`. Nội dung này là để tham khảo tài liệu và không ảnh hưởng đến khả năng của công cụ đó.
`<LanguageCode>`	Optional	string	Xác định rằng mức giá này sẽ được cung cấp cho những người dùng sử dụng ngôn ngữ khớp với ký tự hai chữ cái này mã ngôn ngữ.
`<MaxUsersPercent>`	Optional	float	Xác định rằng giá sẽ được cung cấp ngẫu nhiên cho tỷ lệ phần trăm này người dùng cuối. Giá trị phải là một số nguyên từ 0 đến 100 (bao gồm cả 0 và 100). Cho Ví dụ: 20 sẽ nhắm đến 20% người dùng cuối.
`<MembershipProgram>`	Optional	string	Cho biết rằng giá sẽ áp dụng biện pháp xử lý giao diện người dùng của chương trình thành viên như được xác định bởi `<IneligibilityReason>` của `<RateIneligibility>` Để `<MembershipProgram>` hợp lệ, Bạn phải chỉ định `<RateIneligibility>`. Giá trị của `<MembershipProgram>` có thể là bất kỳ giá trị nào tên chương trình gói thành viên.
`<UserRateCondition>`	Optional	`<UserRateCondition>`	Xác định một hoặc nhiều điều kiện mà khi được so khớp sẽ dẫn đến giá phòng có điều kiện hoặc mức giá ưu đãi chọn lọc đang được phân phát. `<UserRateCondition>` có `reference_id` không được có giá trị 0 trẻ em.
`<UserCountry>`	Optional	string	CLDR mã quốc gia, chẳng hạn như `DE` hoặc `FR`. Xin lưu ý rằng đối với một số quốc gia, mã CLDR không giống với mã ISO gồm 2 chữ cái . Không hỗ trợ mã vùng CLDR. Chỉ định rằng người dùng phải ở quốc gia được chỉ định. Google xác định quốc gia của người dùng cuối bằng địa chỉ IP của họ.
`<UserDeviceType>`	Optional	enum	Xác định điều kiện về loại thiết bị. Các giá trị được phép là: `mobile` `desktop` `tablet`
`<UserListId>`	Optional	string	Mã danh sách người dùng Google Ads của một danh sách đối tượng. Điều kiện này chỉ có thể được sử dụng với `<AlwaysEligibleMembershipProgram>` hoặc `<MembershipProgram>` hoặc khi `op` là `any`.
`<UserSignedIn>`	Optional	boolean	Giá trị boolean xác định liệu người dùng có phải đăng nhập hay không Tài khoản Google của họ. Giá trị `true` cho biết rằng Người dùng phải đăng nhập. Giá trị `false` cho biết rằng người dùng không được đăng nhập. Nếu bạn không quan tâm người dùng đã đăng nhập hoặc đã đăng xuất, không bao gồm `<UserSignedIn>` .
`<IsDomestic>`	Optional	boolean	Giá trị boolean xác định liệu người dùng có phải ở quốc gia nơi khách sạn toạ lạc. Giá trị `true` cho biết rằng người dùng phải ở cùng quốc gia với khách sạn. Đáp giá trị `false` cho biết người dùng có thể thuộc bất kỳ quốc gia khác với quốc gia của khách sạn. Nếu bạn muốn chi tiết hơn điều khiển, sử dụng điều kiện `<UserCountry>`.

Ví dụ về giá phòng có điều kiện

Tỷ lệ phần trăm người dùng

Ví dụ sau đây về giá phòng có điều kiện xác định rằng giá phòng sẽ là được cung cấp ngẫu nhiên cho 20% người dùng:

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

Người dùng ở Vương quốc Anh và người dùng thiết bị di động

Ví dụ sau đây về giá phòng có điều kiện xác định một quy tắc giá là: tất cả người dùng đang tìm kiếm ở Vương quốc Anh bằng thiết bị di động bằng cách sử dụng <UserRateCondition> cùng dòng:

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

Nhật Bản và không phải Nhật Bản

Ví dụ sau đây về giá phòng có điều kiện cho thấy một quy tắc giá khớp với người dùng ở Nhật Bản và một quy tắc giá khác phù hợp với người dùng ở những quốc gia còn lại thế giới (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 và none

Ví dụ sau đây về giá phòng có điều kiện cho thấy cách op có thể được sử dụng để khớp trên nhiều điều kiện theo các cách khác nhau bằng cách sử dụng các giá trị any, all và none. Ví dụ: như trong au_nz, bạn có thể sử dụng giá trị bất kỳ để so khớp người dùng thuộc bất kỳ quốc gia. Như trong quy tắc giá au_nz_mobile_tablet, bạn có thể sử dụng all để yêu cầu người dùng đáp ứng nhiều điều kiện. Chiến lược phát hành đĩa đơn row_mobile_tablet quy tắc giá sẽ so khớp với những người dùng nằm trong phần còn lại của world (hàng), ngoại trừ Úc và New Zealand và cũng khớp với Điều kiện 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>

Ví dụ về mức giá ưu đãi chọn lọc

Giá nhìn thấy được cho thành viên 1

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

Giá nhìn thấy được cho thành viên 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>

Giá theo danh sách đối tượng 1

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

Giá theo danh sách đối tượng 2

Ví dụ về mức giá ưu đãi chọn lọc này thể hiện cách chỉ định mức giá dành cho thành viên mà bạn nhìn thấy Nội dung trong giao diện người dùng cho nhiều danh sách đối tượng:

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

Cho biết cách hiển thị biện pháp xử lý giao diện người dùng đối với giá không nhìn thấy được cho thành viên. Nếu không bao gồm cả biện pháp xử lý giao diện người dùng bị ẩn đối với giá dành cho thành viên sẽ không xuất hiện.

Để sử dụng <RateIneligibility> trong <RateRule>, <MembershipProgram> cũng phải được chỉ định trong phần tử <UserRateCondition> cho <RateRule>.

Phần tử <RateIneligibility> xuất hiện ở vị trí sau đây trong tỷ lệ hệ thống phân cấp XML của quy tắc:

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

Cú pháp

Phần tử <RateIneligibility> sử dụng cú pháp sau:

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

Thuộc tính

Phần tử <RateIneligibility> không có thuộc tính nào.

Phần tử con

Phần tử <RateIneligibility> có các phần tử con như sau:

Thành phần con Bắt buộc? Loại Mô tả

Thành phần con	Bắt buộc?	Loại	Mô tả
`<IneligibilityType>`	Required	enum	Xác định cách văn bản (hiển thị bên cạnh mức giá bị gạch ngang) sẽ mô tả tỷ lệ ẩn. Các giá trị hợp lệ là: `exact`: Tỷ lệ phần trăm chiết khấu. Văn bản sẽ có nội dung là "Giảm X% khi đăng ký miễn phí". `price_band`: Khoảng chiết khấu. Văn bản sẽ có nội dung là "Giảm X-Y% khi đăng ký miễn phí". Dành cho chiết khấu từ 1 đến 5%, thì văn bản sẽ có nội dung "Giảm giá lên đến 5%". Các khoản chiết khấu lớn hơn sẽ được thể hiện theo mức tăng 5 điểm, chẳng hạn như "Giảm giá 5-10%" hoặc "Nhận 10-15% tắt". `existence`: Gợi ý không cụ thể. Trong trường hợp này, văn bản sẽ có nội dung: "Mua kèm miễn phí mức giá thấp hơn đăng ký". Tìm hiểu thêm về cách xử lý giao diện người dùng trong Mức giá ưu đãi chọn lọc và ví dụ.
`<IneligibilityReason>`	Required	enum	Các giá trị hợp lệ là: `program_member`: Hiện mức phí thông qua biện pháp xử lý giao diện người dùng đối với giá không nhìn thấy được cho thành viên.

<IneligibilityType>

Required

enum

Xác định cách văn bản (hiển thị bên cạnh mức giá bị gạch ngang) sẽ mô tả tỷ lệ ẩn.

Các giá trị hợp lệ là:

exact: Tỷ lệ phần trăm chiết khấu. Văn bản sẽ có nội dung là "Giảm X% khi đăng ký miễn phí".
price_band: Khoảng chiết khấu. Văn bản sẽ có nội dung là "Giảm X-Y% khi đăng ký miễn phí". Dành cho chiết khấu từ 1 đến 5%, thì văn bản sẽ có nội dung "Giảm giá lên đến 5%". Các khoản chiết khấu lớn hơn sẽ được thể hiện theo mức tăng 5 điểm, chẳng hạn như "Giảm giá 5-10%" hoặc "Nhận 10-15% tắt".
existence: Gợi ý không cụ thể. Trong trường hợp này, văn bản sẽ có nội dung: "Mua kèm miễn phí mức giá thấp hơn đăng ký".

Tìm hiểu thêm về cách xử lý giao diện người dùng trong Mức giá ưu đãi chọn lọc và ví dụ.

<IneligibilityReason>

Required

enum

Các giá trị hợp lệ là:

program_member: Hiện mức phí thông qua biện pháp xử lý giao diện người dùng đối với giá không nhìn thấy được cho thành viên.

Ví dụ về mức giá ưu đãi chọn lọc

Phần này bao gồm các ví dụ về giá không nhìn thấy được cho thành viên (cơ bản) và giá dành cho thành viên các ví dụ ẩn (nhiều điều kiện). Bạn cũng có thể đăng giá dành cho thành viên cho một nhóm nhỏ người dùng. Để xem ví dụ, hãy xem bài viết Ví dụ về mức giá ưu đãi chọn lọc.

Ví dụ về giá không nhìn thấy được cho thành viên (cơ bản)

Mức chiết khấu chính xác

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

Chiết khấu theo khoảng giá trị

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

Mức chiết khấu dựa trên gợi ý

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

Ví dụ về giá không nhìn thấy được cho thành viên (nhiều điều kiện)

op="any"

Giá theo danh sách đối tượng cho thành viên + giá không nhìn thấy được cho thành viên (có chiết khấu) đối với người không phải là thành viên

Ví dụ về mức giá ưu đãi chọn lọc này xác định loại giá dành cho thành viên existence nội dung bị ẩn trong giao diện người dùng, sẽ hiển thị cho người dùng chứ không hiển thị cho đối tượng danh sách. Người dùng trong danh sách đối tượng sẽ thấy tỷ lệ đối tượng.

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

Giá không nhìn thấy được dành cho thành viên chỉ áp dụng cho người dùng trong danh sách đối tượng

Ví dụ về mức giá ưu đãi chọn lọc này chỉ định loại giá dành cho thành viên exact bị ẩn Nội dung trong giao diện người dùng, được sửa đổi bằng văn bản bổ sung "cộng Wi-Fi miễn phí". Giao diện người dùng này cách xử lý sẽ hiển thị cho những người dùng khớp với danh sách đối tượng.

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

Giao diện người dùng rõ ràng/hiển thị

Ví dụ này cho thấy cách chỉ định giá dành cho thành viên với hai phiên bản giao diện người dùng (giao diện người dùng rõ ràng và dễ thấy) đối với những người dùng trong danh sách đối tượng và giá bị ẩn cho tất cả người dùng khác.

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

Sửa đổi cách hiển thị nội dung trên giao diện người dùng đối với mức giá ưu đãi chọn lọc.

Phần tử <RateModification> xuất hiện ở vị trí sau đây trong hệ thống phân cấp XML của quy tắc giá:

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

Thuộc tính

Phần tử <RateModification> không có thuộc tính nào.

Phần tử con

Phần tử <RateModification> có các phần tử con như sau:

Thành phần con Bắt buộc? Loại Mô tả

Thành phần con	Bắt buộc?	Loại	Mô tả
`<HotelAmenity>`	Optional	enum	Kết hợp với `<MembershipProgram>` và `<RateIneligibility>` để sửa đổi biện pháp xử lý giao diện người dùng đối với giá không nhìn thấy được cho thành viên. Các giá trị hợp lệ là: `free_wifi`: Thêm `plus free wifi` vào văn bản.
`<PriceMultiplier>`	Optional	float	Điều chỉnh giá bằng cách nhân giá trị này với giá cơ bản, thuế và các khoản phí. Ví dụ: nếu `PriceMultiplier` = 0, 9, cơ số giá = 100 đô la, thuế = 20 đô la, phí = 10 đô la; sau đó áp dụng hệ số: giá cơ bản = 90 USD, thuế = 18 USD, phí = 9 USD. Nhờ đó, bạn có thể áp dụng chiết khấu cho tất cả mức giá có một mức giá nhất định .

<HotelAmenity>

Optional

enum

Kết hợp với <MembershipProgram> và <RateIneligibility> để sửa đổi biện pháp xử lý giao diện người dùng đối với giá không nhìn thấy được cho thành viên.

Các giá trị hợp lệ là:

free_wifi: Thêm plus free wifi vào văn bản.

<PriceMultiplier>

Optional

float

Điều chỉnh giá bằng cách nhân giá trị này với giá cơ bản, thuế và các khoản phí. Ví dụ: nếu PriceMultiplier = 0, 9, cơ số giá = 100 đô la, thuế = 20 đô la, phí = 10 đô la; sau đó áp dụng hệ số: giá cơ bản = 90 USD, thuế = 18 USD, phí = 9 USD.

Nhờ đó, bạn có thể áp dụng chiết khấu cho tất cả mức giá có một mức giá nhất định .

Ví dụ về mức giá ưu đãi chọn lọc

Tiện nghi của khách sạn

Giá không nhìn thấy được cho thành viên áp dụng cho tất cả người dùng (chiết khấu theo khoảng giá trị) và Wi-Fi miễn phí

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

Hệ số giá

Áp dụng chiết khấu 5% cho mức giá trên thiết bị di động trong Nguồn cấp dữ liệu giá

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

Tài liệu tham khảo về quy tắc giá viết bằng XML

<RateRuleSettings>

Cú pháp

Thuộc tính

Phần tử con

Ví dụ về giá phòng có điều kiện

Người dùng thiết bị di động

Người dùng ở Hoa Kỳ

<RateRule>

Cú pháp

Thuộc tính

Phần tử con

<UserRateCondition>

Cú pháp

Thuộc tính

Phần tử con

Ví dụ về giá phòng có điều kiện

Tỷ lệ phần trăm người dùng

Người dùng ở Vương quốc Anh và người dùng thiết bị di động

Nhật Bản và không phải Nhật Bản

Any, all và none

Ví dụ về mức giá ưu đãi chọn lọc

Giá nhìn thấy được cho thành viên 1

Giá nhìn thấy được cho thành viên 2

Giá theo danh sách đối tượng 1

Giá theo danh sách đối tượng 2

<RateIneligibility>

Cú pháp

Thuộc tính

Phần tử con

Ví dụ về mức giá ưu đãi chọn lọc

Ví dụ về giá không nhìn thấy được cho thành viên (cơ bản)

Mức chiết khấu chính xác

Chiết khấu theo khoảng giá trị

Mức chiết khấu dựa trên gợi ý

Ví dụ về giá không nhìn thấy được cho thành viên (nhiều điều kiện)

op=&quot;any&quot;

op=&quot;all&quot;

Giao diện người dùng rõ ràng/hiển thị

<RateModification>

Thuộc tính

Phần tử con

Ví dụ về mức giá ưu đãi chọn lọc

Tiện nghi của khách sạn

Hệ số giá

`<RateRuleSettings>`

`<RateRule>`

`<UserRateCondition>`

`<RateIneligibility>`

op="any"

op="all"

`<RateModification>`