ينقل Tajo البيانات من نظام مصدرك إلى Brevo عبر قواعد مزامنة منضبطة: معتمدة بشريًا، وأحادية الاتجاه، وتعمل وفق جدول، ومسجَّلة من البداية إلى النهاية. يشرح هذا المقال ما يعنيه ذلك عمليًا وما لا يشمله.
تحقق سريع يفترض هذا المقال أنك ربطت Shopify و Brevo ونشرت قاعدة مزامنة واحدة على الأقل. إن لم تكن قد فعلت، فابدأ بمقال ربط Tajo بـ Shopify.
شكل المزامنة
كل مزامنة في Tajo هي قاعدة مزامنة: تعريف مُراجَع ومعتمد لما ينتقل بالضبط وكيف. للقاعدة أربعة أجزاء يمكنك فحصها في صفحتها تحت Connectors > Syncs:
| الجزء | ما يفعله |
|---|---|
| ربط الحقول | كل حقل مصدر، وحقل Brevo الذي يكتب إليه، وأي تحويل بينهما |
| تعبير التصفية | يُقيَّم لكل سجل؛ السجلات التي لا تطابقه تُتخطى |
| المؤشر (Cursor) | يتتبع مدى تقدم المزامنة، بحيث يستأنف كل تشغيل من حيث توقف السابق |
| سجل التشغيلات | كل تشغيل، مع عدد السجلات المقروءة والمكتوبة والفاشلة، إضافة إلى المدة والحالة |
تتدفق البيانات في اتجاه واحد: من مصدرك إلى Brevo. لا يكتب Tajo أي بيانات عائدة إلى Shopify.
متى تتزامن البيانات
تحدث تشغيلات المزامنة على دفعات مجدولة، أو عند الطلب عندما تشغّلها من صفحة القاعدة. Tajo ليس خط أنابيب في الوقت الفعلي: أي تغيير في Shopify يصل إلى Brevo في التشغيل التالي، لا خلال ثوانٍ. هذا مقصود؛ فالتشغيل على دفعات هو ما يجعل كل كتابة قابلة للمراجعة، ومحكومة بميزانية، ومنسوبة إلى تشغيل محدد في سجل التدقيق.
يقرأ كل تشغيل السجلات الجديدة والمتغيرة منذ موضع المؤشر، ويطبق التصفية، ويربط الحقول، ويكتب إلى Brevo. يُظهر سجل التشغيل بدقة عدد السجلات المقروءة والمكتوبة والفاشلة.
ضمانات الحوكمة
الموافقة تفشل نحو الإغلاق (fails closed)
لا يمكن نشر قاعدة مزامنة بدون سياسة موافقة، وفي وقت التشغيل لا يُكتب أي سجل لا موافقة مثبتة له. عندما يتعذر إثبات الموافقة، يرفض Tajo الكتابة بدلًا من التخمين. نمط الفشل دائمًا “حذر أكثر من اللازم”، وليس “أرسل أكثر من اللازم”.
التشغيلات لا تُنشئ تكرارات (idempotent)
تحمل كل كتابة مفتاح أصل مشتقًا من سجل المصدر (مبنيًا بطريقة تحمي البيانات الشخصية)، لذا فإن إعادة تشغيل المزامنة، بعد فشل أو توقف مؤقت أو يدويًا، لا تُنشئ كتابات مكررة. من الآمن دائمًا إعادة تشغيل القاعدة.
كل شيء مُدقَّق
نشر القاعدة، وكل قرار اعتماد (مع مبرره المكتوب)، وكل تشغيل، كلها تُسجَّل في سجل التدقيق. الاعتماد الذي أجاز النشر مرتبط بإصدار القاعدة الدقيق الذي جرت مراجعته؛ وتعديل القاعدة يُلغي الاعتماد، لذا يعكس سجل التدقيق دائمًا ما جرت إجازته فعلًا.
الإخفاقات توقف القاعدة مؤقتًا
إذا فشلت عدة تشغيلات متتالية، يوقف قاطع الدائرة القاعدة تلقائيًا ويعرض آخر خطأ في صفحتها. أصلح السبب، ثم أعد النشر للاستئناف. التشغيل الذي فشل جزئيًا يبلّغ عن عدد سجلاته الفاشلة، فترى بدقة ما لم يصل.
كيف تُحترم حالات إلغاء الاشتراك
يتعامل Tajo مع Brevo بوصفه مصدر الحقيقة لموافقات البريد الإلكتروني:
- عندما يلغي جهة اتصال اشتراكها عبر رابط في تذييل رسالة من Brevo، يُسجَّل ذلك الانسحاب على جهة الاتصال، ويستبعدها Brevo من الحملات اللاحقة.
- جهات الاتصال المدرجة في القائمة السوداء في Brevo تبقى مستبعدة؛ فالإرسالات اللاحقة لا تعيد إحياءها.
- Tajo لا يعيد حالة إلغاء الاشتراك إلى Shopify. إذا كنت تجمع موافقات البريد الإلكتروني في Shopify أيضًا، فأدرها هناك على نحو منفصل؛ ولا تفترض أن النظامين يعكس أحدهما الآخر.
ما البيانات المتاحة
ما يتزامن يعتمد على القوالب المتاحة لمصدرك. بالنسبة إلى Shopify، الشكل المعتاد هو سجلات العملاء، أي حقول الهوية والسمات المشتقة من الطلبات مثل إجمالي الإنفاق وعدد الطلبات، مربوطة بسمات جهات اتصال Brevo التي يمكنك استخدامها في الشرائح والحملات. الربط الدقيق لمساحة عملك ليس مخفيًا في وصف: افتح قاعدة المزامنة واقرأ جدول ربط الحقول. ذلك الجدول هو الإجابة المرجعية عن سؤال “ما الذي يتزامن؟”.
ما لا يفعله Tajo اليوم
الدقة في تحديد الحدود أهم من قائمة ميزات طويلة:
- لا مزامنة ثنائية الاتجاه. لا يُكتب أي شيء عائدًا إلى Shopify؛ لا حالات إلغاء الاشتراك، ولا الوسوم، ولا درجات التفاعل.
- لا مزامنة في الوقت الفعلي. التشغيلات دفعات مجدولة أو مُشغَّلة يدويًا، وليست بثًا دون الدقيقة.
- لا تتبع للمخزون. مستويات مخزون المنتجات لا تُراقب، ولا توجد مُحفِّزات “عاد إلى المخزون”.
إذا كان أحد هذه الحدود يعيق حالة استخدام لديك، فأخبر الفريق؛ فأولويات الوصول المبكر تتشكل بهذا النوع من الملاحظات تحديدًا.
أين ترى بياناتك
- في Tajo: افتح قاعدة المزامنة تحت Connectors > Syncs لسجل التشغيلات وموضع المؤشر وأعداد كل تشغيل. يسجل سجل التدقيق عمليات النشر والاعتمادات.
- في Brevo: افتح Contacts (جهات الاتصال) وافحص سمات أي جهة اتصال لتتأكد من امتلاء الحقول المربوطة. ابنِ شرائح على تلك السمات للاستهداف.
استكشاف الأخطاء وإصلاحها
- جهات الاتصال لا تظهر في Brevo: افحص آخر تشغيل للقاعدة بحثًا عن إخفاقات، وافحص حالتها (القاعدة الموقوفة مؤقتًا لا تعمل). راجع جهات اتصال مفقودة في Brevo.
- تشغيلات تفشل مرارًا: سيوقف قاطع الدائرة القاعدة مؤقتًا ويعرض آخر خطأ. راجع البيانات لا تتزامن.
- جهات اتصال مكررة: الكتابات لا تتكرر لكل سجل مصدر، لكن التكرارات الموجودة مسبقًا في Brevo تبقى. راجع جهات الاتصال المكررة.
أسئلة شائعة
هل يمكنني جعل المزامنة أسرع؟ يمكنك تشغيل المزامنة عند الطلب في أي وقت من صفحة قاعدة المزامنة. لا يوجد وضع في الوقت الفعلي.
ماذا يحدث إذا فشل تشغيل في منتصفه؟ يبلّغ التشغيل عن عدد سجلاته الفاشلة، ولا يتقدم المؤشر إلا فوق ما جرت معالجته، ويعيد التشغيل التالي تغطية المسافة بأمان؛ فمفاتيح منع التكرار تحول دون الكتابات المكررة.
هل يمكنني تغيير ما يتزامن؟ نعم؛ عدّل ربط حقول القاعدة أو تصفيتها. ينتج التعديل إصدارًا جديدًا يجب أن يمر مجددًا باعتماد النشر قبل أن يسري.
لماذا أوقفت قاعدتي نفسها مؤقتًا؟ إخفاقات التشغيل المتتالية تُفعِّل قاطع الدائرة. تعرض صفحة القاعدة عدد الإخفاقات وآخر خطأ؛ أصلح المشكلة وأعد النشر.
مقالات ذات صلة
- ربط Tajo بـ Shopify
- أساسيات تقسيم الشرائح
- استكشاف الأخطاء: البيانات لا تتزامن
- استكشاف الأخطاء: جهات اتصال مفقودة في Brevo
الحصول على المساعدة
- الدردشة المباشرة: متاحة في لوحة تحكم Tajo (أسفل اليمين)
- الدعم عبر البريد الإلكتروني: [email protected]
- التوثيق: docs.tajo.io