مرجع XML لقواعد السعر

يحدد ملف XML الخاص بقواعد الأسعار قواعد عرض الأسعار المشروطة الأسعار الخاصة. يمكنك إضافة ملف XML لقواعد الأسعار أو تعديله باستخدام صفحة قواعد الأسعار في Hotel Center لمزيد من المعلومات حول الأسعار المشروطة والأسعار الخاصة، يُرجى الاطّلاع على الأسعار المشروطة والخاصة:

تتطلّب كل قاعدة أسعار السمة id، والتي يمكن الإشارة إليها في <Rate> في رسالة حول المعاملة. <Rate> الذي المراجع، لا يتمّ عرض رقم تعريف قاعدة أسعار إلا للمستخدمين ووفقًا للشروط المحددة في قاعدة السعر. يمكن أيضًا الإشارة إلى رقم تعريف قاعدة الأسعار باستخدام متغير في عنوان URL للصفحة المقصودة.

<RateRuleSettings>

العنصر الجذري في ملف قواعد الأسعار بتنسيق XML تشير رسالة الأشكال البيانية يحتوي العنصر <RateRuleSettings> (المعروف سابقًا باسم <PrivateRates>) على:

  • عناصر <UserRateCondition> التي تحدد الشروط لمطابقة الأسعار المشروطة والخاصة. على سبيل المثال، يمكنك إنشاء سعر مشروط يتطابق مع حالة جميع المستخدمين في معدل واحدة.

  • <RateRule> عناصر يحدد كل منها قاعدة أسعار الإحالة في <Rate> في رسالة "معاملة". على كل تحدّد السمة <RateRule> الشروط ومعالجة واجهة المستخدم. التي تنشئ سعرًا مشروطًا أو خاصًا.

يظهر العنصر <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>

السمات

لا يتضمّن العنصر <RateRuleSettings> أي سمات.

العناصر الفرعية

يحتوي العنصر <RateRuleSettings> على العناصر الثانوية التالية:

عنصر ثانوي مطلوب؟ النوع الوصف
<RateRule> Required <RateRule>

تحدد شروط المطابقة والتعديلات والأهلية يقدّم سعرًا مشروطًا أو خاصًا. يجب توفّر id. والتي يمكن الإشارة إليها في <Rate> من المعاملة أو في رسالة عنوان URL للصفحة المقصودة.
<UserRateCondition> Optional <UserRateCondition>

تحدد شرطًا واحدًا أو أكثر تؤدي مطابقته إلى الأسعار المشروطة أو الخاصة التي يتم عرضها.

يمكن تحديد الشروط إما مضمّنة باستخدام <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>

حاوية لتحديد:

  • شروط عرض سعر
  • التعديلات، إن وجدت، على السعر ومعالجة واجهة المستخدم للسعر
  • استخدام عمليات معالجة واجهة المستخدم المخفية للأسعار الخاصة

يظهر العنصر <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>

السمات

يحتوي العنصر <RateRule> على السمات التالية:

السمة مطلوب؟ النوع الوصف
id مطلوب سلسلة

معرّف فريد لقاعدة السعر وتتم الإشارة إلى هذا المعرّف باستخدام السمة rate_rule_id لـ <Rate> في معاملة لعرض سعر مشروط أو خاص. قاعدة السعر يمكن أيضًا الإشارة إلى id باستخدام متغيّر وشروط. في صفحة مقصودة عنوان URL.

الحد الأقصى لعدد الأحرف المسموح به هو 40 حرفًا.

العناصر الفرعية

يحتوي العنصر <RateRule> على العناصر الثانوية التالية:

عنصر ثانوي مطلوب؟ النوع الوصف
<RateIneligibility> Optional <RateIneligibility> تحدد القيم التي تحدد معالجة واجهة المستخدم المحددة السعر: <MembershipProgram>

صالح فقط عند تحديد <MembershipProgram> في <UserRateCondition>.
<UserRateCondition> Required <UserRateCondition>

تحدد شرطًا واحدًا أو أكثر تؤدي مطابقته إلى الأسعار المشروطة أو الخاصة التي يتم عرضها.

يمكن تحديد الشروط إما مضمّنة باستخدام <UserRateCondition> العناصر الثانوية، بالإشارة إلى عنصر <UserRateCondition> آخر باستخدام السمة reference_id أو كل من البيانات المضمَّنة أو المرجع.

ومع ذلك، لاحظ أنه عندما يكون <UserRateCondition> فرعيًا من <RateRule>، لا يمكن أن يحتوي العنصر <UserRateCondition> على سمة id ولا يمكن الإشارة إليها باستخدام سمة أخرى <UserRateCondition>
<RateModification> Optional <RateModification> لتعديل معالجة واجهة المستخدم للأسعار الخاصة.
<PromoCode> Optional string تحدّد هذه السياسة رمزًا ليتم ربطه بالسعر إذا كانت قاعدة السعر هذه. المنهجية. يظهر ذلك في الصفحة المقصودة "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>

السمات

يحتوي العنصر <UserRateCondition> على السمات التالية:

السمة مطلوب؟ النوع الوصف
id Required (if top-level under <RateRuleSettings>) string

معرّف فريد لسمة <UserRateCondition> هذه يمكن الإشارة إليها عن طريق السمة id <RateRule> أو السمة <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

للإشارة إلى أنّ السعر سيستخدم واجهة المستخدم المرئية للسعر الخاص بالمشتركين العلاج.

يمكن أن تكون قيمة هذا العنصر أي اسم برنامج عضوية.
<Description> Optional string ويصف هذا السمة <UserRateCondition>. هذا القسم مخصّص للتوثيق. وليس لها أي تأثير في إمكاناتها.
<LanguageCode> Optional string لتحديد أنّ السعر سيتم عرضه للمستخدمين الذين يستخدمون لغتهم تتطابق مع هذا المكوَّن من حرفين رمز اللغة.
<MaxUsersPercent> Optional float

للإشارة إلى أنّه سيتم عرض السعر بشكل عشوائي لهذه النسبة المئوية من المستخدمين النهائيين.

يجب أن تكون القيمة عددًا صحيحًا بين 0 و100 (ضمنًا). بالنسبة على سبيل المثال، 20 تستهدف 20٪ من المستخدمين النهائيين.
<MembershipProgram> Optional string

للإشارة إلى أنّ السعر سيستخدم معالجة واجهة المستخدم لبرنامج الاشتراك على النحو الذي تحدّده <IneligibilityReason> <RateIneligibility>

لكي تكون السمة <MembershipProgram> صالحة، يجب تحديد <RateIneligibility>.

يمكن أن تكون قيمة <MembershipProgram> أي اسم برنامج العضوية في YouTube.
<UserRateCondition> Optional <UserRateCondition>

تحدد شرطًا واحدًا أو أكثر تؤدي مطابقته إلى الأسعار المشروطة أو الخاصة التي يتم عرضها.

يجب أن يحتوي الحقل <UserRateCondition> الذي يتضمّن reference_id على 0. الأطفال.
<UserCountry> Optional string

مستند CLDR رمز البلد، مثل DE أو FR. لاحظ ما يلي: بالنسبة إلى بعض البلدان، لا يكون رمز CLDR هو نفسه رمز ISO المكون من حرفين الرمز. رموز CLDR للمناطق غير متاحة.

لتحديد أنّ المستخدم يجب أن يكون مقيمًا في البلد المحدّد. تحدِّد Google بلد المستخدم النهائي من عنوان IP الخاص به.
<UserDeviceType> Optional enum تحدِّد هذه السياسة شرط نوع الجهاز. القيم المسموح بها هي:
  • mobile
  • desktop
  • tablet
<UserListId> Optional string رقم تعريف قائمة مستخدِمي "إعلانات Google" لقائمة مستخدمين.

لا يمكن استخدام هذا الشرط إلا مع <AlwaysEligibleMembershipProgram> أو <MembershipProgram>، أو عندما تكون قيمة op any
<UserSignedIn> Optional boolean قيمة منطقية تحدد ما إذا كان يجب على المستخدم تسجيل الدخول إلى حسابه على Google. تشير القيمة true إلى أن يجب أن يكون المستخدم مسجّلاً الدخول. تشير القيمة false إلى أن يجب ألا يسجّل المستخدم الدخول. إذا كنت لا تهتم بما إذا كان المستخدم عند تسجيل الدخول أو الخروج، لا تضمِّن <UserSignedIn> الشرط.
<IsDomestic> Optional boolean قيمة منطقية تحدد ما إذا كان يجب أن يكون المستخدم من واجهة نفس البلد الذي يقع فيه الفندق. قيمة true إلى أنّ المستخدم يجب أن يكون من نفس بلد الفندق. حاسمة تشير القيمة false إلى أن المستخدم قد يكون من بلد بخلاف بلد الفندق. إذا كنت تريد استخدام حبيبات أكثر دقة التحكم، يمكنك استخدام شرط <UserCountry>.

أمثلة على الأسعار المشروطة

النسبة المئوية للمستخدمين

يوضح مثال الأسعار المشروطة التالي أن المعدل تُعرَض عشوائيًا على عشرين بالمائة من المستخدمين:

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

اليابان وليس اليابان

يوضّح مثال الأسعار المشروطة التالي قاعدة أسعار واحدة تتطابق مع المستخدمين في اليابان وقاعدة أسعار أخرى تطابق المستخدمين في بقية World (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

يعرض مثال الأسعار الخاصة هذا كيفية تحديد سعر مخصّص للمشتركين. معالجة واجهة المستخدم لقوائم المستخدمين المتعددة:

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

يشير إلى كيفية عرض معالجة واجهة المستخدم المخفية لمعدّل الأعضاء. إذا لم يكن كذلك في هذه الحالة، لا يتم عرض معالجة واجهة المستخدم المخفية لمعدل المشتركين.

لاستخدام <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>

السمات

لا يتضمّن العنصر <RateIneligibility> أي سمات.

العناصر الفرعية

يحتوي العنصر <RateIneligibility> على العناصر الثانوية التالية:

عنصر ثانوي مطلوب؟ النوع الوصف
<IneligibilityType> Required enum

تحدد كيف سيظهر النص (المعروض بجانب السعر المشطوب) لوصف المعدل المخفي.

القيم الصالحة هي:

  • exact: نسبة مئوية للخصم سيظهر النص التالي: "احصل على خصم X% مع تسجيل مجاني".
  • price_band: نطاق خصومات والنص المكتوب هو "احصل على خصم X-Y% مع التسجيل مجانًا". للخصومات من 1 إلى %5، سيظهر النص "احصل على خصم يصل إلى% 5". ستوفّر خصومات أكبر تظهر بزيادات من 5 نقاط، مثل "احصل على خصم من %5 إلى %10" أو "احصل على %10 و%15" ".
  • existence: تلميح غير محدد. في هذه الحالة، سيظهر النص التالي: "احصل على سعر أقل مع مجانًا التسجيل".

مزيد من المعلومات حول عمليات معالجة واجهة المستخدم في الأسعار الخاصة التفاصيل والأمثلة.
<IneligibilityReason> Required enum

القيم الصالحة هي:

  • program_member: يعرض السعر باستخدام معالجة واجهة المستخدم المخفية لمعدل الأعضاء.

أمثلة على الأسعار الخاصة

يتضمّن هذا القسم أمثلة مخفية لأسعار المشتركين (أساسية) وأسعار خاصة بالمشتركين. أمثلة مخفية (شروط متعددة). يمكنك أيضًا عرض الأسعار المخصّصة للمشتركين مجموعات فرعية من المستخدمين. للاطّلاع على أمثلة، يمكنك الاطّلاع على أمثلة على الأسعار الخاصة.

أمثلة مخفية لأسعار المشتركين (أساسية)

الخصم نفسه

<?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 للسعر الخاص بالمشتركين. معالجة واجهة المستخدم المخفية، والتي ستظهر للمستخدمين وليس للجمهور الحالية. سيظهر معدّل الجمهور للمستخدمين في قائمة المستخدمين.

<?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 لمعدّل العضويات المخفي. معالجة واجهة المستخدم، مُعدَّلة من خلال النص الإضافي "بالإضافة إلى خدمة Wi-Fi مجانية". واجهة المستخدم هذه ستظهر للمستخدمين الذين يتطابقون مع قائمة المستخدمين.

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

واجهة مستخدم شفافة/مرئية

يعرض هذا المثال كيفية تحديد السعر الخاص بالمشتركين من خلال معالجتَين في واجهة المستخدم. (واجهة مستخدم شفافة ومرئية) للمستخدمين في قائمة المستخدمين والأسعار المخفية لجميع المستخدمين الآخرين.

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

لتعديل معالجة واجهة المستخدم للأسعار الخاصة.

يظهر العنصر <RateModification> في المكان التالي في تدرّج XML لقواعد الأسعار:

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

السمات

لا يتضمّن العنصر <RateModification> أي سمات.

العناصر الفرعية

يحتوي العنصر <RateModification> على العناصر الثانوية التالية:

عنصر ثانوي مطلوب؟ النوع الوصف
<HotelAmenity> Optional enum

الدمج مع <MembershipProgram> <RateIneligibility> لتعديل طريقة المعالجة المخفية لمعدّل الاشتراك في واجهة المستخدم.

القيم الصالحة هي:

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