إحالات العملاء

الغرض

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

يحصل كل عميل على رابط إحالة فريد. عند تسجيل زائر جديد عبر هذا الرابط يُربط دائمًا بصاحب الإحالة. ومع كل طلب مدفوع يقوم به العميل المُحال يحصل صاحب الإحالة على نسبة مئوية من إجمالي منتجات الطلب (بعد خصومات المنتجات) تُضاف تلقائيًا إلى محفظته. وفي حال استرداد الطلب لاحقًا تُعاد العمولة تلقائيًا.

برنامج إحالة العملاء ميزة مدفوعة وغير متوفر في المتاجر المجانية.

كيف يعمل البرنامج

1. تفعّل البرنامج من الإعدادات وتحدد نسبة العمولة.
2. يظهر لكل عميل مسجّل الدخول رابط جديد باسم الإحالات في قائمة الحساب (أو فقط للمستخدمين المسموح لهم إذا قصرت البرنامج عليهم — انظر أدناه).
3. تعرض صفحة الإحالات رابطًا قابلًا للمشاركة وكود الإحالة الخاص بالعميل.
4. يصبح الزائر الجديد مرتبطًا بصاحب الإحالة عبر إحدى ثلاث طرق:
   • فتح الرابط القابل للمشاركة ?ref=... ثم التسجيل خلال ٣٠ يومًا؛
   • إدخال كود الإحالة في الحقل الاختياري داخل نموذج التسجيل (عند تفعيل ذلك المفتاح)؛
   • يقوم المدير بضبط تمت إحالته بواسطة في ملف المستخدم من صفحة المستخدمين.
5. مع كل طلب مدفوع يقوم به العميل المُحال، تُضاف عمولة إلى محفظة صاحب الإحالة تلقائيًا.
6. يمكن لكل من العميل (من صفحة الإحالات) والمدير (من صفحة إحالات العملاء) رؤية الإجماليات وأحدث النشاط.

تفعيل البرنامج

انتقل إلى الإعدادات ← إحالات العملاء (/admin/customer-referral-settings).

الحقل	النوع	الوصف
تفعيل إحالة العملاء	مفتاح	تشغيل أو إيقاف البرنامج بالكامل
نسبة العمولة	رقم (من 0 إلى 100)	النسبة المئوية من إجمالي منتجات كل طلب مدفوع (بعد خصومات المنتجات) التي تُضاف إلى صاحب الإحالة (مثلاً 5 تعني 5%). تُستبعد تكلفة التوصيل والضريبة والرسوم.
إظهار حقل رمز الإحالة في نموذج التسجيل	مفتاح	يضيف حقلاً اختياريًا باسم رمز الإحالة إلى صفحة التسجيل العامة، لتمكين الزائر الجديد من إدخال الكود الذي شاركه معه صديقه يدويًا حتى لو لم يفتح رابط الإحالة
قصر الوصول للإحالة على مستخدمين محددين	مفتاح	عند التفعيل، فقط المستخدمون الذين تضيفهم إلى قائمة المسموح لهم يمكنهم كسب العمولات ورؤية لوحة الإحالة. باقي العملاء لن يظهر لهم رابط الإحالات ولن تُضاف لهم أي عمولات حتى لو تمت مشاركة كودهم

يتم تطبيق التغييرات فور الحفظ. يظهر المفتاحان الإضافيان فقط بعد تفعيل تفعيل إحالة العملاء.

السماح للعملاء بإدخال كود الإحالة عند التسجيل

افتراضيًا، لا يُربط الزائر الجديد بصاحب الإحالة إلا إذا سجّل بعد النقر على رابط ?ref=.... مع تفعيل خيار إظهار حقل رمز الإحالة في نموذج التسجيل، تعرض صفحة التسجيل العامة حقلاً اختياريًا باسم رمز الإحالة أيضًا. يكتب الزائر الكود المكوّن من ٨ خانات الذي شاركه معه صديقه ويُرسل النموذج، فيُربط بصاحب الإحالة فور إنشاء الحساب.

ملاحظات:

• الحقل اختياري. تركه فارغًا لا يسبب أي خطأ.
• إذا فتح الزائر رابط الإحالة سابقًا، يُملأ الكود المُلتقط مسبقًا في الحقل ليتمكن من تأكيده أو تغييره.
• إذا أدخل الزائر كودًا خاطئًا، يُرفض التسجيل برسالة "رمز الإحالة هذا غير صالح" حتى لا ينتهي الأمر بحساب بدون إحالة بالخطأ.
• إذا ترك الحقل فارغًا مع وجود كوكي ملتقط، يُستخدم الكوكي كاحتياط. مدخل النموذج له الأولوية فقط عندما يكون الاثنان موجودين.

قصر البرنامج على قائمة محددة من المستخدمين

للبرامج التي تريد تشغيلها مع مجموعة منتقاة من المروّجين (مؤثرون، موظفون، عملاء VIP) بدلاً من فتحها لكل العملاء، فعّل قصر الوصول للإحالة على مستخدمين محددين في صفحة الإعدادات. بعد التفعيل، يظهر زر إدارة المستخدمين المسموح لهم أسفل المفتاح.

اضغط الزر لفتح الإعدادات ← المستخدمون المسموح لهم بالإحالة (/admin/customer-referral-allowed-users).

هذه صفحة قائمة صغيرة لها مهمة واحدة: إدارة قائمة المستخدمين المشاركين في برنامج الإحالة.

• إضافة مستخدم: اضغط إضافة مستخدم في الأعلى. يفتح نافذة منبثقة تحتوي على حقل بحث واحد للمستخدمين — اكتب الاسم أو البريد الإلكتروني، اختر المستخدم، احفظ.
• تعديل صف: اضغط زر التعديل بجانب الصف. تفتح النافذة المنبثقة نفسها.
• حذف مستخدم: اضغط زر الحذف. الحذف يوقف مشاركته في الإحالة (انظر أدناه).
• التكرارات ممنوعة على مستوى قاعدة البيانات — ستظهر رسالة "هذا المستخدم موجود بالفعل في قائمة المسموح لهم" إذا حاولت إضافة مستخدم مرتين.

يظهر هذا المورد في القائمة الجانبية فقط أثناء تفعيل قصر الوصول للإحالة على مستخدمين محددين؛ إيقاف الخيار يخفي المدخل من القائمة.

ما الذي يتغيّر عند تفعيل القائمة البيضاء

السلوك	المستخدم المسموح له	المستخدم غير المسموح له
يرى رابط الإحالات في قائمة الحساب	نعم	لا
يستطيع فتح /profile/referrals	نعم — تظهر اللوحة بشكل طبيعي	لا — تعيد الصفحة 404
يكسب عمولة عند استخدام كوده في طلب مدفوع	نعم	لا — تُتجاهل العمولة بهدوء
يُضبط referrer_id للعملاء المُحالين عبره	نعم	لا — تُلغى الإحالة عند التسجيل

المستخدم الذي كان يكسب العمولات قبل تفعيل وضع القائمة البيضاء يتوقف ببساطة عن كسب أي عمولة جديدة طالما هو خارج القائمة. عمليات المحفظة السابقة لا تُمس. إضافته إلى القائمة تُعيد تفعيل الكسب فورًا.

إيقاف خيار قصر الوصول للإحالة على مستخدمين محددين يعيد البرنامج إلى وضع الفتح للجميع دون المساس بمحتوى القائمة — يمكنك تفعيل وإيقاف هذا الخيار دون أن تفقد قائمتك المنتقاة.

تجربة العميل

عند تفعيل البرنامج يرى العملاء المسجّلون رابط الإحالات في قائمة الحساب (القائمة المنسدلة والعمودية)، وعند فتحه تظهر لوحة التحكم على /profile/referrals. إذا فعّلت قصر الوصول للإحالة على مستخدمين محددين، فإن العملاء الموجودين في قائمة المستخدمون المسموح لهم بالإحالة فقط هم من يرون الرابط ويستطيعون فتح اللوحة — أي شخص آخر يحاول فتح الرابط مباشرة سيحصل على 404.

تنقسم اللوحة إلى ثلاث علامات تبويب:

• رابط الإحالة — الرابط القابل للمشاركة وزر نسخ بنقرة واحدة، مع كود الإحالة من 8 خانات.
• الأرباح — خمس بطاقات إحصائية (المستخدمون المُحالون، إجمالي الطلبات، إجمالي الأرباح، آخر ٧ أيام، آخر ٣٠ يومًا)، وقائمة مقسمة لصفحات تعرض جميع عمليات العمولة والاسترداد للعميل بدءًا من الأحدث.
• المستخدمون — قائمة مقسمة لصفحات بجميع المستخدمين الذين أحالهم العميل، مع عدد الطلبات المدفوعة وصافي العمولة المكتسبة من كل مستخدم.

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

لوحة المدير

انتقل إلى التسويق والمحتوى ← إحالات العملاء (/admin/customer-referrals).

هذه قائمة مورد اعتيادية، يمثل كل صف عملية محفظة واحدة: إما عمولة مكتسبة (Earned) أو استرداد (Reversed) ناتج عن طلب مسترد.

الأعمدة:

• التاريخ — وقت إنشاء العملية.
• صاحب الإحالة — العميل الذي أُضيف أو خُصم من محفظته، قابل للنقر لفتح حسابه.
• المشتري المُحال — العميل الذي أحدث طلبه هذه العمولة.
• الطلب — رقم الطلب، قابل للنقر لفتحه.
• العمولة — المبلغ بعملة المتجر. الصفوف المكتسبة تظهر باللون الأخضر، والمستردة تظهر بعلامة سالبة وباللون الأحمر.
• النوع — شارة: مكتسب (أخضر) أو مُسترد (أحمر).

المرشحات:

• نطاق التاريخ (من / إلى).
• صاحب الإحالة (بحث).
• النوع (مكتسب / مُسترد).

شريط الإحصائيات (أعلى الجدول، يتمرر أفقيًا على الجوال): إجمالي العمولات (صافي بعد الاستردادات، مع عدد العمليات المكتسبة)، آخر ٧ أيام، آخر ٣٠ يومًا، المستخدمون المُحالون مع عدد أصحاب الإحالات النشطين.

في حال تعطيل البرنامج تظل القائمة تعرض البيانات التاريخية — التعطيل يمنع فقط إنشاء عمولات جديدة مستقبلًا.

قواعد العمولة

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

عمليات المحفظة

كل عمولة تنشئ قيد credit في محفظة صاحب الإحالة يتضمن:

• نوع المرجع: customer_referral_commission
• رقم المرجع: رقم الطلب الذي أنتج العمولة
• الوصف: عمولة إحالة للطلب رقم <رقم الطلب>

وعند استرداد الطلب لاحقًا يُضاف قيد debit مقابل:

• نوع المرجع: customer_referral_commission_reversal
• رقم المرجع: نفس رقم الطلب
• الوصف: تم استرداد عمولة الإحالة للطلب الملغى <رقم الطلب>

يُسمح للاسترداد بجعل رصيد المحفظة سالبًا، إذ قد يكون صاحب الإحالة قد صرف العمولة قبل وقوع الاسترداد. يظهر النوعان في قائمة عمليات المحفظة المعتادة ويمكن تصديرهما.

ضبط صاحب الإحالة من لوحة الإدارة

أحيانًا يسجّل عميل دون رابط إحالة ثم يخبرك لاحقًا بمن أحاله. من إدارة المستخدمين ← المستخدمون افتح حساب العميل. النموذج فيه علامة تبويب باسم إحالة — انتقل إليها.

تحتوي علامة التبويب على حقلين:

• تمت إحالته بواسطة — حقل بحث. اكتب اسمًا أو بريدًا إلكترونيًا أو كود إحالة، ثم اختر المستخدم الذي يجب أن تُسجَّل العمولات باسمه. اتركه فارغًا لإلغاء الإحالة الحالية.
• رمز الإحالة — للقراءة فقط. يعرض كود الإحالة الخاص بهذا العميل المكوّن من ٨ خانات لتتمكن من نسخه ومشاركته نيابةً عنه عند الحاجة. تظهر للعملاء الجدد عبارة "سيتم إنشاؤه عند أول استخدام" حتى ينشئه النظام (يُنشأ تلقائيًا عند أول زيارة للعميل لصفحة الإحالات).

لا يمكن أن يكون العميل صاحب إحالة لنفسه — نتائج البحث تستثني العميل الحالي.

هذا الإعداد يؤثر فقط على الطلبات المدفوعة المستقبلية. الطلبات القديمة لا تُحتسب لها عمولة بأثر رجعي تلقائيًا؛ إذا احتجت إلى تعويض الفترة السابقة، شغّل الأمر referrals:backfill-commissions (متاح للمدير فقط) أو تواصل مع الدعم.

مشاركة رابط الإحالة

الرابط هو ببساطة الصفحة الرئيسية للمتجر مع معلمة ?ref=، مثال:

https://your-store.com/?ref=8CHARCODE

يمكن للعميل مشاركته في أي مكان: وسائل التواصل الاجتماعي، تطبيقات المراسلة، توقيع البريد. عند فتح الزائر للرابط يُخزن الكود في متصفحه حتى ٣٠ يومًا، وإذا سجّل خلال هذه الفترة يُربط بصاحب الإحالة.

حالات استخدام شائعة

دمج الولاء مع الإحالة

اجمع برنامج الإحالة مع برنامج الولاء لمكافأة صاحب الإحالة (عمولة في المحفظة) والمستخدم المُحال (نقاط تسجيل).

الحملات الموسمية

ارفع نسبة العمولة مؤقتًا خلال عرض ترويجي ثم أعدها بعد انتهاء الحملة.

رصد أبرز المروّجين

استخدم مرشح صاحب الإحالة في قائمة إحالات العملاء لرؤية أكثر العملاء مساهمة في العمولات، أو رتّب حسب مبلغ العمولة لاكتشاف أعلى الأرباح الفردية — ويمكن إرسال رسالة شكر أو ترقيتهم إلى فئة VIP.

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

عميل مُحال قام بطلب لكن صاحب الإحالة لم يحصل على عمولة 1. تأكد أن البرنامج مفعّل في الإعدادات. 2. تأكد أن الطلب مدفوع فعلاً. 3. تأكد أن referrer_id مضبوط للعميل المُحال (يمكنك رؤيته في علامة تبويب إحالة بصفحة تعديل المستخدم، ويظهر أيضًا في قائمة إحالات العملاء عند تسجيل أي عمولة). 4. تأكد أن حساب صاحب الإحالة نشط. 5. إذا كان قصر الوصول للإحالة على مستخدمين محددين مفعّلاً، تأكد أن صاحب الإحالة موجود في قائمة المستخدمون المسموح لهم بالإحالة — فالمستخدمون خارج القائمة تُتجاهل عمولاتهم بهدوء.

العميل لا يرى رابط الإحالات في القائمة - إذا كان قصر الوصول للإحالة على مستخدمين محددين مفعّلاً، فإن المستخدمين الموجودين في قائمة المستخدمون المسموح لهم بالإحالة فقط هم من يرون الرابط ويستطيعون فتح /profile/referrals. أضِفهم إلى القائمة، أو أوقف الخيار.

رابط الإحالة لم يربط العميل بالصاحب - قد يقوم المتصفح أحيانًا بمسح الكوكيز، ويجب إكمال التسجيل خلال ٣٠ يومًا من فتح الرابط. - سيعمل الربط فقط إذا كان البرنامج مفعّلًا وقت الزيارة. - إذا كانت القائمة البيضاء مفعّلة وصاحب الإحالة خارجها، تُلغى الإحالة عند التسجيل — يكتمل التسجيل بنجاح، لكن الحساب الجديد ينتهي بدون صاحب إحالة.

زائر أدخل كود إحالة في نموذج التسجيل وحصل على خطأ - يرفض النموذج الأكواد غير المعروفة برسالة "رمز الإحالة هذا غير صالح". تأكد أن الكود يطابق كود إحالة عميل موجود (يمكن رؤيته في علامة تبويب إحالة بصفحة تعديل المستخدم، أو في لوحة الأرباح الخاصة به). - الأكواد مكوّنة من ٨ خانات بأحرف كبيرة وأرقام، وغير حساسة لحالة الأحرف عند الإدخال.

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

اختفت عمولة كانت مُضافة أو أصبح الرصيد سالبًا - تحقق إذا كان الطلب قد استُرد. الاسترداد يُنشئ تلقائيًا قيد خصم (customer_referral_commission_reversal) بنفس المبلغ. يمكن رؤية الصفّين في قائمة إحالات العملاء باستخدام مرشح النوع.

أقسام ذات صلة

• محافظ المستخدمين — حيث تُقيد العمولات.
• عمليات المحفظة — السجل الكامل للعمليات.
• عمليات الولاء — نظام مكافآت مشابه مبني على النقاط.
• إعدادات النظام — حيث يتم تفعيل البرنامج وضبطه.