مرجع 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>
متاحة.

السمات

يحتوي عنصر <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 خاليًا من 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>

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

يعرِض مثال الأسعار الشَرطية التالي قاعدة أسعار واحدة تتطابق مع المستخدِمين في اليابان وقاعدة أسعار أخرى تتطابق مع المستخدِمين في بقية العالم:

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

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