كيف أربط Tapfiliate لدفع عمولات الشركاء التابعين على المبيعات الحقيقية؟
ألصق مفتاح API الخاص بـ Tapfiliate وفعّل الموصل، فيُبلّغ كل طلب مكتمل عن تحويل يُطابَق ببريد المشتري — لتتبع العمولات المبيعات الحقيقية.
يبلّغ موصل Tapfiliate عن كل طلب مكتمل إلى Tapfiliate كتحويل، لكي يحسب برنامج الشركاء التابعين لديك العمولات من الطلبات المكتملة الحقيقية في متجرك.
تثبيت الإضافة وقائمة الفحص العامة عندما يبدو الموصل غير فاعل مشتركان في كل التكاملات وموجودان في الدليل المشترك للتكاملات. وهذه المقالة هي جزء Tapfiliate فقط.
الخطوة 1 — احصل على مفتاح API الخاص بـ Tapfiliate
في Tapfiliate اذهب إلى Settings ← API Keys وانسخ مفتاح API الخاص بك.
الخطوة 2 — املأ لوحة Tapfiliate
افتح «لوحة التحكم ← الإضافات ← Tapfiliate» والصق مفتاح API. في اللوحة بعد ذلك مفتاحان ضمن قسم «مزامنة الأحداث». «تفعيل Tapfiliate» هو المفتاح الرئيسي ويبدأ مُعطَّلًا، فلا يبلّغ الموصل عن شيء حتى تشغّله. و«الإبلاغ عن الطلبات المكتملة» يرسل التحويل بعد كل عملية شراء ناجحة، وهو مفعّل افتراضيًا. اضغط «حفظ الإعدادات»، ثم «اختبار الاتصال».
لا تملك Tapfiliate نقطة فحص بسيطة، فيرسل الاختبار تحويلًا واحدًا بقيمة صفر دولار، مرجع طلبه velocms-connection-test متبوعًا بطابع زمني، وعميله velocms-connection-test. ولا يفشل الاختبار إلا حين ترفض Tapfiliate المفتاح بوصفه غير مصرّح. فنجاح الاختبار يثبت أن المفتاح يعمل، لا أن التحويل بقيمة صفر قُبل كبيعة حقيقية.
الخطوة 3 — وضع النسب
تعرض اللوحة وضعَي نسب: «البريد الإلكتروني للعميل» و«رمز الإحالة». اختر «البريد الإلكتروني للعميل». فالمشتري يُعرَّف لدى Tapfiliate ببريده الإلكتروني، وهو ما تعدّه Tapfiliate نسبًا مدى الحياة ولا يحتاج إلى تتبع النقرات. أما «رمز الإحالة» فلا مصدر له بعد، لأن VeloCMS لا يلتقط رمز إحالة عند الدفع، فيتصرف هذا الخيار اليوم تمامًا كالبريد الإلكتروني للعميل.
ويعني هذا أيضًا أن VeloCMS لا يضيف نص تتبع النقرات الخاص بـ Tapfiliate إلى صفحاتك. أما رابط الشريك وكيف تربط Tapfiliate نقرة ببريد العميل فيُضبطان من جهة Tapfiliate.
ما الذي يُرسَل
- رقم الطلب في VeloCMS، معرّفًا خارجيًا للتحويل. تستخدمه Tapfiliate لتتعرف على التكرار، فلا يُحتسب إعادة إرسال الطلب مرتين.
- إجمالي الطلب مبلغًا للتحويل.
- بريد المشتري الإلكتروني عميلًا.
الطلب الذي لا يحمل بريد عميل يُتخطّى. ثم تطابق Tapfiliate التحويل مع الشريك المُحيل وتحسب عمولته وفق قواعد برنامجك.
إذا تعذّر الوصول إلى Tapfiliate مؤقتًا أو كان مفتاح API خاطئًا، يفشل تقرير التحويل بصمت في الخلفية — ولا يعطّل أو يؤخّر الطلب نفسه أبدًا. وتظهر الإخفاقات في «التكاملات ← نشاط المزامنة»؛ وليس لـ Tapfiliate زر إعادة المحاولة هناك.
قطع الاتصال
أوقف «تفعيل Tapfiliate»، أو امسح مفتاح API في نفس اللوحة، لإيقاف الإبلاغ عن التحويلات. العمولات التي أُبلغ عنها بالفعل إلى Tapfiliate تبقى دون تغيير؛ ولن يُبلَّغ عن أي طلبات جديدة بعد قطع الاتصال.