تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

تتطلّب كل قاعدة أسعار 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>` ضمن رسالة Transaction أو في عنوان URL للصفحة المقصودة.
`<UserRateCondition>`	Optional	`<UserRateCondition>`	يقوم بتعريف شرط واحد أو أكثر، وعند مطابقته يؤدي إلى تقديم أسعار مشروطة أو خاصة. يمكن تحديد الشروط إما بشكل مضمّن باستخدام العناصر الفرعية `<UserRateCondition>`، أو بالإشارة إلى عنصر `<UserRateCondition>` آخر باستخدام السمة `reference_id`، أو بشكل مضمّن وبالإشارة إلى عنصر آخر. ومع ذلك، يجب أن يحتوي أي `<UserRateCondition>` يتضمّن `reference_id` على 0 عنصر ثانوي. يجب أن يحتوي العنصر `<UserRateCondition>` العالي المستوى ضمن `<RateRuleSettings>` على السمة `id`.

<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 حرفًا. لا يمكن أن يكون هذا المعرّف سلسلة فارغة.

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

`<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` موجودين

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`: نطاق الخصم سيكون النص كما يلي: "احصل على خصم XY% مع التسجيل المجاني". بالنسبة إلى الخصومات التي تتراوح بين %1 و%5، سيظهر النص "احصل على خصم يصل إلى %5". سيتم عرض الخصومات الأكبر بزيادات قدرها 5 نقاط، مثل "خصم من %5 إلى %10" أو "خصم من %10 إلى %15". `existence`: تلميح غير محدد. في هذه الحالة، سيكون النص كما يلي: "احصل على سعر أقل مع التسجيل المجاني". تعرف على المزيد حول معالجات واجهة المستخدم في تفاصيل الأسعار الخاصة والأمثلة.
`<IneligibilityReason>`	Required	enum	القيم الصالحة هي: `program_member`: يعرض المعدل باستخدام معالجة واجهة المستخدم المخفية لمعدل العضو.

<IneligibilityType>

Required

enum

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

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

‫exact: تمثّل نسبة الخصم. سيكون نص الإعلان "احصل على خصم% X عند التسجيل مجانًا".
‫price_band: نطاق الخصم سيكون النص كما يلي: "احصل على خصم XY% مع التسجيل المجاني". بالنسبة إلى الخصومات التي تتراوح بين %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="أي"

معدل قائمة الجمهور للأعضاء + معدل العضو المخفي (خصم الوجود) لغير الأعضاء

يحدد مثال الأسعار الخاصة هذا نوع 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 دولارات. يتيح لك ذلك تطبيق خصم على جميع الأسعار التي تتضمّن قاعدة أسعار معيّنة.

<HotelAmenity>

Optional

enum

اجمع مع <MembershipProgram> و<RateIneligibility> لتعديل معالجة واجهة المستخدم المخفية لمعدل العضوية.

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

free_wifi: إضافة plus free wifi إلى النص.

<PriceMultiplier>

Optional

float

يعدل السعر عن طريق ضرب هذه القيمة بالسعر الأساسي والضرائب والرسوم. على سبيل المثال، إذا كان PriceMultiplier = 0.9، والسعر الأساسي = 100 دولار، والضرائب = 20 دولارًا، والرسوم = 10 دولارات؛ فبعد تطبيق المضاعف: السعر الأساسي = 90 دولارًا، والضرائب = 18 دولارًا، والرسوم = 9 دولارات.

يتيح لك ذلك تطبيق خصم على جميع الأسعار التي تتضمّن قاعدة أسعار معيّنة.

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

وسائل الراحة في الفندق

سعر العضوية مخفي لجميع المستخدمين (خصومات النطاق) + خدمة واي فاي مجانية

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

مرجع XML لقواعد السعر تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

<RateRuleSettings>

البنية

السمات

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

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

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

المستخدمون في الولايات المتحدة

<RateRule>

البنية

السمات

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

<UserRateCondition>

البنية

السمات

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

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

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

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

اليابان وخارجها

أيّ وجميع وبدون

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

السعر المتاح للأعضاء 1

السعر المتاح للأعضاء 2

معدّل قائمة المستخدمين 1

معدّل قائمة المستخدمين 2

<RateIneligibility>

البنية

السمات

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

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

أمثلة مخفية لمعدل العضوية (أساسية)

خصم دقيق

خصم الفرقة

تلميح الخصم

أمثلة مخفية لمعدل العضوية (شروط متعددة)

op="أي"

op="all"

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

<RateModification>

السمات

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

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

وسائل الراحة في الفندق

مضاعف السعر

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

`<RateRuleSettings>`

`<RateRule>`

`<UserRateCondition>`

`<RateIneligibility>`

`<RateModification>`