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

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

กฎเกี่ยวกับอัตราแต่ละข้อต้องมี id ซึ่งอ้างอิงได้ใน <Rate> ของข้อความธุรกรรม <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

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

ตัวอย่างต่อไปนี้แสดงวิธีพื้นฐานในการกำหนดราคาสำหรับลูกค้าที่เข้าเกณฑ์

เราขอแนะนำให้อ้างอิงเงื่อนไขที่กำหนดไว้ล่วงหน้าดังที่แสดงในตัวอย่างผู้ใช้อุปกรณ์เคลื่อนที่

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

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

กำหนดเงื่อนไขอย่างน้อย 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: รวมผู้ใช้ปลายทางที่ตรงกับเงื่อนไขทั้งหมดซึ่งกำหนดโดยกฎเกี่ยวกับอัตรานี้ ใช้ค่านี้ไม่ได้ เมื่อเงื่อนไขอย่างน้อย 1 รายการคือ <UserListId> เว้นแต่ว่าจะกำหนดเงื่อนไขอื่นเพียงรายการเดียวคือ <AlwaysEligibleMembershipProgram> หรือ <MembershipProgram>
  • any: รวมผู้ใช้ปลายทางที่ตรงกับเงื่อนไขใดก็ตามซึ่งกำหนดโดยกฎเกี่ยวกับอัตรานี้
  • none: ยกเว้นผู้ใช้ปลายทางที่ตรงกับเงื่อนไขซึ่งกำหนดโดยกฎเกี่ยวกับอัตรานี้ ใช้ค่านี้ไม่ได้เมื่อเงื่อนไขอย่างน้อย 1 รายการคือ <UserListId>
reference_id Optional string

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

เมื่อมี reference_id

  • ระบบจะไม่แยกวิเคราะห์องค์ประกอบย่อย
  • ไม่ควรมี id และ op

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

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

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

ระบุว่าอัตราจะใช้ตัวเลือก UI ที่มองเห็นได้ของอัตราสมาชิก

ค่าขององค์ประกอบนี้อาจเป็นชื่อโปรแกรมการเป็นสมาชิกใดก็ได้
<Description> Optional string อธิบาย <UserRateCondition> การดำเนินการนี้มีไว้เพื่อวัตถุประสงค์ด้านเอกสารและไม่มีผลต่อความสามารถของฟีเจอร์
<LanguageCode> Optional string ระบุว่าระบบจะเสนอราคาให้กับผู้ใช้ที่ใช้ภาษาตรงกับ รหัสภาษาแบบ 2 ตัวอักษรนี้

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

<?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 รวมถึงใช้ all เพื่อกำหนดให้ผู้ใช้จับคู่เงื่อนไขหลายรายการได้ดังที่แสดงในกฎเกี่ยวกับอัตรา au_nz_mobile_tablet กฎเกี่ยวกับอัตรา 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 ที่ซ่อนอยู่ของอัตราสมาชิก

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

ส่วนนี้จะประกอบด้วยตัวอย่างที่ซ่อนอยู่ของอัตราสมาชิก (พื้นฐาน) และตัวอย่างที่ซ่อนอยู่ของอัตราสมาชิก (หลายเงื่อนไข) นอกจากนี้ คุณยังแสดงอัตราสมาชิกต่อผู้ใช้กลุ่มย่อยได้เช่นกัน หากต้องการแสดงราคาสำหรับสมาชิก คุณควรส่งราคาสำหรับสมาชิกรายเดียว สำหรับแพ็กเกจห้องพักที่ถูกที่สุดก่อน ตามด้วยราคาแพ็กเกจห้องพักที่เหลือ ไม่อนุญาตให้กำหนดราคาสำหรับอัตราสมาชิกหลายรายการ

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

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

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

<?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 แบบโปร่งใสและ UI ที่มองเห็นได้) สำหรับผู้ใช้ในรายการกลุ่มเป้าหมาย และอัตราที่ซ่อนอยู่สำหรับผู้ใช้รายอื่นๆ ทั้งหมด

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>existence</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition op="any">
      <MembershipProgram>[enter program name here]</MembershipProgram>
      <UserRateCondition op="all">
        <UserListId>[enter you audience list id here]</UserListId>
        <AlwaysEligibleMembershipProgram>program_name</AlwaysEligibleMembershipProgram>
      </UserRateCondition>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

<RateModification>

แก้ไขตัวเลือก 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

การดำเนินการนี้จะช่วยให้คุณใช้ส่วนลดกับอัตราทั้งหมดที่มีกฎเกี่ยวกับอัตราที่เฉพาะเจาะจงได้

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

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

อัตราสมาชิกที่ซ่อนอยู่สำหรับผู้ใช้ทั้งหมด (ส่วนลดของช่วง) + 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>