تخطّ إلى المحتوى الرئيسي

تكامل Magento

اربط متجر Magento 2 باستخدام امتداد Joryio Connect. زامن المنتجات والطلبات والعملاء والسلات، وتتبع سلوك واجهة المتجر، واسترد السلات المتروكة.

الميزات​

  • امتداد مثبت عبر Composer - وحدة Magento 2 أصلية، من دون الحاجة إلى OAuth
  • مزامنة تلقائية - تتدفق المنتجات والطلبات والعملاء والسلات إلى Joryio كل دقيقة
  • استيراد تاريخي - تُستورد المنتجات والعملاء والطلبات الحالية (آخر 90 يومًا افتراضيًا) عند الربط
  • استرداد السلات المتروكة - اكتشف السلات المتروكة وأرسل روابط استرداد تعيد السلة
  • تتبع واجهة المتجر - مشاهدات الصفحات والمنتجات والإضافة إلى السلة وأحداث إتمام الشراء
  • التقاط الهوية - تعرّف تلقائي على العملاء من تسجيل الدخول والاشتراك في النشرة وإتمام الشراء
  • إسناد الإيرادات - تُنسب الطلبات إلى الحملة أو الرحلة التي أدت إليها
  • مشغلات الكتالوج - تدعم تحديثات المخزون والسعر مشغلات العودة إلى المخزون وانخفاض السعر

المتطلبات المسبقة​

  • Magento Open Source أو Adobe Commerce بالإصدار 2.4.x
  • وصول إلى سطر الأوامر لخادم Magento مع Composer
  • إعداد وتشغيل Magento cron؛ إذ يسلّم الامتداد الأحداث عبر cron، وهذا مطلوب
  • وصول HTTPS صادر من خادم Magento إلى Joryio

خطوات الإعداد​

الخطوة 1: احصل على عنوان URL للخادم ومفتاح API​

  1. في Joryio، انتقل إلى الإعدادات → التكاملات → Magento.
  2. انسخ عنوان URL للخادم.
  3. انقر إنشاء مفتاح API وانسخ المفتاح (يبدأ بـ jry_mg_).

الخطوة 2: ثبّت الامتداد​

نزّل ملف zip للامتداد (joryio-connect-magento2.zip) بواسطة زر تنزيل الامتداد في صفحة تكامل Magento في لوحة التحكم، ثم فك ضغطه وشغّل هذه الأوامر من جذر Magento:

composer config repositories.joryio path /path/to/joryio-connect
composer require joryio/module-connect
bin/magento module:enable Joryio_Connect
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

بدلًا من ذلك (من دون Composer): فك ضغط الملف إلى app/code/Joryio/Connect وشغّل أوامر bin/magento نفسها.

الخطوة 3: الربط​

  1. في لوحة إدارة Magento، انتقل إلى Stores → Configuration → Joryio.
  2. الصق عنوان URL للخادم ومفتاح API من الخطوة 1.
  3. انقر Connect.

ينشئ الامتداد تلقائيًا رمز وصول لتكامل Magento ويشاركه بأمان مع Joryio؛ لا تحتاج إلى إنشاء أي رموز يدويًا. تتحقق Joryio من الاتصال وتبدأ فورًا مزامنة تاريخية كاملة (المنتجات ثم العملاء ثم الطلبات؛ آخر 90 يومًا افتراضيًا).

عند انتهاء العملية، تعرض صفحة إدارة Magento ولوحة تحكم Joryio الحالة Connected.

ما الذي يُزامن​

البياناتالكيفيةالوقت
المنتجاتاستيراد تاريخي + تحديثات لحظية (بما فيها تغيرات المخزون والسعر)عند الربط، ثم باستمرار
العملاءاستيراد تاريخي + تحديثات لحظيةعند الربط، ثم باستمرار
الطلباتاستيراد تاريخي (آخر 90 يومًا افتراضيًا) + تحديثات لحظيةعند الربط، ثم باستمرار
السلاتتتبع لحظي + كشف التخليباستمرار
الهويةتسجيل الدخول والاشتراك في النشرة وEmail إتمام الشراءباستمرار

تُدرج التحديثات اللحظية محليًا في طابور متجرك ويسلمها إلى Joryio cron يعمل مرة كل دقيقة؛ لذلك يعد cron السليم في Magento ضروريًا. تغذي تحديثات المخزون والسعر أيضًا مشغلات الكتالوج (العودة إلى المخزون وانخفاض السعر).

تتبع واجهة المتجر​

يضيف الامتداد مقتطف تتبع خفيفًا إلى واجهة متجرك (مفعل افتراضيًا؛ يمكنك إيقافه من Stores → Configuration → Joryio). يتتبع:

الحدثالوصف
Page Viewكل زيارة صفحة
Product Viewedعند مشاهدة صفحة منتج
Add to Cartالعناصر المضافة إلى السلة
Checkout Startedعند بدء إتمام الشراء
Identifyالتقاط Email

يلتقط المقتطف أيضًا معاملات UTM ومعرّفات نقرات Joryio من روابط حملاتك، حتى تُنسب الطلبات إلى الحملة أو الرحلة التي أدت إلى البيع. راجع إسناد الإيرادات.

استرداد السلات المتروكة​

  1. يتتبع الامتداد السلات أثناء تسوق العملاء.
  2. بعد 60 دقيقة من عدم النشاط (قابلة للضبط)، تُعلم السلة على أنها متروكة.
  3. تتلقى Joryio السلة مع عنوان URL للاسترداد.
  4. استخدم رحلة لإرسال رسائل استرداد تتضمن رابط الاستعادة.

عندما ينقر العميل رابط الاسترداد (https://your-store.com/joryio/cart/restore?token=...)، تُستعاد سلته بكل العناصر ويمكنه إتمام الشراء فورًا.

استكشاف الأخطاء وإصلاحها​

أحداث عالقة / لا يصل شيء إلى Joryio​

السبب في أغلب الحالات هو عدم تشغيل Magento cron. يضع الامتداد الأحداث محليًا في طابور ويسلمها cron كل دقيقة؛ ومن دون cron لا يُرسل شيء.

  • تحقق من إعداد cron: bin/magento cron:install (أو افحص crontab).
  • شغله يدويًا للاختبار: bin/magento cron:run.
  • افحص var/log/joryio.log في جذر Magento بحثًا عن أخطاء التسليم.

«مفتاح API غير صالح» / عدم تطابق المفتاح​

  • يجب أن يبدأ المفتاح بـ jry_mg_ وأن يطابق المفتاح الظاهر حاليًا في الإعدادات → التكاملات → Magento في Joryio.
  • يؤدي إنشاء مفتاح جديد إلى إبطال المفتاح القديم؛ أعد لصق أحدث مفتاح في لوحة إدارة Magento وانقر Connect مجددًا.
  • تحقق مرة أخرى من نسخ عنوان URL للخادم حرفيًا.

بيانات تاريخية مفقودة​

  • لا تُستورد الطلبات الأقدم من نافذة المزامنة (90 يومًا افتراضيًا).
  • تعمل المزامنة التاريخية بالترتيب: المنتجات ثم العملاء ثم الطلبات؛ امنح المتجر الكبير وقتًا لإتمامها.

التتبع لا يعمل​

  • تحقق من تفعيل مفتاح مقتطف التتبع في Stores → Configuration → Joryio.
  • شغل bin/magento cache:flush بعد تغيير المفتاح (قد تقدم ذاكرة التخزين المؤقت للصفحة الكاملة صفحات قديمة).
  • تحقق من تحميل المقتطف في أدوات مطور المتصفح.