تكامل Magento

مساعدة المطور مطلوبة

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

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

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

نوع التكامل

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

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

قبل المتابعة، تأكد مما يلي:

• الوصول إلى لوحة إدارة Magento

• حساب Pushwoosh صالح

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

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

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

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

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

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

Magento	Pushwoosh
العميل	المستخدم

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

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

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

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

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

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

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

التثبيت

ملاحظة

لتثبيت تكامل 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.

2. انتقل إلى Stores > Configuration > Pushwoosh > Configuration.

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

في قسم 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، انتقل إلى Customers > All Customers.
2. حدد موقع العميل (العملاء) الذي ترغب في مزامنته وحدده.
3. من القائمة المنسدلة Actions فوق قائمة العملاء، اختر Sync to Pushwoosh.

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

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

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

1. في لوحة إدارة Magento، انتقل إلى Sales > Orders.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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