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

تكامل WooCommerce

اربط متجر WooCommerce باستخدام إضافة WordPress الخفيفة (v1.2.0) الخاصة بنا. زامن المنتجات والطلبات والعملاء، وفعّل تتبع السلات المتروكة.

الميزات​

  • إضافة WordPress ‏(v1.2.0): تثبيت سهل عبر رفع الإضافة
  • مزامنة لحظية: تتزامن المنتجات والطلبات والعملاء والسلات لحظيًا عبر الإضافة
  • تتبع واسترداد السلات المتروكة: تتبع السلات المتروكة واستردها بروابط الاستعادة وسجل السلات المستردة
  • تتبع واجهة المتجر: تتبع مشاهدات الصفحات والمنتجات والإضافة إلى السلة وأحداث بدء إتمام الشراء
  • التقاط Email: تعرّف تلقائيًا على العملاء من إتمام الشراء والنماذج
  • عناوين URL لاسترداد السلات: أنشئ روابط استعادة لإرجاع السلات المتروكة
  • دعم متاجر متعددة: اربط عدة متاجر WooCommerce مع تقسيم لكل متجر
  • لا يُحجب إتمام الشراء أبدًا: تُرسل أحداث الطلب في الخلفية، لذلك لا يمكن لـ Joryio إبطاء إتمام شراء المتسوق أو تعطيله

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

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

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

الخطوة 2: ثبّت الإضافة​

  1. نزّل إضافة Joryio لـ WordPress من الإعدادات → التكاملات في لوحة Joryio (زر تنزيل الإضافة).
  2. في إدارة WordPress، انتقل إلى Plugins → Add New → Upload Plugin.
  3. ارفع ملف ZIP للإضافة وانقر Install Now.
  4. انقر Activate.

الخطوة 3: اضبط الإضافة​

  1. في إدارة WordPress، انتقل إلى Settings → Joryio.
  2. الصق مفتاح API من الخطوة 1.
  3. انقر Connect.

الخطوة 4: أدخل بيانات اعتماد WooCommerce API​

تحتاج الإضافة إلى وصول WooCommerce REST API:

  1. انتقل إلى WooCommerce → Settings → Advanced → REST API.
  2. انقر Add Key.
  3. اضبط الوصف: «Joryio».
  4. اضبط المستخدم: مستخدم المسؤول لديك.
  5. اضبط الأذونات: Read/Write.
  6. انقر Generate API Key.
  7. انسخ Consumer Key وConsumer Secret.
  8. الصقهما في إعدادات إضافة Joryio.

إعدادات المزامنة​

اضبط خيارات المزامنة في الإعدادات → التكاملات → WooCommerce → علامة الإعدادات:

الإعدادالوصفالافتراضي
مزامنة المنتجاتاستيراد المنتجات من WooCommerceمفعّل
مزامنة الطلباتاستيراد الطلبات وتحديث الحالاتمفعّل
مزامنة العملاءاستيراد بيانات العملاءمفعّل
مزامنة السلاتتتبع السلات المتروكةمفعّل
الأيام التاريخيةأيام سجل الطلبات المراد استيرادها90

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

تُدخل الإضافة نص تتبع في كل صفحات واجهة المتجر:

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

التقاط Email​

تُلتقط عناوين Email تلقائيًا من:

  • حقل Email للفوترة عند إتمام الشراء
  • نماذج الاشتراك في النشرة
  • أي حقل إدخال Email

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

تتبع الإضافة سلات التسوق لحظيًا:

  1. تُتبع عناصر وقيمة السلة أثناء تسوق العملاء.
  2. بعد 30 دقيقة من عدم النشاط، تُعلم السلة على أنها متروكة.
  3. يُنشأ عنوان URL للاسترداد لإعادة السلة.
  4. استخدم Canvas لإرسال رسائل Email استردادية تحتوي رابط الاستعادة.

عناوين URL لاسترداد السلات​

عندما ينقر العميل رابط الاسترداد:

  1. تُستعاد جلسة السلة.
  2. تُضاف كل عناصر السلة من جديد.
  3. يُعاد توجيهه إلى إتمام الشراء.

دعم متاجر متعددة​

عند ربط عدة متاجر WooCommerce:

  1. يحصل كل متجر على كيان تطبيق خاص به ومفتاح SDK فريد.
  2. تُعلم كل الأحداث بـ $app_id للمتجر.
  3. صفِّ الأحداث حسب $platform = 'woocommerce' أو $app_id محدد.
  4. يمكن ربط المستخدمين بين المتاجر عبر Email.

Webhooks​

ترسل الإضافة الأحداث مباشرة إلى Joryio (أسرع من Webhooks). إضافة إلى ذلك، تُسجل Webhooks ‏REST API كنسخة احتياطية:

  • إنشاء الطلب وتحديثه وحذفه
  • إنشاء المنتج وتحديثه وحذفه
  • إنشاء العميل وتحديثه

مزامنة البيانات​

المزامنة اليدوية​

شغّل مزامنة يدوية من الإعدادات → التكاملات → WooCommerce → علامة حالة المزامنة:

  • مزامنة الكل: مزامنة كاملة للمنتجات والطلبات والعملاء
  • مزامنة المنتجات: مزامنة المنتجات فقط
  • مزامنة الطلبات: مزامنة الطلبات فقط
  • مزامنة العملاء: مزامنة العملاء فقط

المزامنة التلقائية​

ترسل الإضافة أحداثًا لحظية لـ:

  • الطلبات الجديدة
  • تغييرات حالة الطلب
  • تحديثات المنتجات
  • تحديثات العملاء
  • تغييرات السلة
  • السلات المستردة
لا توجد إعادة مزامنة مجدولة

تظل بياناتك محدثة عبر أحداث الإضافة اللحظية والاستيراد التاريخي لمرة واحدة وزر المزامنة الآن اليدوي. لا توجد إعادة مزامنة تلقائية دورية. إذا لاحظت في أي وقت انحرافًا في البيانات، مثلًا بعد توقف الخدمة، شغّل مزامنة يدوية لإعادة الملء من علامة حالة المزامنة.

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

الإضافة لا تتصل​

  • تحقق من صحة مفتاح API (يبدأ بـ jry_wc_).
  • تحقق من أن WordPress يملك وصول HTTPS صادرًا.
  • تأكد من إمكانية الوصول إلى نقطة نهاية API.

أخطاء WooCommerce API​

  • تحقق من صحة Consumer Key وSecret.
  • تحقق من أن مستخدم API يملك أذونات Read/Write.
  • تأكد من أن موقعك يستخدم SSL ‏(HTTPS).

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

  • تحقق من تفعيل الإضافة.
  • تحقق من تحميل نص التتبع في أدوات مطور المتصفح.
  • امسح أي إضافات تخزين مؤقت.

المنتجات/الطلبات لا تتزامن​

  • تحقق من تفعيل المزامنة في علامة الإعدادات.
  • جرّب مزامنة يدوية بزر «مزامنة الكل».
  • تحقق من تفعيل WooCommerce REST API.