หน้านี้ได้รับการแปลโดย Cloud Translation API

การอ้างอิง XML ของกฎเกี่ยวกับอัตรา

ไฟล์ XML ของกฎเกี่ยวกับอัตรากำหนดกฎในการแสดงราคาสำหรับลูกค้าที่เข้าเกณฑ์และ อัตราส่วนลดเฉพาะบุคคล คุณเพิ่มหรือแก้ไขไฟล์ XML ของกฎเกี่ยวกับอัตราได้โดยใช้ หน้ากฎเกี่ยวกับอัตราใน Hotel Center ดูข้อมูลเพิ่มเติมเกี่ยวกับราคาสำหรับลูกค้าที่เข้าเกณฑ์และอัตราส่วนลดเฉพาะบุคคลได้ที่ ราคาสำหรับลูกค้าที่เข้าเกณฑ์และอัตราส่วนลดเฉพาะบุคคล

กฎเกี่ยวกับอัตราแต่ละข้อต้องมี id ซึ่งสามารถอ้างอิงได้ใน <Rate> ของข้อความ Transaction <Rate> ที่ อ้างอิงถึงรหัสกฎเกี่ยวกับอัตราจะแสดงต่อผู้ใช้ภายใต้เงื่อนไขเท่านั้น ตามกฎเกี่ยวกับอัตรา นอกจากนี้ คุณยังอ้างอิงรหัสกฎเกี่ยวกับอัตราได้โดยใช้ ใน URL ของหน้า Landing Page

`<RateRuleSettings>`

องค์ประกอบรูทของไฟล์ XML ของกฎเกี่ยวกับอัตรา องค์ประกอบ <RateRuleSettings> (ก่อนหน้านี้เรียกว่า <PrivateRates>) ประกอบด้วย

องค์ประกอบ <UserRateCondition> ที่กำหนดเงื่อนไข เพื่อจับคู่กับราคาสำหรับลูกค้าที่เข้าเกณฑ์และอัตราส่วนลดเฉพาะบุคคล ตัวอย่างเช่น คุณสามารถสร้าง ราคาสำหรับลูกค้าที่เข้าเกณฑ์ที่ตรงกับเงื่อนไขของผู้ใช้ทุกรายใน ประเทศ
องค์ประกอบ <RateRule> ที่แต่ละรายการกำหนดกฎเกี่ยวกับอัตรา การอ้างอิงใน <Rate> ในข้อความ Transaction ชิ้น <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>

Attributes

องค์ประกอบ <RateRuleSettings> ไม่มีแอตทริบิวต์

องค์ประกอบลูก

องค์ประกอบ <RateRuleSettings> มีองค์ประกอบย่อยต่อไปนี้

องค์ประกอบย่อย จำเป็นหรือไม่ ประเภท คำอธิบาย

องค์ประกอบย่อย	จำเป็นหรือไม่	ประเภท	คำอธิบาย
`<RateRule>`	Required	`<RateRule>`	กำหนดเงื่อนไขการจับคู่ การแก้ไข และสิทธิ์สำหรับ การแสดงราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคล ต้องใช้ `id` ซึ่งสามารถอ้างอิงได้ใน `<Rate>` ของธุรกรรม ข้อความหรือใน URL ของหน้า Landing Page
`<UserRateCondition>`	Optional	`<UserRateCondition>`	กำหนดเงื่อนไขอย่างน้อย 1 ข้อที่เมื่อจับคู่แล้วจะได้ผลลัพธ์ ราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคลที่แสดง คุณกำหนดเงื่อนไขแบบแทรกในบรรทัดได้โดยใช้ องค์ประกอบย่อย `<UserRateCondition>` รายการ โดยอ้างอิงไปยังองค์ประกอบอื่น `<UserRateCondition>` โดยใช้องค์ประกอบ `reference_id` หรือทั้งในหน้าและตามการอ้างอิง อย่างไรก็ตาม `<UserRateCondition>` ที่มี `reference_id` ต้องมี 0 `<UserRateCondition>` ระดับบนสุดภายใต้ `<RateRuleSettings>` ต้อง มีแอตทริบิวต์ `id`

<RateRule>

Required

<RateRule>

กำหนดเงื่อนไขการจับคู่ การแก้ไข และสิทธิ์สำหรับ การแสดงราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคล ต้องใช้ id ซึ่งสามารถอ้างอิงได้ใน <Rate> ของธุรกรรม ข้อความหรือใน URL ของหน้า Landing Page

<UserRateCondition>

Optional

<UserRateCondition>

กำหนดเงื่อนไขอย่างน้อย 1 ข้อที่เมื่อจับคู่แล้วจะได้ผลลัพธ์ ราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคลที่แสดง

คุณกำหนดเงื่อนไขแบบแทรกในบรรทัดได้โดยใช้ องค์ประกอบย่อย <UserRateCondition> รายการ โดยอ้างอิงไปยังองค์ประกอบอื่น <UserRateCondition> โดยใช้องค์ประกอบ reference_id หรือทั้งในหน้าและตามการอ้างอิง อย่างไรก็ตาม <UserRateCondition> ที่มี reference_id ต้องมี 0

<UserRateCondition> ระดับบนสุดภายใต้ <RateRuleSettings> ต้อง มีแอตทริบิวต์ 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>

Attributes

องค์ประกอบ <RateRule> มีแอตทริบิวต์ต่อไปนี้

แอตทริบิวต์ จำเป็นหรือไม่ ประเภท คำอธิบาย

แอตทริบิวต์	จำเป็นหรือไม่	ประเภท	คำอธิบาย
`id`	จำเป็น	สตริง	ตัวระบุที่ไม่ซ้ำกันสำหรับกฎเกี่ยวกับอัตรา รหัสนี้อ้างอิงโดยใช้ แอตทริบิวต์ `rate_rule_id` ของ `<Rate>` ในธุรกรรม เพื่อแสดงราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคล กฎเกี่ยวกับอัตรา คุณอ้างอิง `id` โดยใช้ตัวแปรและเงื่อนไขได้ด้วย ในหน้า Landing Page URL จำนวนอักขระสูงสุดที่อนุญาตคือ 40 ตัว

id

จำเป็น

สตริง

ตัวระบุที่ไม่ซ้ำกันสำหรับกฎเกี่ยวกับอัตรา รหัสนี้อ้างอิงโดยใช้ แอตทริบิวต์ rate_rule_id ของ <Rate> ในธุรกรรม เพื่อแสดงราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคล กฎเกี่ยวกับอัตรา คุณอ้างอิง id โดยใช้ตัวแปรและเงื่อนไขได้ด้วย ในหน้า Landing Page URL

จำนวนอักขระสูงสุดที่อนุญาตคือ 40 ตัว

องค์ประกอบลูก

องค์ประกอบ <RateRule> มีองค์ประกอบย่อยต่อไปนี้

องค์ประกอบย่อย	จำเป็นหรือไม่	ประเภท	คำอธิบาย
`<RateIneligibility>`	Optional	`<RateIneligibility>`	ระบุค่าที่กำหนดตัวเลือก UI เฉพาะสำหรับ อัตรา `<MembershipProgram>` ใช้ได้เฉพาะเมื่อมีการระบุ `<MembershipProgram>` เท่านั้น ใน `<UserRateCondition>`
`<UserRateCondition>`	Required	`<UserRateCondition>`	กำหนดเงื่อนไขอย่างน้อย 1 ข้อที่เมื่อจับคู่แล้วจะได้ผลลัพธ์ ราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคลที่แสดง คุณจะกำหนดเงื่อนไขแบบแทรกในบรรทัดได้โดยใช้ `<UserRateCondition>` องค์ประกอบย่อย ด้วยการอ้างอิงถึง `<UserRateCondition>` อื่นโดยใช้ แอตทริบิวต์ `reference_id` หรือทั้งในหน้าและตาม ข้อมูลอ้างอิง อย่างไรก็ตาม โปรดทราบว่าเมื่อ `<UserRateCondition>` เป็นองค์ประกอบย่อยของ `<RateRule>` องค์ประกอบ `<UserRateCondition>` ต้องไม่มี `id` และไม่สามารถอ้างอิงโดยแอตทริบิวต์อื่น `<UserRateCondition>`
`<RateModification>`	Optional	`<RateModification>`	แก้ไขตัวเลือก UI สำหรับอัตราส่วนลดเฉพาะบุคคล
`<PromoCode>`	Optional	string	ระบุโค้ดที่จะเชื่อมโยงกับอัตราหากกฎเกี่ยวกับอัตรานี้ ใช้แล้ว แสดงในหน้า Landing Page ของ `PROMO-CODE` ตัวแปร

`<UserRateCondition>`

กำหนดเงื่อนไขอย่างน้อย 1 รายการที่เมื่อจับคู่แล้วจะได้ผลลัพธ์แบบมีเงื่อนไขหรือ อัตราส่วนลดเฉพาะบุคคล

องค์ประกอบ <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>

Attributes

องค์ประกอบ <UserRateCondition> มีแอตทริบิวต์ต่อไปนี้

แอตทริบิวต์ จำเป็นหรือไม่ ประเภท คำอธิบาย

แอตทริบิวต์	จำเป็นหรือไม่	ประเภท	คำอธิบาย
`id`	Required (if top-level under `<RateRuleSettings>`)	string	ตัวระบุที่ไม่ซ้ำกันสำหรับ `<UserRateCondition>` นี้ สามารถอ้างอิงได้โดย แอตทริบิวต์ `<RateRule>` `id` หรือตาม`<UserRateCondition>` `reference_id`
`op`	Optional	enum	ต้องระบุแอตทริบิวต์ `op` เมื่อ `<UserRateCondition>` มี องค์ประกอบย่อยหลายรายการ ค่าแอตทริบิวต์อาจเป็นค่าใดค่าหนึ่ง ดังต่อไปนี้: `all`: รวมผู้ใช้ปลายทางที่ตรงกับ เงื่อนไขที่กำหนดโดยกฎเกี่ยวกับอัตรานี้ ใช้ค่านี้ไม่ได้ เมื่อเงื่อนไขข้อใดข้อหนึ่งคือ `<UserListId>` เว้นแต่จะ เงื่อนไขอื่นเพียงรายการเดียว ได้แก่ `<AlwaysEligibleMembershipProgram>` หรือ `<MembershipProgram>` คือคำนิยาม `any`: รวมผู้ใช้ปลายทางที่ตรงกับรายการใดรายการหนึ่ง เงื่อนไขที่กำหนดโดยกฎเกี่ยวกับอัตรานี้ `none`: ยกเว้นผู้ใช้ปลายทางที่ตรงกับรายการใดรายการหนึ่ง เงื่อนไขที่กำหนดโดยกฎเกี่ยวกับอัตรานี้ ค่านี้ไม่สามารถเป็น ใช้เมื่อเงื่อนไขข้อใดข้อหนึ่งคือ `<UserListId>`
`reference_id`	Optional	string	กำหนดองค์ประกอบนี้เป็นการอ้างอิงไปยังองค์ประกอบอื่นที่กำหนดไว้ล่วงหน้า `<UserRateCondition>` ที่มี `id` ที่ตรงกัน เมื่อ `reference_id` แสดงอยู่: ไม่สามารถแยกวิเคราะห์องค์ประกอบย่อย ไม่ควรมี `id` และ `op`

id

Required (if top-level under <RateRuleSettings>)

string

ตัวระบุที่ไม่ซ้ำกันสำหรับ <UserRateCondition> นี้ สามารถอ้างอิงได้โดย แอตทริบิวต์ <RateRule> id หรือตาม<UserRateCondition> reference_id

op

Optional

enum

ต้องระบุแอตทริบิวต์ op เมื่อ <UserRateCondition> มี องค์ประกอบย่อยหลายรายการ ค่าแอตทริบิวต์อาจเป็นค่าใดค่าหนึ่ง ดังต่อไปนี้:

all: รวมผู้ใช้ปลายทางที่ตรงกับ เงื่อนไขที่กำหนดโดยกฎเกี่ยวกับอัตรานี้ ใช้ค่านี้ไม่ได้ เมื่อเงื่อนไขข้อใดข้อหนึ่งคือ <UserListId> เว้นแต่จะ เงื่อนไขอื่นเพียงรายการเดียว ได้แก่ <AlwaysEligibleMembershipProgram> หรือ <MembershipProgram> คือคำนิยาม
any: รวมผู้ใช้ปลายทางที่ตรงกับรายการใดรายการหนึ่ง เงื่อนไขที่กำหนดโดยกฎเกี่ยวกับอัตรานี้
none: ยกเว้นผู้ใช้ปลายทางที่ตรงกับรายการใดรายการหนึ่ง เงื่อนไขที่กำหนดโดยกฎเกี่ยวกับอัตรานี้ ค่านี้ไม่สามารถเป็น ใช้เมื่อเงื่อนไขข้อใดข้อหนึ่งคือ <UserListId>

reference_id

Optional

string

กำหนดองค์ประกอบนี้เป็นการอ้างอิงไปยังองค์ประกอบอื่นที่กำหนดไว้ล่วงหน้า <UserRateCondition> ที่มี id ที่ตรงกัน

เมื่อ 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>`	กำหนดเงื่อนไขอย่างน้อย 1 ข้อที่เมื่อจับคู่แล้วจะได้ผลลัพธ์ ราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคลที่แสดง `<UserRateCondition>` ที่มี `reference_id` ต้องมี 0
`<UserCountry>`	Optional	string	CLDR รหัสประเทศ เช่น `DE` หรือ `FR` โปรดทราบว่า สำหรับบางประเทศ รหัส CLDR ไม่เหมือนกับ ISO 2 ตัวอักษร โค้ด ไม่รองรับรหัสภูมิภาค CLDR ระบุว่าผู้ใช้ต้องอยู่ในประเทศที่ระบุ Google จะกำหนดประเทศของผู้ใช้ปลายทางจากที่อยู่ IP
`<UserDeviceType>`	Optional	enum	กำหนดเงื่อนไขประเภทอุปกรณ์ ค่าที่ใช้ได้มีดังนี้ `mobile` `desktop` `tablet`
`<UserListId>`	Optional	string	รหัสรายชื่อผู้ใช้ Google Ads ของรายการกลุ่มเป้าหมาย เงื่อนไขนี้ใช้ได้กับ `<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>

ญี่ปุ่นและไม่ใช่ญี่ปุ่น

ตัวอย่างราคาสำหรับลูกค้าที่เข้าเกณฑ์ต่อไปนี้แสดงกฎเกี่ยวกับอัตรา 1 ข้อที่ตรงกับ ผู้ใช้ในญี่ปุ่นและกฎเกี่ยวกับอัตราอีกข้อที่ตรงกับผู้ใช้ในส่วนที่เหลือของ โลก (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

ตัวอย่างอัตราส่วนลดเฉพาะบุคคลนี้จะแสดงวิธีระบุอัตราสำหรับสมาชิกที่มองเห็นได้ ตัวเลือก 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 ที่ซ่อนอยู่ของอัตราสมาชิกจะไม่แสดง

หากต้องการใช้ <RateIneligibility> ใน <RateRule> <MembershipProgram> ก็ต้อง ในองค์ประกอบ <UserRateCondition> สำหรับ <RateRule>

องค์ประกอบ <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>

Attributes

องค์ประกอบ <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"

อัตราสมาชิกที่ซ่อนอยู่สำหรับผู้ใช้ในรายการกลุ่มเป้าหมายเท่านั้น

ตัวอย่างอัตราส่วนลดเฉพาะบุคคลนี้จะระบุประเภท exact ของอัตราสมาชิกที่ซ่อนอยู่ ตัวเลือก UI ที่แก้ไขด้วยข้อความเพิ่มเติม "รวม 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 2 ตัวเลือก (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>

หมายเหตุ: เมื่อ UserListId ประเมินผลเป็น true อัตราสมาชิกจะแสดงขึ้น ระบบจะป้อนข้อมูลเงื่อนไข AlwaysEligibleMembershipProgram ไว้ด้วยกัน ดังนั้น ทริกเกอร์อัตราสมาชิกที่มองเห็นได้ และเมื่อประเมินเป็น false ที่รวม UserRateCondition ไว้ด้วยจะกลายเป็น false ซึ่งจะลบพารามิเตอร์ AlwaysEligibleMembershipProgram ในกรณีนี้ อัตราสมาชิกที่ซ่อนอยู่ เงื่อนไข &dash;MembershipProgram&dash; จะทริกเกอร์อัตราที่ไม่มีสิทธิ์ทั้งหมด

`<RateModification>`

แก้ไขตัวเลือก UI สำหรับอัตราส่วนลดเฉพาะบุคคล

องค์ประกอบ <RateModification> จะปรากฏในตำแหน่งต่อไปนี้ใน ลำดับชั้น XML ของกฎเกี่ยวกับอัตรา

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

Attributes

องค์ประกอบ <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>

ไวยากรณ์

Attributes

องค์ประกอบลูก

ตัวอย่างราคาสำหรับลูกค้าที่เข้าเกณฑ์

ผู้ใช้อุปกรณ์เคลื่อนที่

ผู้ใช้ในสหรัฐอเมริกา

<RateRule>

ไวยากรณ์

Attributes

องค์ประกอบลูก

<UserRateCondition>

ไวยากรณ์

Attributes

องค์ประกอบลูก

ตัวอย่างราคาสำหรับลูกค้าที่เข้าเกณฑ์

เปอร์เซ็นต์ของผู้ใช้

สหราชอาณาจักรและผู้ใช้อุปกรณ์เคลื่อนที่

ญี่ปุ่นและไม่ใช่ญี่ปุ่น

ใดก็ได้ ทั้งหมด และไม่มี

ตัวอย่างอัตราส่วนลดเฉพาะบุคคล

อัตราสมาชิกที่มองเห็นได้ 1

อัตราสมาชิกที่มองเห็นได้ 2

อัตรารายการกลุ่มเป้าหมาย 1

อัตรารายการกลุ่มเป้าหมาย 2

<RateIneligibility>

ไวยากรณ์

Attributes

องค์ประกอบลูก

ตัวอย่างอัตราส่วนลดเฉพาะบุคคล

ตัวอย่างอัตราสมาชิกที่ซ่อนไว้ (พื้นฐาน)

ส่วนลดที่แน่นอน

ส่วนลดสายนาฬิกา

ส่วนลดที่ไม่แนะนำ

ตัวอย่างอัตราสมาชิกที่ซ่อนไว้ (หลายเงื่อนไข)

op=&quot;any&quot;

op=&quot;all&quot;

UI ที่โปร่งใส/มองเห็นได้

<RateModification>

Attributes

องค์ประกอบลูก

ตัวอย่างอัตราส่วนลดเฉพาะบุคคล

สิ่งอำนวยความสะดวกของโรงแรม

ตัวคูณราคา

`<RateRuleSettings>`

`<RateRule>`

`<UserRateCondition>`

`<RateIneligibility>`

op="any"

op="all"

`<RateModification>`