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

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

تتطلّب كل قاعدة أسعار id، ويمكن الرجوع إليها في <Rate> ضمن رسالة &quot;عملية&quot;. لا يتم عرض <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> ضمن رسالة Transaction أو في عنوان 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> في رسالة Transaction لعرض سعر مشروط أو خاص. يمكن أيضًا الرجوع إلى قاعدة السعر id باستخدام متغيّر وشروط في عنوان URL للصفحة المقصودة.

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

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

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

العنصر الفرعي مطلوب؟ النوع الوصف
<RateIneligibility> Optional <RateIneligibility> تحدّد هذه السمة القيم التي تحدّد طريقة عرض واجهة المستخدم الخاصة بـ <MembershipProgram> سعر معيّن.

تكون هذه السمة صالحة فقط عند تحديد <MembershipProgram> في <UserRateCondition>.
<UserRateCondition> Required <UserRateCondition>

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

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

يُرجى العِلم أنّه عندما يكون <UserRateCondition> عنصرًا ثانويًا تابعًا لـ <RateRule>، لا يمكن أن يحتوي العنصر <UserRateCondition> على السمة id ولا يمكن أن يشير إليه <UserRateCondition> آخر.
<RateModification> Optional <RateModification> تعدّل هذه السمة طريقة عرض واجهة المستخدم للأسعار الخاصة.
<PromoCode> Optional string تحدّد هذه السمة رمزًا سيتم ربطه بالسعر إذا تم تطبيق قاعدة السعر هذه. يظهر ذلك في المتغيّر PROMO-CODE landing page.

<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 تحدّد هذه السمة أنّ السعر سيتم تقديمه للمستخدمين الذين تتطابق لغتهم مع رمز اللغة المكوّن من حرفَين.

ملاحظة>: ننصحك باستخدام <UserCountry> بدلاً من <LanguageCode> كلما أمكن ذلك.
<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>.

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

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

يوضّح مثال الأسعار المشروطة التالي أنّ السعر سيتم تقديمه بشكل عشوائي إلى 20% من المستخدمين:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="20_percent_users">
    <UserRateCondition>
      <MaxUsersPercent>20</MaxUsersPercent>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

المملكة المتحدة ومستخدمو الأجهزة الجوّالة

يحدّد مثال الأسعار الشرطية التالي قاعدة أسعار تطابق جميع المستخدمين الذين يبحثون في المملكة المتحدة باستخدام جهاز جوّال من خلال استخدام <UserRateCondition> مضمّن:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="gb_mobile">
    <UserRateCondition op="all">
      <UserCountry>GB</UserCountry>
      <UserDeviceType>mobile</UserDeviceType>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

اليابان وغير اليابان

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

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