หน้านี้ได้รับการแปลโดย 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>` ของข้อความ Transaction หรือใน URL ของหน้า Landing Page
`<UserRateCondition>`	Optional	`<UserRateCondition>`	กำหนดเงื่อนไขอย่างน้อย 1 รายการที่หากตรงกันจะส่งผลให้เกิดการแสดงราคาสำหรับลูกค้าที่เข้าเกณฑ์หรืออัตราส่วนลดเฉพาะบุคคล คุณจะกำหนดเงื่อนไขโดยแทรกในบรรทัดได้โดยใช้องค์ประกอบย่อย `<UserRateCondition>` หรือโดยการอ้างอิงไปยังองค์ประกอบ `<UserRateCondition>` อื่นโดยใช้แอตทริบิวต์ `reference_id` หรือทั้งในบรรทัดและการอ้างอิง แต่ `<UserRateCondition>` ที่มี `reference_id` ต้องมีรายการย่อย 0 รายการ `<UserRateCondition>` ระดับบนสุดภายใต้ `<RateRuleSettings>` ต้องมีแอตทริบิวต์ `id`

<RateRule>

Required

<RateRule>

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

id

จำเป็น

string

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

จำนวนอักขระสูงสุดที่อนุญาตคือ 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>`

องค์ประกอบ <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>` เว้นแต่จะกำหนดเงื่อนไขอื่นไว้เพียง 1 รายการ คือ `<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> เว้นแต่จะกำหนดเงื่อนไขอื่นไว้เพียง 1 รายการ คือ <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	ระบุว่าระบบจะเสนอราคาให้กับผู้ใช้ที่ใช้ภาษาตรงกับ รหัสภาษาแบบ 2 ตัวอักษรนี้
`<MaxUsersPercent>`	Optional	float	ระบุว่าระบบจะสุ่มเสนอราคาให้กับผู้ใช้ปลายทางตามเปอร์เซ็นต์นี้ ค่าต้องเป็นจำนวนเต็มระหว่าง 0 ถึง 100 เช่น 20 จะกำหนดเป้าหมาย 20% ของผู้ใช้ปลายทาง
`<MembershipProgram>`	Optional	string	ระบุว่าอัตราจะใช้ตัวเลือก UI ของโปรแกรมการเป็นสมาชิกตามที่ `<IneligibilityReason>` ของ `<RateIneligibility>` กําหนด ต้องระบุ `<RateIneligibility>` เพื่อให้ `<MembershipProgram>` ใช้ได้ ค่าของ `<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="ใดๆ"

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

ตัวอย่างอัตราส่วนลดเฉพาะบุคคลนี้จะระบุประเภท 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>