การอ้างอิง 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

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

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

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

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

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

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

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

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

องค์ประกอบ <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 ที่ซ่อนอยู่ของอัตราสมาชิก

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

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

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

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

<?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=&quot;any&quot;

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

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

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

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

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