> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# وحدة المكافآت المتدرجة - الإعدادات العامة

> إعداد إعدادات التصميم والوظائف لوحدة المكافآت

وحدة المكافآت هي ميزة أساسية في Upcart تعرض شريط تقدم مرئيًا في درج السلة، لتشجيع العملاء على إنفاق المزيد من خلال تتبع تقدمهم نحو مكافآت مثل الشحن المجاني أو الخصومات أو المنتجات المجانية.

هذا هو الدليل الأول من ثلاثة أدلة تغطي إعدادات المكافآت:

* **الإعدادات العامة** (هذا المستند)
* **[إعدادات المكافآت](/ar/upcart/tiered_rewards_module_rewards_settings)**
* **[الإعدادات المتقدمة](/ar/upcart/tiered_rewards_module_advanced_settings)**

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-progress-bar-free-shipping.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=3065be916fd829d905d4c2dc91755668" alt="شريط تقدم مكافآت Upcart مع أيقونات الشحن المجاني ومراحل المنتجات" width="1134" height="354" data-path="images/upcart/tiered-rewards-general-progress-bar-free-shipping.png" />

⚠️ *هذه الوحدة مرئية فقط ولا تطبّق الخصومات أو منطق الشحن. لجعل المكافآت فعّالة، راجع مستند [إعدادات المكافآت](/ar/upcart/tiered_rewards_module_rewards_settings).*

<div id="general-settings">
  # الإعدادات العامة
</div>

<div id="show-rewards-on-empty-cart">
  ## إظهار المكافآت عند السلة الفارغة
</div>

فعّل هذا الخيار لعرض شريط المكافآت حتى عندما تكون السلة فارغة.

<div id="colors">
  ## الألوان
</div>

خصّص المظهر المرئي للشريط:

* **لون خلفية الشريط**: يمثّل ما تبقى لكسبه
* **لون مقدمة الشريط**: يشير إلى التقدم نحو المكافأة
* **لون أيقونة مستوى المكافأة المكتمل**: أيقونات المستويات التي فتحها العميل بالفعل. **الإصدار 2 فقط.**
* **لون أيقونة مستوى المكافأة غير المكتمل**: أيقونات المستويات التي لم تُفتح بعد. **الإصدار 2 فقط.**

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-bar-preview-colors.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=61991e26fa74b74d0146ecb91b8bc1cd" alt="معاينة شريط المكافآت فوق حقلي لون خلفية الشريط ومقدمته" width="1136" height="646" data-path="images/upcart/tiered-rewards-general-bar-preview-colors.png" />

<div id="text-after-completing-full-rewards-bar">
  ## النص بعد إكمال شريط المكافآت بالكامل
</div>

أضف رسالة مخصصة تظهر بعد تحقيق جميع مستويات المكافآت. استخدم أدوات التنسيق (غامق، مائل، تسطير، لون) لتنسيق الرسالة حسب الحاجة.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/tiered-rewards-general-completion-message-editor-formatting.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=f09c117f9c5d93924d4f33162c37e3a2" alt="محرر رسالة إكمال المكافآت مع شريط أدوات التنسيق ونص نموذجي للفتح" width="1082" height="400" data-path="images/upcart/tiered-rewards-general-completion-message-editor-formatting.png" />

***

<div id="rewards-calculation">
  ## حساب المكافآت
</div>

هذه بطاقة مستقلة، أسفل **الإعدادات العامة**. اختر كيفية حساب التقدم:

* **إجمالي السلة (\$)**\
  يتتبع التقدم بناءً على القيمة الإجمالية للسلة (مثلًا مكافأة عند \$100).
* **كمية السلة (#)**\
  يتتبع التقدم بناءً على عدد العناصر (مثلًا مكافأة عند 5 عناصر).

  * ينطبق الأساس المحدد على شريط المكافآت بأكمله ولا يمكن أن يختلف حسب المستوى.

<div id="use-pre-discounted-prices-for-cart-total">
  ## استخدام الأسعار قبل الخصم لإجمالي السلة
</div>

يوجد في بطاقة **حساب المكافآت** نفسها، ويظهر فقط عندما يكون الأساس هو **إجمالي السلة (\$)**. عند تفعيله، تُحسب المكافآت باستخدام إجمالي السلة قبل أي خصومات. يمنع هذا استبعاد العملاء من مكافأة بسبب قسيمتهم الخاصة. راجع [كيفية استبعاد الخصومات من هدف المكافأة](/ar/upcart/how_to_exclude_discounts_in_reward_goal).

***

<div id="filter-which-products-count-toward-rewards">
  ## تصفية المنتجات التي تُحتسب ضمن المكافآت
</div>

باستخدام **فلاتر المنتجات**، يمكنك التحكم في العناصر المؤهلة في السلة للمساهمة في تقدم المكافآت. يتيح ذلك دقة أكبر ومرونة في حالات الاستخدام، مثل استبعاد بطاقات الهدايا أو استهداف مجموعات منتجات محددة فقط.

<Note>
  تتطلب هذه الفلاتر وحدة المكافآت من **الإصدار 2**. في الإصدار 1 لا يظهر قسم الفلاتر على الإطلاق.
</Note>

يمكنك تطبيق الفلاتر حسب **المنتج** أو **المجموعة** أو **خاصية العنصر** أو **حالة الاشتراك**. يمكن ضبط كل فلتر إما على **تضمين** (تساهم العناصر المحددة فقط) أو **استبعاد** (يساهم كل شيء باستثناء العناصر المحددة). ويمكن دمج عدة فلاتر لمنطق متعدد الطبقات.

<div id="product-filter">
  ## **فلتر المنتج**
</div>

يتيح لك هذا الفلتر تضمين منتجات فردية في شريط المكافآت أو استبعادها منه.

* **تضمين**: تُحتسب المنتجات المحددة فقط ضمن المكافأة.
* **استبعاد**: تُحتسب جميع المنتجات باستثناء تلك التي استبعدتها.

استخدم هذا لعزل المنتجات ذات الهامش المرتفع، أو استبعاد العناصر الترويجية، أو إزالة المنتجات منخفضة القيمة مثل بطاقات الهدايا من حسابات المكافآت.

<div id="collection-filter">
  ## **فلتر المجموعة**
</div>

يطبّق هذا الفلتر المنطق نفسه المستخدم في فلتر المنتج، ولكن على **مستوى المجموعة**.

* يمكنك تضمين مجموعة Shopify كاملة (مثل "مجموعة العطلات") لتُحتسب ضمن المكافآت.
* أو استبعاد مجموعة مثل "عناصر التخفيضات" إذا كنت لا تريد مساهمة المنتجات المخفّضة.

مثالي للتحكم بالجملة دون الحاجة إلى تحديد المنتجات واحدًا تلو الآخر.

<div id="item-property-filter">
  ## **فلتر خاصية العنصر**
</div>

استخدم هذا الفلتر لتضمين العناصر أو استبعادها بناءً على **خصائص بند الطلب** — بيانات وصفية غالبًا ما تضيفها تطبيقات أخرى أو خيارات المنتجات المخصصة أو الوسم الداخلي.

* أضف الفلاتر باستخدام **أزواج مفتاح-قيمة** (مثل `upsell: true`، `__upcartRecommendation: [ID]`)
* يمكنك ترك حقل القيمة فارغًا للتصفية حسب المفتاح فقط (مثلًا استبعاد جميع العناصر التي تحمل المفتاح `upsell` بغض النظر عن القيمة)

هذا مثالي لاستبعاد عناصر البيع الإضافي (upsell) أو الاشتراكات أو الطلبات المخصصة أو أي شيء يُوسم ديناميكيًا عبر واجهة متجرك أو إعدادات الأتمتة لديك.

<div id="subscription-status-filter">
  ## **فلتر حالة الاشتراك**
</div>

يتيح لك هذا الفلتر تضمين العناصر أو استبعادها بناءً على ما إذا كانت عناصر اشتراك أو مشتريات لمرة واحدة.

* **عناصر الاشتراك**: تُحتسب فقط العناصر التي لديها خطة اشتراك نشطة ضمن المكافأة
* **عناصر المرة الواحدة**: تُحتسب فقط العناصر المشتراة لمرة واحدة (غير الاشتراك) ضمن المكافأة

استخدم هذا لإنشاء مكافآت مخصصة لمشتريات الاشتراك (مثلًا "أضف 3 عناصر اشتراك واحصل على شحن مجاني") أو لاستبعاد الاشتراكات من مستويات مكافآت معينة.

***

<div id="advanced-settings">
  ## الإعدادات المتقدمة
</div>

يفتح قائمة إعدادات المكافآت المتقدمة. لميزات مثل المكافآت الخاصة بالعملات والشروط المتقدمة، راجع دليل **[الإعدادات المتقدمة](/ar/upcart/tiered_rewards_module_advanced_settings)**.