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

تتبّع صحيح، وليس مجرد وجوده

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

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

قواعد عمولة تستطيع شرحها للشريك

ثلاثة إعدادات تغطي تقريبًا كل البرامج:

  • نسبة مئوية من الطلب.
  • مبلغ ثابت لكل عملية بيع.
  • نسبة لشريك واحد، للشريك الذي تفاوضت معه بشكل منفصل.

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

صفحة تجنيد يمكنك تعديلها دون مطوّر

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

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

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

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

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

التكامل

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

عند اكتمال طلب وتعلم أنه جاء من شريك، استدعِ هذا مرة واحدة من خادمك الخلفي:

POST /api/<merchantSlug>/track/conversion
Content-Type: application/json

{
  "orderId": "ORD-12345",
  "amount": 99.00,
  "currency": "USD",
  "affiliateCode": "ABC123"
}
  • orderId هو معرّف طلبك الخاص. وهو ما يُبنى عليه إزالة التكرار، لذا يجب أن يكون فريدًا في جهةك.
  • amount هو الرقم الذي تُحسب منه العمولة، ولا يجب أن يكون إجمالي الطلب إذا كنت تدفع على المجموع الفرعي.
  • affiliateCode اختياري إذا كان الزائر يحمل بالفعل ملف تعريف الارتباط affiliate_ref الذي يضبطه رابط الإحالة. يمكنك أيضًا إرساله في ترويسة x-affiliate-code. إذا لم يكن أي من الثلاثة موجودًا، يُرفض الطلب لأنه لا يوجد أحد يُنسب إليه الفضل.

يحمل الرد العمولة المحسوبة وحالتها. هذا هو التكامل المطلوب بأكمله.

الإبلاغ عن النقرات اختياري ويبدو هكذا:

POST /api/<merchantSlug>/track/click
Content-Type: application/json

{ "affiliateCode": "ABC123" }

تخطيه يكلّفك إحصائيات النقرات فقط ولا شيء غير ذلك؛ العمولة ما زالت تعمل.

أين يناسب هذا وأين لا يناسب

إذا كنت تحتاج إلى عمولات متعددة المستويات، أو نطاق مخصص لكل تاجر، أو مدفوعات تلقائية عبر PayPal أو Stripe، أو عملات غير الدولار الأمريكي، فإن Afflixo لا يفعل هذه اليوم. إذا كان ما تحتاجه هو القائمة أعلاه، فالتكامل هو نقطة نهاية واحدة ويمكنك قراءة المواصفات الدقيقة في وثائق المطوّرين.