أدلة الميزات

برامج الولاء في ڤاريونس للمتاجر الإلكترونية في مصر: نقاط ومستويات ومكافآت واحتفاظ بالعملاء

برنامج الولاء في ڤاريونس هو أداة احتفاظ التاجر: يمنح نقاطاً على الشراء وإجراءات مثل التسجيل وأول طلب والإحالة والتقييم، ويرقي العميل بين مستويات بمضاعفات، ويستبدل النقاط بمكافآت خصم أو شحن مجاني أو هدية تظهر في الدفع، وكل ذلك يُدار من صفحة /dashboard/loyalty-programs ويُقرأ من نفس رصيد العميل في CRM.

آخر تحقق: 2026-09-19

يُدار برنامج الولاء من مسار /dashboard/loyalty-programs، وهو صفحة مخصصة بثمانية تبويبات: الإعدادات العامة (General) لتفعيل البرنامج وضبط النقاط، والمستويات (Tiers) لإضافة مستوى باسم عربي وإنجليزي وحد أدنى للنقاط ومضاعف ومزايا ولون وأيقونة، والمكافآت (Rewards) لإنشاء مكافأة بعنوان عربي وإنجليزي وتكلفة نقاط ونوع (discount أو free_shipping أو gift) مع قيمة الخصم ونوعه (percentage أو fixed) أو المنتج الهدية، وقواعد الكسب (Earning) للمكافآت الإضافية، والإشعارات (Notifications)، والعرض (Display)، وكبار العملاء (Top Consumers)، وطلبات الاستبدال (Redemption Orders).

إعدادات النقاط دقيقة: نقاط لكل وحدة عملة (pointsPerCurrency)، وحد أدنى لمبلغ الطلب (minOrderAmount)، وقيمة النقطة بالعملة (pointValue)، وحد أقصى للنقاط المستخدمة في طلب واحد (maxPointsPerOrder)، وصلاحية بالأيام (pointsExpiryDays حيث 0 تعني بلا انتهاء)، ونقاط ثابتة لكل طلب (pointsPerOrder)، وحد أدنى وأقصى للنقاط المكتسبة لكل طلب (minPointsPerOrder وmaxEarnedPointsPerOrder). وقواعد الكسب تشمل مكافأة التسجيل (signupBonus) وأول طلب (firstOrderBonus) والإحالة (referralBonus) وعيد الميلاد (birthdayBonus) والتقييم (reviewBonus) مع مفتاح تفعيل كسب النقاط مع كل طلب (enableOrderPoints الافتراضي مفعّل).

المكافأة تُضبط بمكان الظهور (displayLocation): لوحة الإدارة فقط (admin_dashboard) أو الدفع فقط (checkout) أو الاثنان معاً (both)، مع حالة نشطة (isActive) وخيار التطبيق التلقائي (isAutoApply) الذي يطبّق المكافأة المؤهلة تلقائياً في الدفع. والإشعارات تغطي الكسب والاستبدال والترقية للمستوى وقرب الانتهاء مع عدد أيام التنبيه (expiryNoticeDays). وإعدادات العرض تتحكم في إظهار النقاط في صفحة المنتج والسلة والدفع مع رسالة مخصصة عربية وإنجليزية.

قاعدة البيانات من مجموعتين: مجموعة LoyaltySettings بإعداد واحد لكل متجر (tenantId وtenantSlug وفهارس عليهما)، ومستند العميل CRMCustomer الذي يحمل data.loyalty برصيد النقاط (pointsBalance) والمستوى (tier) وسجلي الكسب والاستبدال (earnedHistory وredeemedHistory)، مع فهرس على data.loyalty.pointsBalance للترتيب والبحث عن كبار العملاء. وعند إتمام الشراء يحسب الخادم النقاط من المبلغ فوق الحد الأدنى، ويطبّق مضاعف المستوى، ويضيف سجل كسب، ويرقي المستوى تلقائياً، بينما تُخصم نقاط المكافأة المستخدمة من نفس الرصيد وتُسجَّل في redeemedHistory.

في الدفع يقرأ الخطاف useLoyalty ملخص الولاء من GET /api/loyalty/summary بمعرف المتجر والبريد أو الهاتف أو customerId، فيعرض قسم الولاء (LoyaltySection) الرصيد والمكافآت المؤهلة (isEligible عندما يغطي الرصيد pointsCost)، ويطبّق المكافأة المختارة كسطر خصم ولاء (loyaltyDiscount) في تفاصيل السعر، ثم تُرسل ضمن discounts بعلامة isLoyalty عند إنشاء الطلب. وفي CRM يعرض تبويب الولاء الرصيد والمستوى والسجلين، ويدعم إجراءات earnPoints وredeemPoints وupdateTier من POST /api/dashboard/customers/loyalty، بينما يعرض تبويبا كبار العملاء وطلبات الاستبدال أكثر العملاء نقاطاً والطلبات التي استخدمت مكافآت ولاء. ومساعد الذكاء الاصطناعي Copilot يملك أدوات ولاء للملخص والإعدادات والمكافآت وإضافة النقاط والاستبدال وسجل الاستبدالات وكبار العملاء، وكلها بصلاحيات loyalty وتتطلب تأكيداً قبل التنفيذ. والصلاحيات محكومة: العرض بصلاحية loyalty:view، والتعديل والإنشاء والحذف بصلاحيات loyalty:edit/create/delete، ومالك المتجر يملك الكل.

لهذا يعمل الولاء كأداة احتفاظ للشراء المتكرر في مصر: العميل يكسب مع كل طلب مدفوع نقداً أو إلكترونياً، ويرى نقاطه في الدفع فيعود للاستبدال، والمستويات والمكافآت التلقائية ترفع قيمة السلة، وسجل CRM يعرّف المتكررين للاستهداف عبر واتساب أو كوبونات.

خطوات الإعداد في ڤاريونس

  1. افتح صفحة برامج الولاء وفعّل البرنامج

    من لوحة التحكم ادخل إلى /dashboard/loyalty-programs من القائمة الجانبية (الولاء). في تبويب General فعّل البرنامج بمفتاح enabled ثم اضغط حفظ. ويتطلب العرض صلاحية loyalty:view والحفظ loyalty:edit، ويظهر عدّاد تنبيهات الولاء في القائمة عند وجود عملاء مؤهلين.

  2. اضبط معادلة النقاط والصلاحية

    في General حدّد pointsPerCurrency وminOrderAmount وpointValue وmaxPointsPerOrder وpointsExpiryDays (0 تعني بلا انتهاء)، مع pointsPerOrder وminPointsPerOrder وmaxEarnedPointsPerOrder للحدود الدنيا والقصوى لكل طلب، ثم احفظ عبر POST /api/loyalty-settings/update.

  3. أنشئ المستويات بمضاعفاتها

    افتح تبويب Tiers واضغط إضافة مستوى: أدخل الاسم العربي والإنجليزي وminPoints وmultiplier (مثل 1.5 لنقاط إضافية 50%) والمزايا واللون والأيقونة. رتّب المستويات تصاعدياً (برونزي ثم فضي ثم ذهبي ثم بلاتيني) ليحسب الخادم الترقية تلقائياً عند تجاوز الرصيد الحد.

  4. أنشئ المكافآت وحدّد ظهورها

    افتح تبويب Rewards واضغط إضافة: أدخل العنوان العربي والإنجليزي وpointsCost والنوع discount أو free_shipping أو gift، وحدّد discountValue وdiscountType أو المنتج الهدية، ثم اختر displayLocation (checkout أو both لتظهر في الدفع) وفعّل isActive وisAutoApply عند الحاجة. الحفظ يتم عبر POST /api/loyalty-settings/rewards بصلاحيات create/edit/delete.

  5. فعّل مكافآت الكسب والإشعارات والعرض

    في تبويب Earning حدّد signupBonus وfirstOrderBonus وreferralBonus وbirthdayBonus وreviewBonus وأبقِ enableOrderPoints مفعّلاً لكسب النقاط مع كل طلب. وفي Notifications فعّل التنبيه عند الكسب والاستبدال والترقية وقرب الانتهاء مع expiryNoticeDays. وفي Display فعّل الظهور في المنتج والسلة والدفع مع رسالة مخصصة.

  6. اربط الولاء بملف العميل وتابع كبار العملاء

    افتح /dashboard/crm ثم ملف العميل وتبويب الولاء لمراجعة pointsBalance والمستوى وسجلي الكسب والاستبدال، واستخدم earnPoints وredeemPoints وupdateTier عند الحاجة. وراجع تبويبي Top Consumers وRedemption Orders في صفحة الولاء لمعرفة أكثر العملاء نقاطاً والطلبات التي استخدمت مكافآت (GET /api/dashboard/loyalty-programs/top-consumers وGET /api/loyalty/redemption-orders).

  7. جرّب الاستبدال في الدفع وراقب الطلب

    نفّذ طلب تجريبي ببريد عميل يملك رصيداً: يظهر قسم الولاء الرصيد والمكافآت المؤهلة، واختر مكافأة لتظهر كسطر loyaltyDiscount في الإجمالي، ثم أتمّ الطلب وتأكد من خصم pointsCost من data.loyalty وظهور سجل في redeemedHistory وفي طلبات الاستبدال بعلامة isLoyalty.

أسئلة شائعة

أين صفحة برنامج الولاء في اللوحة؟

من /dashboard/loyalty-programs في القائمة الجانبية (الولاء). الصفحة بثمانية تبويبات: العامة والمستويات والمكافآت والكسب والإشعارات والعرض وكبار العملاء وطلبات الاستبدال، مع بطاقات إحصاءات وزر حفظ.

كيف تُحسب نقاط كل طلب؟

إذا تجاوز المبلغ minOrderAmount تُحسب النقاط من pointsPerCurrency مضروبة في مضاعف المستوى، مع إضافة pointsPerOrder واحترام minPointsPerOrder وmaxEarnedPointsPerOrder، ثم تُضاف إلى pointsBalance مع سجل كسب وترقية تلقائية للمستوى.

ما أنواع المكافآت وكيف تظهر في الدفع؟

ثلاثة أنواع: discount بقيمة percentage أو fixed، وfree_shipping، وgift بمنتج محدد. تظهر في الدفع فقط المكافآت النشطة بمكان عرض checkout أو both، وتُعلَّم المؤهلة منها بـ isEligible عندما يغطي الرصيد pointsCost، مع دعم التطبيق التلقائي عبر isAutoApply.

هل الولاء مرتبط بملف العميل في CRM؟

نعم. الرصيد والمستوى والسجلان يعيشان في data.loyalty داخل مستند CRMCustomer نفسه الذي يقرأ منه الدفع، وتبويب الولاء في الملف يعرضها مع إجراءات إضافة النقاط واستبدالها وتغيير المستوى.

كيف يدعم الولاء الشراء المتكرر؟

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

هل يمكن لمساعد الذكاء الاصطناعي إدارة النقاط؟

نعم ضمن صلاحياتك. أدوات الولاء في Copilot تغطي الملخص والإعدادات والمكافآت وإضافة النقاط والاستبدال وسجل الاستبدالات وكبار العملاء، والقراءة تحتاج loyalty:view والكتابة loyalty:edit، وكل تعديل ينتظر التأكيد.

ماذا يحدث للنقاط عند استخدام مكافأة؟

تُخصم pointsCost من pointsBalance في نفس مستند العميل وتُسجَّل في redeemedHistory، ويظهر الطلب في طلبات الاستبدال بخصم ولاء isLoyalty، وقد ينخفض المستوى تلقائياً إذا نزل الرصيد تحت الحد.

استكشاف الأخطاء

1) إذا لم تظهر صفحة الولاء، تحقق من صلاحية loyalty:view للموظف؛ والحفظ والإضافة والحذف يحتاج loyalty:edit/create/delete ومالك المتجر يملك الكل. 2) إذا لم تظهر مكافأة في الدفع، تأكد من isActive وأن displayLocation تساوي checkout أو both، وأن رصيد العميل يغطي pointsCost (isEligible). 3) إذا لم تُضف نقاط لطلب، تحقق أن البرنامج مفعّل (enabled) وأن enableOrderPoints مفعّل وأن المبلغ تجاوز minOrderAmount، وأن العميل مطابق بالبريد أو الهاتف داخل نفس المتجر وغير مؤرشف. 4) إذا اختفى قسم الولاء في الدفع، فالبرنامج غالباً معطّل أو العميل بلا رصيد ولا مكافآت؛ القسم لا يظهر عندما يكون الرصيد والمكافآت صفراً. 5) إذا ظهرت الشرطة في مخاطرة العميل فهي نتيجة غير متاحة وليست خطورة منخفضة، ولا علاقة لها برصيد الولاء. 6) طلبات الاستبدال تُقرأ من الطلبات التي تحمل خصم isLoyalty؛ الطلب العادي بلا مكافأة لن يظهر هناك. 7) إذا تعذّر إرسال واتساب لعملاء الولاء، تأكد من ربط حساب واتساب للأعمال؛ الولاء نفسه لا يرسل واتساب تلقائياً.

حدود مهمة

• النقاط تُكتسب على الطلبات التي تتجاوز minOrderAmount فقط، وليست على كل تفاعل في المتجر. • المكافأة تُستبدل برصيد كافٍ؛ لا يوجد استبدال جزئي بنقاط ناقصة. • الأرشفة لا تحذف الرصيد لكنها تُخرج العميل من البحث ومن مطابقة الدفع، فيُنشأ سجل جديد عند الشراء التالي بلا رصيد قديم. • تسليم إشعارات واتساب المُبادَر بها يعتمد على Meta ويشترط ربط حساب واتساب للأعمال. • درجة المخاطرة إشارة تقييم للدفع عند الاستلام وليست منعاً تلقائياً ولا جزءاً من حساب النقاط.

روابط ذات صلة

تواصل معنا على واتساب