تكامل Magento

تحتاج إلى مساعدة المطور

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

نظرة عامة على التكامل

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

نوع التكامل

الوجهة: يقوم هذا التكامل بدفع البيانات من متجر Magento الخاص بك إلى Pushwoosh.

المتطلبات الأساسية

قبل المتابعة، تأكد من توفر ما يلي:

• الوصول إلى لوحة تحكم Magento Admin Panel

• حساب Pushwoosh صالح

• رمز الوصول إلى واجهة برمجة التطبيقات (API access token) ورمز التطبيق (App code) الخاصين بـ Pushwoosh

• تثبيت Composer على خادم Magento الخاص بك

• استيفاء متطلبات النظام:

  • PHP 7.4 / 8.x
  • Magento 2.3 / 2.4
  • Elasticsearch 7
  • RabbitMQ

مسرد المصطلحات

ربط أسماء الكيانات إذا كانت مختلفة:

Magento	Pushwoosh
Customer	User

قائمة الكيانات المتزامنة:

• العملاء
• الطلبات
• سلات التسوق المتروكة

حالات الاستخدام

• إرسال إشعارات الدفع (push notifications) بناءً على أحداث إنشاء الطلبات وترك سلات التسوق.

• تقسيم العملاء بناءً على السمات (مثل الموقع، تاريخ الميلاد) وإرسال حملات مستهدفة.

• إرسال إشعارات ترويجية عبر المتصفح.

إعداد التكامل

التثبيت

ملاحظة

لتثبيت تكامل Pushwoosh، تأكد من أن لديك Composer مثبتًا.

1. قم بتشغيل أمر Composer التالي في المجلد الجذر لمشروع Magento الخاص بك:

composer require pushwoosh/magento2-integration

2. بمجرد تثبيت الحزمة، قم بتشغيل إعداد Magento لتثبيت الوحدة:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

التكوين بعد التثبيت

بعد إكمال التثبيت:

1. سجل الدخول إلى لوحة تحكم Magento Admin.

2. انتقل إلى المتاجر > التكوين > Pushwoosh > التكوين.

الإعدادات العامة

في قسم General، قم بتكوين الحقول التالية:

• Status: اضبط هذا على Enable لتفعيل التكامل.
• API URL: أدخل نقطة نهاية Pushwoosh API: https://api.pushwoosh.com/
• API Key: الصق مفتاح Pushwoosh API الخاص بك المطلوب لمصادقة الطلبات. تعرف على المزيد حول مفتاح الوصول إلى Pushwoosh API
• App Code: أدخل رمز تطبيق Pushwoosh المقابل لتطبيقك المحمول أو الويب.

فيما يلي خيارات التكوين المتاحة لمزامنة العملاء والطلبات وسلات التسوق المتروكة.

تكوين مزامنة الطلبات

حدد كيفية مزامنة بيانات الطلبات بين متجر Magento الخاص بك و Pushwoosh.

املأ الحقول التالية:

Order Sync Enable	اضبط على Yes لتمكين المزامنة التلقائية للطلبات. إذا تم تمكينه، ستتبع العملية جدول cron المحدد. اضبط على No لتعطيل المزامنة التلقائية.
Cron Settings	متاح فقط إذا تم تمكين مزامنة الطلبات. حدد متى يجب تشغيل مهمة cron باستخدام الحقول التالية: Minute، Hour، Day، Month، Weekday. Cron هو مجدول زمني يستخدم لتشغيل المهام تلقائيًا في فترات زمنية محددة.
Order Sync Numbers	حدد عدد الطلبات التي سيتم معالجتها خلال كل تنفيذ للمزامنة.
Order Sync in Real Time	اضبط على Yes لمزامنة الطلبات فور وضعها.

هنا يمكنك أيضًا رؤية حالة مزامنة الطلبات:

• Total Orders: يعرض العدد الإجمالي للطلبات التي تم تقييمها للمزامنة.
• Synced Orders: عدد الطلبات التي تمت مزامنتها بنجاح مع Pushwoosh.
• Not Synced Orders: الطلبات التي لم تتم مزامنتها بعد.
• Fail Synced Orders: الطلبات التي فشلت محاولات مزامنتها.

تكوين مزامنة سلات التسوق المتروكة

قم بتكوين مزامنة بيانات سلات التسوق المتروكة بين متجر Magento الخاص بك و Pushwoosh.

املأ الحقول التالية:

Abandoned Cart Syncing	اضبط على Yes لتمكين المزامنة التلقائية لبيانات سلات التسوق المتروكة. إذا تم تمكينه، تعمل المزامنة وفقًا لجدول cron المحدد.
Cron Schedule Configuration	حدد متى يجب تشغيل المزامنة باستخدام الحقول التالية: Minute، Hour، Day، Month، Weekday. Cron هو مجدول مهام زمني يقوم بتشغيل المهام تلقائيًا في فترات زمنية محددة.
Number of Abandoned Cart	حدد عدد سلات التسوق المتروكة التي ستتم معالجتها خلال كل تشغيل للمزامنة.
Minimum Inactivity Time	اضبط الحد الأدنى لوقت عدم النشاط (بالدقائق) لاعتبار السلة متروكة. على سبيل المثال، 60 يعني أن السلات غير النشطة لمدة 60 دقيقة على الأقل ستكون مؤهلة للمزامنة.

هنا يمكنك أيضًا رؤية مقاييس في الوقت الفعلي حول نشاط المزامنة:

• Total Abandoned Carts: العدد الإجمالي للسلات التي تم تحديدها على أنها متروكة.
• Synced Abandoned Carts: عدد السلات التي تمت مزامنتها بنجاح مع Pushwoosh.
• Not Synced Abandoned Carts: عدد السلات التي لم تتم مزامنتها بعد.
• Fail Synced Abandoned Carts: عدد السلات التي فشلت مزامنتها.

تكوين مزامنة العملاء

قم بتكوين مزامنة بيانات العملاء من متجر Magento الخاص بك إلى Pushwoosh لتمكين تقسيم الجمهور والرسائل المخصصة بناءً على سمات العملاء.

املأ الحقول التالية:

Customer Syncing	اضبط على Yes لتمكين مزامنة جميع سجلات العملاء الحالية والجديدة. ستتبع المزامنة جدول cron المحدد وتستخدم تعيينات السمات المحددة.
Cron Schedule Configuration	حدد متى يجب تشغيل المزامنة باستخدام الحقول التالية: Minute، Hour، Day، Month، Weekday. Cron هو مجدول مهام زمني يقوم بتشغيل المهام تلقائيًا في فترات زمنية محددة.
Mapping Customer Custom Fields	قم بتعيين سمات عملاء Magento إلى حقول Pushwoosh المخصصة لنقل البيانات بدقة. أمثلة: Date of Birth → Birthday، First Name → firstName
Number of Customers	اضبط الحد الأقصى لعدد العملاء الذين سيتم مزامنتهم في كل تشغيل لـ cron.

هنا يمكنك أيضًا رؤية إحصائيات المزامنة:

• Total Customer: العدد الإجمالي لسجلات العملاء المحددة للمزامنة.
• Synced Customer: عدد العملاء الذين تمت مزامنتهم بنجاح مع Pushwoosh.
• Not Synced Customer: العملاء الذين ينتظرون المزامنة.
• Fail Synced Customer: العملاء الذين فشلت مزامنتهم بسبب أخطاء.

تكوين إشعارات الويب

اضبط على Yes لتمكين إشعارات الدفع عبر الويب لزوار متجرك. اضبط على No لتعطيل هذه الوظيفة.

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

حفظ التكوين

بمجرد إكمال جميع الحقول المطلوبة، انقر فوق زر Save Config الموجود في الزاوية اليمنى العليا. امسح ذاكرة التخزين المؤقت لـ Magento إذا طُلب منك تطبيق التغييرات.

خيارات المزامنة اليدوية

مزامنة عملاء محددين إلى Pushwoosh

إذا كنت تفضل عدم مزامنة جميع العملاء تلقائيًا، يمكنك مزامنة عملاء فرديين أو محددين يدويًا.

1. في لوحة تحكم Magento Admin، انتقل إلى العملاء > كل العملاء.
2. حدد موقع العميل (العملاء) الذي ترغب في مزامنته واختره.
3. من القائمة المنسدلة Actions فوق قائمة العملاء، اختر Sync to Pushwoosh.

بمجرد اكتمال المزامنة، ستظهر بيانات العميل في قسم User Explorer في حساب Pushwoosh الخاص بك، مع نقل جميع المعلومات ذات الصلة من Magento.

مزامنة طلبات محددة إلى Pushwoosh

إذا كنت تفضل عدم مزامنة جميع الطلبات تلقائيًا، يمكنك مزامنة طلبات محددة يدويًا. لهذا الغرض:

1. في لوحة تحكم Magento Admin، انتقل إلى المبيعات > الطلبات.

2. حدد طلبًا واحدًا أو أكثر من القائمة.

3. من القائمة المنسدلة Actions، اختر Sync to Pushwoosh.

بعد المزامنة، سيظهر الطلب في قسم الأحداث في ملف تعريف المستخدم في User Explorer الخاص بـ Pushwoosh كحدث PW_OrderCreated أو PW_OrderUpdated (إذا تغيرت حالة الطلب)، بما في ذلك معلومات الطلب التفصيلية.

مزامنة سلات التسوق المتروكة المحددة

لمزامنة سلات التسوق المتروكة المحددة يدويًا:

1. في لوحة تحكم Magento Admin، انتقل إلى قسم Abandoned Carts.
2. حدد السلة التي تريد مزامنتها.
3. من القائمة المنسدلة Actions، اختر Sync to Pushwoosh.

ملاحظة: تأكد من أنك قمت بتكوين فترة عدم النشاط المطلوبة في إعدادات Abandoned Cart Sync لتحديد متى تعتبر السلة متروكة.

بعد المزامنة، ستظهر بيانات سلة التسوق المتروكة في قسم Events في ملف تعريف المستخدم في User Explorer الخاص بـ Pushwoosh كحدث PW_AbandonedCart مع معلومات مفصلة.

بالإضافة إلى ذلك، سيتم تعيين علامتين (tags) على ملف تعريف المستخدم:

• Abandoned Cart Date → PW_AbandonedCartDate
• Abandoned Cart ID → PW_AbandonedCartID

يمكن استخدام هذه العلامات لإرسال تذكيرات بسلات التسوق المتروكة. لإعداد حملة البريد الإلكتروني الكاملة مع كتلة المنتجات و Customer Journey، راجع كيفية إعداد حملة سلة التسوق المتروكة. يمكنك أيضًا استخدام المحتوى المتصل في قوالب البريد الإلكتروني.

التحقق من أن التكامل يعمل

للتأكد من أن التكامل يعمل بشكل صحيح:

1. قم بإنشاء عميل اختبار في Magento.
2. قم بمزامنة العميل يدويًا إلى Pushwoosh.
3. افتح User Explorer في لوحة تحكم Pushwoosh الخاصة بك وابحث عن العميل.

إذا ظهر العميل في User Explorer، فهذا يشير إلى أن المزامنة كانت ناجحة.