تكامل Shopify

اربط متجر Shopify لمزامنة المنتجات والطلبات والعملاء والسلات المتروكة تلقائيًا. فعّل تقسيم العملاء القوي وحملات استرداد السلات المتروكة.

الميزات

• مزامنة تلقائية - تتزامن المنتجات والطلبات والعملاء لحظيًا عبر Webhooks
• استرداد السلات المتروكة - التقط عناوين URL لإتمام الشراء لحملات Email الاستردادية
• تتبع واجهة المتجر - تتبع مشاهدات الصفحات ومشاهدات المنتجات وأحداث الإضافة إلى السلة
• التقاط Email - تعرّف تلقائيًا على العملاء من إتمام الشراء والنماذج
• إسناد UTM - التقط معاملات UTM التسويقية وانسبها
• دعم متاجر متعددة - اربط عدة متاجر Shopify مع تقسيم الأحداث لكل متجر

ربط متجرك

1. انتقل إلى الإعدادات → التكاملات.
2. في قسم Shopify، انقر ربط Shopify.
3. أدخل نطاق متجرك (مثل my-store لـ my-store.myshopify.com).
4. انقر الاتصال بـ Shopify.
5. فوّض التطبيق في Shopify.
6. ستعود بعد ذلك ومتجرك متصل.

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

بعد الربط، اضبط البيانات التي تريد مزامنتها:

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

يمكنك الوصول إليها في الإعدادات → التكاملات → Shopify → علامة الإعدادات.

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

يُثبت نص التتبع تلقائيًا في واجهة متجر Shopify ويلتقط أحداث واجهة المتجر فورًا (من دون إعداد إضافي):

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

التقاط Email

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

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

إسناد UTM

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

• utm_source, utm_medium, utm_campaign
• utm_term, utm_content

تخزن معاملات UTM في الجلسة وتُلحق بكل الأحداث.

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

عند ربط عدة متاجر Shopify بمساحة العمل نفسها:

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

Webhooks

يسجل التكامل تلقائيًا Webhooks للتحديثات اللحظية:

• إنشاء الطلب وتحديثه وإلغاؤه وتنفيذه
• إنشاء إتمام الشراء وتحديثه (السلات المتروكة)
• إنشاء المنتج وتحديثه وحذفه
• إنشاء العميل وتحديثه

اعرض Webhooks المسجلة في الإعدادات → التكاملات → Shopify → علامة Webhooks.

لا توجد إعادة مزامنة مجدولة

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

صحة الاتصال

بعد ربط Shopify، تكون لوحة الصحة (في الإعدادات → التكاملات → Shopify) أول ما تفحصه إذا توقفت بيانات المتجر عن المزامنة:

• تفاصيل المتجر - الاسم الحي والخطة والعملة والنطاق المسحوبة من Shopify. ظهورها يؤكد استمرار عمل رمز الوصول.
• حالة Webhook - يظهر كل موضوع مطلوب بوصفه مسجلاً أو مفقودًا. يعيد زر إعادة التسجيل إنشاء أي Webhooks مفقودة لاستئناف التحديثات اللحظية.

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

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

عندما يترك العميل سلته:

1. يُلتقط عنوان URL لإتمام الشراء.
2. تُخزن قيمة السلة وعناصرها.
3. يُربط Email العميل، إذا التُقط.

استخدم هذه البيانات لإنشاء حملات استرداد السلات المتروكة في Canvas مع عنوان URL الفعلي لإتمام الشراء.

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

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

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

لا يتم التقاط Email

• يلتقط نص التتبع عناوين Email من مدخلات النماذج القياسية.
• يُلتقط Email إتمام الشراء عندما يدخله العميل.

مشكلات الاتصال

• تحقق من أن تطبيق Shopify لديه الأذونات المطلوبة.
• جرّب قطع الاتصال ثم إعادة الربط.