مرجع 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>. ويمكن الإشارة إليها من خلال السمة 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> أي اسم لبرنامج عضوية.
<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 لمعالجة واجهة المستخدم المخفية بسعر المشتركين، وقد تم تعديله بالنص الإضافي "plus 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&dash.

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