ماذا تفعل
يدير Rewardful برامج التسويق بالعمولة فوق Stripe، ويعرف بالبيع من قراءة صفحة الدفع في Stripe لا من استدعاء API منفصل. وتؤدي هذه الإضافة الأمرين اللازمين في موقعك. أولًا، يمكنها وضع سكربت التتبع الخاص بـ Rewardful في صفحاتك العامة باستخدام مفتاح التتبع العلني، فيحصل الزائر الذي يصل عبر رابط مسوّق على معرّف إحالة في متصفحه. وثانيًا، حين يدفع هذا الزائر من السلة، يُرفق معرّف الإحالة بجلسة Stripe Checkout بصفته client_reference_id. فيلتقطه Rewardful من Stripe وينسب البيع إلى المسوّق الصحيح. ولا يُرسل أي شيء من خادمك إلى Rewardful مباشرة، ولا يدخل في العملية أي مفتاح سري.
لمن يناسب
لأصحاب المتاجر الذين يتلقّون المدفوعات عبر Stripe ويديرون برنامج إحالة أو شراكة في Rewardful، أو ينوون ذلك. تحتاج إلى حساب Rewardful مربوط بحساب Stripe نفسه الذي يستخدمه متجرك، إضافةً إلى مفتاح التتبع العلني من إعدادات Rewardful. وهي تناسب البائعين الذين يشتري معظم زبائنهم عبر السلة، لأن السلة هي المسار الذي يُمرَّر فيه معرّف الإحالة.
كيف تعمل
فعّل «تفعيل Rewardful» والصق «مفتاح تتبّع API» من Rewardful، وتجده تحت «الإعدادات» ثم API. المفتاح علني، فلا يوجد سر يلزم حمايته هنا.
مع ترك «إدراج سكربت التتبّع تلقائيًا» مفعّلًا، يُضاف سكربت Rewardful إلى صفحاتك العامة. ولأنه يضع ملف تعريف ارتباط، فلا يصل الزوار في الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية والمملكة المتحدة، ومن لا يُعرف بلده، إلا بعد قبولهم شريط الموافقة. أما سائر الزوار فيصلهم السكربت فورًا.
يصل زائر إلى موقعك عبر رابط أحد المسوّقين. يلاحظ سكربت Rewardful الإحالة ويجعل معرّفها متاحًا في المتصفح.
حين يدفع الزائر من السلة، يقرأ المتجر معرّف الإحالة عند زر الدفع ويضيفه إلى جلسة Stripe Checkout بصفته client_reference_id.
يقرأ Rewardful عملية الدفع المكتملة في Stripe، ويطابق معرّف الإحالة، ويسجّل العمولة لذلك المسوّق في لوحة Rewardful لديك.
الإعدادات التي تضبطها
- تفعيل Rewardful
- معطّل إلى أن تشغّله أنت. يعتمد كلٌّ من السكربت وإحالة الدفع على هذا المفتاح.
- مفتاح تتبّع API
- المفتاح العلني الموجود في إعدادات API في Rewardful. يوضع في وسم السكربت، ولذلك لا يُقبل للإخراج إلا الحروف والأرقام والشرطات والشرطات السفلية.
- إدراج سكربت التتبّع تلقائيًا
- مفعّل افتراضيًا. أوقفه إن كنت قد أضفت سكربت Rewardful بطريقة أخرى. وتبقى الإحالة تُمرَّر إلى Stripe ما دام السكربت موجودًا في الصفحة.
ما تستطيع الوصول إليه
تخزّن الإضافة مفتاح تتبع Rewardful العلني في إعدادات موقعك، وتطبعه داخل وسم سكربت Rewardful على الصفحات العامة. وعند الدفع من السلة تقرأ معرّف الإحالة الذي يتيحه سكربت Rewardful في متصفح الزائر، وتضيفه إلى جلسة Stripe Checkout. ولا تجري أي استدعاءات خادم من عندها، ولا تقرأ أي طلبات ولا أعضاء ولا تدوينات.
الأذونات
- تخزين مفتاح تتبّع Rewardful الخاص بك (عام وليس سريًا)
- إدراج معرّف الإحالة الفريد (UUID) الخاص بـ Rewardful في صفحة دفع Stripe كـ client_reference_id
- إصدار سكربت تتبّع Rewardful اختياريًا في الصفحات العامة
الإمكانات
network:fetchui:settings
لقطات الشاشة

حدود نذكرها بصراحة
لا تحمل الإحالة إلا عمليات الدفع من السلة. فروابط الشراء المباشر في صفحات المنتجات المفردة تنشئ جلسة Stripe على الخادم، ولذلك لا تُنسب المبيعات عبر تلك الروابط إلى المسوّقين.
النسب يعمل مع Stripe Checkout وحده. والطلبات المدفوعة عبر PayPal أو Lemon Squeezy أو غيرها من خيارات الدفع لا تُمرَّر إلى Rewardful.
للزوار في الاتحاد الأوروبي والمنطقة الاقتصادية الأوروبية والمملكة المتحدة، أو من يتعذر كشف بلدهم، ينتظر سكربت التتبع قبولهم في شريط الموافقة. ومن يرفض الشريط أو يتجاهله لا يُتتبَّع، فلا تُنسب مشترياته إلى أحد.
لا يوجد زر اختبار. تؤكد صحة الإعداد بإجراء عملية شراء تجريبية عبر إحالة، ثم التأكد من ظهورها في Rewardful.
قواعد العمولات والمدفوعات وتسجيل المسوّقين كلها تُعالج في Rewardful. أما الإضافة فلا تفعل سوى ربط عملية البيع بالإحالة.
الأسئلة الشائعة
هل تستدعي الإضافة واجهة Rewardful البرمجية؟
لا. ينسب Rewardful المبيعات بقراءة Stripe، فلا تفعل الإضافة سوى تحميل سكربت المتصفح ووضع معرّف الإحالة على صفحة الدفع في Stripe. فلا طلبات من الخادم إلى Rewardful.
هل مفتاح Rewardful سرّي؟
لا. مفتاح التتبع معدّ ليوضع في شيفرة HTML لصفحتك، شأنه شأن معرّف التحليلات. ومع ذلك يُخزَّن ويُخفى كغيره من مفاتيح الموصّلات، حفاظًا على الاتساق.
ثبّتُّ سكربت Rewardful بنفسي من قبل. ماذا أفعل؟
أوقف «إدراج سكربت التتبّع تلقائيًا» حتى لا يُحمَّل السكربت مرتين. وأبقِ «تفعيل Rewardful» مفعّلًا، لأن هذا المفتاح هو الذي يتحكم في معرّف الإحالة المرسل إلى Stripe.
لماذا لم تُنسب عملية بيع جرت من صفحة منتج؟
رابط الشراء في صفحة المنتج المفرد يُجهَّز قبل أن ينقر الزائر عليه، فلا يمكن أن يتضمن معرّف الإحالة القادم من المتصفح. أما المشتريات التي تتم عبر السلة فهي التي تحمله.
إضافات ذات صلة
المواصفات
- الفئة
- marketing
- السعر
- مضمَّن
- الإصدار
- 1.0.0
- المصدر
- من الطرف الأول
تصفّح المزيد من التكاملات
57 تكامل أصلي مجاني متاح.