كيفية دمج StopChurn

تعرّف على كيفية ربط StopChurn بمنصة B2CORE لمزامنة بيانات العملاء وأحداثهم الرئيسية من أجل الاحتفاظ بالعملاء وسير عمل إدارة علاقات العملاء

استخدم التكامل مع StopChurn لإرسال بيانات العملاء وأحداثهم الرئيسية تلقائيًا من B2CORE إلى StopChurn، وهي منصة للاحتفاظ بالعملاء وإدارة علاقات العملاء. ويمكن لـ StopChurn بعد ذلك استخدام هذه البيانات لتقسيم العملاء إلى شرائح وتشغيل حملات الاحتفاظ بهم.

يدعم التكامل نقل البيانات في اتجاه واحد من B2CORE إلى StopChurn. وتُعد B2CORE المصدر الوحيد للبيانات المعتمدة: لا تتلقى StopChurn سوى البيانات، ولا تُعاد قراءة أي بيانات منها إلى B2CORE.

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

إعداد StopChurn

أكمل هذه الخطوات في StopChurn قبل تفعيل الاتصال في B2CORE.

التحقق من حقول جدول جهات الاتصال

في المكتب الخلفي في StopChurn، انتقل إلى قاعدة البيانات > تعريفات الجداول وافتح جدول المستخدمين (جهات الاتصال). تملأ B2CORE الحقول التالية لكل جهة اتصال في StopChurn:

الهوية: المعرّف، البريد الإلكتروني، رقم الهاتف، الاسم الأول، اسم العائلة، تاريخ الميلاد
الموقع والملف الشخصي: البلد (الاسم)، رمز البلد، العملة، الولاية القضائية، اللغة، نوع العميل (فرد أو شركة)، تاريخ التسجيل، مستوى التحقق
التحقق من هوية العميل (KYC): حالة التحقق، تاريخ تقديم طلب التحقق، تاريخ الموافقة على التحقق
الإيداعات: تاريخ أول إيداع وآخر إيداع ومبلغهما، إجمالي مبلغ الإيداعات، صافي الإيداعات
التداول: تاريخ أول صفقة وآخر صفقة، إجمالي عدد الصفقات، تاريخ فتح حساب التداول
إسناد التسويق: مصدر UTM، وسيط UTM، حملة UTM، معرّف الشريك التابع
تفضيلات التسويق (البريد الإلكتروني والهاتف): تُعطَّل عندما يُلغي العميل اشتراكه في الرسائل التسويقية أو لا يمنح موافقته على تلقيها
تفضيلات النظام (البريد الإلكتروني والهاتف): مفعّلة دائمًا

تُرسل التواريخ على هيئة طوابع زمنية. وعملة جهة الاتصال هي دائمًا USD، وجميع مبالغ الإيداعات المسجّلة لجهة الاتصال مقوّمة بالدولار الأمريكي.

إنشاء أحداث مخصّصة

ترسل B2CORE ستة أحداث مخصّصة إلى StopChurn. أنشئ كل حدث منها في قاعدة البيانات > تعريفات الجداول بالنقر على حدث مخصّص جديد:

الاسم — يجب أن يطابق القيمة الواردة في الجدول أدناه تمامًا.
التسمية — أي نص تختاره.
نوع القيمة — حقل مطلوب؛ يجب أن يطابق القيمة الواردة في الجدول أدناه.

الحدث	الاسم	نوع القيمة	القيمة
اكتمال التسجيل	`REGISTRATION_COMPLETED`	`BOOLEAN`	دائمًا `true`
تغيّر مستوى التحقق	`VERIFICATION_LEVEL_CHANGED`	`NUMBER`	مستوى التحقق الجديد للعميل
الموافقة على التحقق من هوية العميل	`KYC_APPROVED`	`BOOLEAN`	دائمًا `true`
رفض التحقق من هوية العميل	`KYC_REJECTED`	`STRING`	سبب الرفض (قد يكون فارغًا)
اكتمال الإيداع	`DEPOSIT_COMPLETED`	`JSON`	تفاصيل الإيداع (راجع حقول حدث الإيداع)
أول إيداع	`FIRST_DEPOSIT`	`JSON`	تفاصيل الإيداع (راجع حقول حدث الإيداع). يُرسل فقط عند أول إيداع ناجح للعميل

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

حقول حدث الإيداع

يحتوي حدثا اكتمال الإيداع وأول إيداع على الحقول التالية:

amount — مبلغ الإيداع بعملة الإيداع.
currency — عملة الإيداع، مثل EUR.
amountInUSD — مبلغ الإيداع بعد تحويله إلى الدولار الأمريكي بسعر الصرف وقت اكتمال الإيداع، مع تقريبه إلى منزلتين عشريتين. يكون فارغًا إذا لم يتوفر لدى B2CORE سعر صرف إلى الدولار الأمريكي لعملة الإيداع في ذلك الوقت؛ ويظل الحدث يُرسل.
paymentSystem — اسم طريقة الإيداع التي استخدمها العميل، كما هو محدد تمامًا في حقل الاسم الخاص بالطريقة في النظام > نظام الإيداع، مثل b2binpay_enterprise.

إذا كنت تستخدم حدث الإيداع هدفًا للتحويل في StopChurn، فاضبط amountInUSD بوصفه قيمة الهدف، حتى تُقاس جميع الإيداعات بعملة واحدة.

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

تهيئة اتصال بـ StopChurn في المكتب الخلفي في B2CORE

لتهيئة اتصال بـ StopChurn:

انتقل إلى النظام > الاتصالات الخارجية.

انقر على +إنشاء في الزاوية العلوية اليمنى من الصفحة.

في صفحة إنشاء اتصال، املأ الحقول التالية:

في حقل الاسم، أدخل اسمًا للاتصال. يجب أن يكون الاسم فريدًا.
في حقل التسمية التوضيحية، أدخل تسمية توضيحية ستُعرض للاتصال في المكتب الخلفي.
من القائمة المنسدلة المزوّد، اختر StopChurn.

انقر على حفظ لإنشاء الاتصال.

سيظهر اتصال StopChurn في قائمة الاتصالات الخارجية.

انقر على تعديل لإدخال تفاصيل الاتصال وإكمال الحقول التالية:

البيئة — اختر بيئة StopChurn: Staging أو Production.
مفتاح API — أدخل مفتاح API الذي قدّمته StopChurn.
معرّف العلامة التجارية — أدخل معرّف العلامة التجارية في StopChurn التي ستتلقى البيانات.
اسم جدول المستخدمين — اختياري. اتركه فارغًا لاستخدام جدول user الافتراضي في StopChurn.
استراتيجية المعرّف الخارجي — اختر القيمة التي تستخدمها B2CORE معرّفًا لجهة الاتصال في StopChurn:
- معرّف العميل في B2CORE (الافتراضي)
- البريد الإلكتروني للعميل في B2CORE
- UUIDv7 عشوائي
بادئة المعرّف الخارجي — نص اختياري يُضاف قبل معرّف جهة الاتصال. الأحرف المسموح بها: الحروف والأرقام و_ . : -؛ بحد أقصى 32 حرفًا. استخدم بادئة عندما تشترك عدة علامات تجارية أو مثيلات من B2CORE في حساب StopChurn واحد، حتى لا تتداخل معرّفات جهات الاتصال لديها.

انقر على اختبار الاتصال للتحقق من قبول StopChurn لمفتاح API. لا ينشئ الاختبار أي بيانات في StopChurn ولا يغيّرها.

تحقق من حالة الاتصال.

إذا كان الاتصال غير نشط (تظهر القيمة No في حقل مفعّل)، ففعّله بتعيين القائمة المنسدلة مفعّل على Yes.

انقر على حفظ لتطبيق التغييرات.

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

يمكنك تفعيل عدة اتصالات بـ StopChurn في الوقت نفسه، مثل اتصال لكل علامة تجارية في StopChurn. يتلقى كل اتصال مفعّل جميع بيانات العملاء وأحداثهم.

لإرسال عملائك الحاليين إلى StopChurn بعد تفعيل الاتصال واختباره، اطلب تحميلًا أوليًا.

البيانات المرسلة إلى StopChurn

ترسل B2CORE البيانات إلى StopChurn تلقائيًا. بعد نحو دقيقة من أي إجراء أدناه، ترسل B2CORE سجل جهة الاتصال الكامل والمحدّث للعميل، إلى جانب الأحداث ذات الصلة:

الإجراء في B2CORE	الأحداث المرسلة
تسجيل العميل	اكتمال التسجيل
تغيّر البريد الإلكتروني للعميل أو حالته أو بلده أو نوعه أو مستوى التحقق منه أو ولايته القضائية	—
تغيّر الاسم الأول للعميل أو اسم عائلته أو تاريخ ميلاده	—
تغيّر رقم هاتف العميل	—
تقديم العميل طلب تحقق	تغيّر مستوى التحقق
الموافقة على طلب تحقق	تغيّر مستوى التحقق، الموافقة على التحقق من هوية العميل
رفض طلب تحقق	تغيّر مستوى التحقق، رفض التحقق من هوية العميل (مع السبب)
اكتمال إيداع بنجاح	اكتمال الإيداع؛ وكذلك أول إيداع إذا كان أول إيداع ناجح للعميل
إلغاء العميل اشتراكه في الرسائل التسويقية أو إعادة اشتراكه فيها	—

يحدّث كل إرسال جهة الاتصال بالكامل في StopChurn، لذا يمكن إرسال العميل نفسه أكثر من مرة بأمان.

التحميل الأولي لجميع العملاء

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

إعادة مزامنة جهات الاتصال المحدّثة مؤخرًا

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

لا تحل إعادة مزامنة جهات الاتصال محل التحميل الأولي. لا تشمل العملية العملاء الذين لم تُحدّث بياناتهم خلال الشهر الماضي.

لإعادة مزامنة جهات الاتصال المحدّثة مؤخرًا:

انتقل إلى النظام > الاتصالات الخارجية وافتح اتصال StopChurn.

انقر على الإجراءات > إعادة مزامنة جهات الاتصال.

تؤكد رسالة خضراء بدء إعادة المزامنة. وتُنفّذ العملية في الخلفية.

ضع ما يلي في اعتبارك:

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

ملاحظات وقيود

عملة جهة الاتصال هي دائمًا USD، وجميع مبالغ الإيداعات المسجّلة لجهة الاتصال مقوّمة بالدولار الأمريكي. تتضمن أحداث الإيداع المبلغ الأصلي وعملته، بالإضافة إلى المبلغ بالدولار الأمريكي (amountInUSD).
لا توضّح وثائق StopChurn المكان الذي يمكن فيه عرض الأحداث المستلَمة. استفسر من فريق StopChurn.

كيفية دمج StopChurn

في هذه الصفحة