مرجع 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 على أيّ عناصر ثانوية. يجب أن يحتوي <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>

نقطة رئيسية: لا تتوفّر إمكانية استخدام قائمة المستخدمين (UserListId) للأسعار الخاصة إلا للإعلانات. لم تعُد توفّر الروابط المجانية للحجز متاحة.

السمات

يحتوي العنصر <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> هذه ويمكن الإشارة إليها باستخدام السمة <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	للإشارة إلى أنّ هذا السعر سيستخدم معالجة واجهة المستخدم المرئية للسعر الخاص بالمشتركين. يمكن أن تكون قيمة هذا العنصر أي اسم برنامج عضوية.
<Description>	Optional	string	ويصف هذا السمة <UserRateCondition>. الهدف من هذه المعلومات هو التوثيق، وليس له أي تأثير في إمكاناته.
<LanguageCode>	Optional	string	تشير هذه السمة إلى أنّه سيتم عرض السعر للمستخدمين الذين تتطابق لغتهم مع رمز اللغة المكوَّن من حرفَين.
<MaxUsersPercent>	Optional	float	تشير هذه السمة إلى أنّه سيتم عرض السعر بشكل عشوائي لهذه النسبة المئوية للمستخدمين النهائيين. يجب أن تكون القيمة عددًا صحيحًا بين 0 و100 (ضمنًا). على سبيل المثال، ستستهدف القيمة 20 نسبة% 20 من المستخدمين النهائيين.
<MembershipProgram>	Optional	string	للإشارة إلى أنّ السعر سيستخدم معالجة واجهة المستخدم في برنامج الاشتراك على النحو المحدّد في <IneligibilityReason> للسمة <RateIneligibility>. ليكون <MembershipProgram> صالحًا، يجب تحديد <RateIneligibility>. يمكن أن تكون قيمة <MembershipProgram> أي اسم برنامج اشتراك.
<UserRateCondition>	Optional	<UserRateCondition>	تحدد هذه السمة شرطًا واحدًا أو أكثر تؤدي مطابقته إلى عرض أسعار مشروطة أو خاصة. يجب ألا يتضمّن عنصر <UserRateCondition> الذي يتضمّن reference_id أي أطفال.
<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>

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

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

السعر في قائمة المستخدمين للأعضاء + السعر الخاص بالأعضاء مخفي (خصم متوفّر) لغير الأعضاء

يحدّد مثال الأسعار الخاصة هذا النوع 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="all"

تم إخفاء معدّل الأعضاء لمستخدمي قائمة المستخدمين فقط

يحدّد مثال السعر الخاص هذا النوع 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>

ملاحظة: عندما يتم تقييم قيمة السمة UserListId على أنّها true، تتم تعبئة حالة السعر المرئي الخاصة بالأعضاء AlwaysEligibleMembershipProgram معًا، ما يؤدي إلى ظهور معدّل الأعضاء. وعندما يتم تقييمه على أنّه false، يصبح UserRateCondition المحيط false، ما يؤدي بعد ذلك إلى إزالة AlwaysEligibleMembershipProgram. في هذه الحالة، تؤدي سمة "الحالة ‐ "MembershipProgram‐ المخفية ضمن السعر الخاص بالأعضاء إلى ظهور جميع الأسعار غير المؤهَّلة.

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