تكامل Shopify

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

يتكامل Pushwoosh بسلاسة مع Shopify، وهي منصة تجارة إلكترونية رائدة تمكّن الشركات من إنشاء وإدارة وتوسيع المتاجر عبر الإنترنت. يرشدك هذا الدليل خلال عملية تثبيت وتكوين تطبيق Pushwoosh في متجر Shopify الخاص بك، وإعداد تعريف المستخدم، واستخدام الإشعارات وأدوات الأتمتة لإشراك العملاء عبر قنوات مثل الإشعارات الفورية (push)، والبريد الإلكتروني، والرسائل القصيرة (SMS)، وWhatsApp.

نوع التكامل

• الوجهة: يرسل Shopify بيانات العملاء إلى Pushwoosh، حيث يتم استخدامها للاستهداف والمراسلة.

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

• حساب Pushwoosh
• الوصول إلى لوحة تحكم Shopify الخاصة بك
• رمز الوصول لواجهة برمجة تطبيقات الجهاز (Device API Access Token) ورمز التطبيق (Application Code) من Pushwoosh
• متجر Shopify مع توفر بيانات العملاء والطلبات

الكيانات المتزامنة

• العملاء: يُستخدم لتعيين وتحديد UserIDs في Pushwoosh عبر الحقول الوصفية (metafields) في Shopify

ملاحظة

أساليب مزامنة العملاء في Pushwoosh

نظرًا للقيود التقنية، يقدم Pushwoosh عدة طرق لمزامنة العملاء، اعتمادًا على قناة الاتصال المستخدمة للإشعارات:

• البريد الإلكتروني، الويب، الرسائل القصيرة وWhatsApp: يتم تسجيل الأجهزة/المستخدمين تلقائيًا في تطبيق Pushwoosh.
• تطبيقات الجوال وسطح المكتب: يمكن مزامنة الأجهزة/المستخدمين يدويًا عبر لوحات تحكم Pushwoosh وShopify.
• منصات الويب (Chrome, Firefox, Safari): تتم إدارة الأجهزة/المستخدمين بواسطة ملحق سمة Shopify نفسه.

كيف يعمل؟

تعمل عملية المزامنة على النحو التالي:

1. يحاول النظام استرداد جلسة المستخدم الحالية للحصول على بريد إلكتروني أو رقم هاتف (معرفات تعمل بدون تكوين إضافي).
2. إذا نجح ذلك، يتم تعيين البريد الإلكتروني أو رقم الهاتف كمعرف userID لكل من Pushwoosh وخاصية pushwoosh_userid في بيانات العميل.
3. إذا لم يكن هذا ممكنًا، يتم تعيين userID الافتراضي لـ Pushwoosh SDK كمعرف لكل من Pushwoosh وخاصية pushwoosh_userid.
4. في كلتا الحالتين، سيتم تعيين userID على كلا الجانبين، مما يضمن مزامنة متسقة.

• شرائح العملاء: تُستخدم للاستهداف والمراسلة القائمة على المجموعات
• الأحداث والمشغلات (على سبيل المثال، الطلبات المقدمة، العلامات المطبقة): تُستخدم في Shopify Flow لأتمتة المراسلة عبر القنوات
• واجهة المتجر: تُستخدم للحصول على موافقات إشعارات الويب الفورية (web push) من خلال البرامج النصية المضمنة

مسرد المصطلحات (ربط أسماء الكيانات إذا كانت مختلفة)

Shopify	Pushwoosh
Customer	UserID

كيف يعمل التكامل

يعمل Pushwoosh كوجهة مراسلة لـ Shopify. بمجرد التكامل، يرسل Shopify بيانات العملاء والسلوك إلى Pushwoosh، حيث تدعم الإشعارات في الوقت الفعلي، وتقسيم العملاء، والمراسلة الشخصية عبر القنوات.

المكونات الرئيسية للتكامل

1. تحديد العميل عبر الحقول الوصفية (metafields) يتم تعيين UserID فريد لكل عميل في Shopify، ويتم تخزينه في حقل وصفي (custom.pushwoosh_userid). يسمح هذا المعرف لـ Pushwoosh بالتعرف على المستخدمين ومراسلتهم باستمرار عبر المنصات.

2. الأتمتة القائمة على الأحداث عبر Shopify Flow يوفر Pushwoosh إجراءات Flow تسمح لك بأتمتة المراسلة (push, email, SMS, WhatsApp) بناءً على أحداث Shopify، مثل:

   • تقديم طلب جديد
   • تطبيق علامة على العميل
   • التخلي عن عربة التسوق

3. الاستهداف القائم على الشرائح يمكن استخدام شرائح العملاء من Shopify لإرسال إشعارات خاصة بمجموعات معينة عبر القنوات، مثل العروض الترويجية للمشترين لأول مرة أو حملات إعادة التنشيط للمستخدمين الخاملين.

4. المراسلة اليدوية وفي الوقت الفعلي من عرض العميل أو الشريحة في Shopify، يمكنك تشغيل الإشعارات يدويًا باستخدام ملحقات Pushwoosh:

   • Notification by Customer: للمتابعة الشخصية أو الاختبار
   • Notification by Segment: للرسائل القائمة على الحملات

إشعارات الويب بوش عبر تضمين واجهة المتجر

من خلال تمكين تضمين Pushwoosh في سمة Shopify الخاصة بك، يمكنك مطالبة زوار موقع الويب بالاشتراك في إشعارات الويب الفورية المستندة إلى المتصفح — لا حاجة لتطبيق جوال.

نظرة عامة على تدفق البيانات

Shopify Customer & Event Data
         ↓
Pushwoosh API (via App)
         ↓
UserID → Segmentation → Triggered or Manual Notifications

يمكّنك هذا التكامل من تقديم رسائل ذات صلة وفي الوقت المناسب تعمل على تحسين الاحتفاظ بالمستخدمين، وزيادة التحويلات، وتعزيز تجربة العملاء — تلقائيًا أو عند الطلب.

الجزء 1. التثبيت

تسجيل الدخول إلى Shopify

1. اذهب إلى Shopify Admin
2. اختر متجرك من لوحة التحكم

ملاحظة

يفترض هذا الدليل أن لديك حساب Pushwoosh بالفعل. إذا لم يكن كذلك، أنشئ واحدًا

تثبيت تطبيق Pushwoosh

1. قم بزيارة صفحة تطبيق Pushwoosh في متجر التطبيقات
2. انقر على Install
3. قم بتأكيد التثبيت في مربع حوار Shopify

ربط تطبيق Pushwoosh الخاص بك

بعد التثبيت، سيتم إعادة توجيهك إلى تطبيق Pushwoosh داخل Shopify.

1. انقر على Connect.

2. أدخل Application Code وDevice API Access Token، والذي يمكنك العثور عليه في Pushwoosh Control Panel → Settings → API Access.

عند الاتصال، ستظهر رسالة نجاح: “Pushwoosh app connected.”

الاشتراك في خطة

1. انقر على Upgrade Subscription
2. سيتم عرض خطة واحدة قائمة على الاستخدام.
3. قم بتأكيد الفوترة.

ملاحظة

الفوترة مطلوبة لاستخدام ميزات تسليم الرسائل والتقسيم.

الجزء 2. الإعداد: User ID للعميل عبر الحقول الوصفية (metafields)

لتقديم الإشعارات للمستخدمين المحددين عبر القنوات (push, email, SMS, WhatsApp)، يستخدم Pushwoosh User ID فريدًا لكل عميل. يخزن Shopify هذه القيمة داخل Customer metafields في Shopify.

1. اذهب إلى Settings → Metafields and metaobjects → Customers

2. انقر على Add definition واستخدم هذه القيم:

الحقل	القيمة
Namespace and key	custom.pushwoosh_userid
Namespace	custom
Type	Single line text
Validation	None
Customer Account Access	Read and Write
Storefront API Access	Enabled

لماذا هذا مهم

هذا الحقل الوصفي هو معرف مستخدم دائم عبر أجهزة الجوال/الويب للإشعارات والتقسيم.

الجزء 3. استخدام ملحقات Pushwoosh

يتضمن Pushwoosh ملحقات Shopify لاستهداف الشرائح، والأتمتة (Flow)، والإشعارات الخاصة بالعملاء.

الملحق 1. إرسال إشعار حسب العميل

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

إرسال رسائل شخصية يدويًا أو اختبار الإشعارات لمستخدم معين.

الخطوات

1. افتح Customers → Select a customer
2. انقر على More actions → Notification by customer
   
3. اختر منصة المراسلة (على سبيل المثال، Email) وإعداد محتوى مسبق (preset).
4. انقر على Send

نصيحة

استخدم هذا لتذكيرات ما بعد الشراء، أو رسائل الشكر الشخصية، أو رسائل إعادة التنشيط.

الملحق 2. إشعار حسب الشريحة

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

استهداف مجموعات من العملاء — عربات التسوق المتروكة، المشترون لأول مرة، المنفقون بكثرة.

الخطوات

1. اذهب إلى Customers → Segments

2. اختر شريحة → انقر على Use Segment

3. اختر Notification by Segment
4. اختر قناة الاتصال المطلوبة وإعداد الرسالة المسبق. انقر على Send.

نصيحة

يمكن إنشاء الشرائح بناءً على سجل الشراء، أو الموقع، أو النشاط، أو العلامات.

الملحق 3. Pushwoosh في Shopify Flow

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

أتمتة المراسلة في رحلات العملاء باستخدام مشغلات مثل الطلبات، أو العلامات، أو السلوك.

الخطوات

1. أنشئ Flow جديدًا في Shopify Flow
2. أضف إجراء → اختر Pushwoosh notifications

3. قم بتكوين الرسالة والحقول الديناميكية

على سبيل المثال:

• إرسال رسالة بعد تقديم الطلب

• تذكير المستخدم عند التخلي عن عربة التسوق

• إرسال إشعار إعادة تنشيط بعد 30 يومًا من عدم النشاط

الجزء 4. تمكين إشعارات الويب بوش (اختياري ولكن موصى به)

لدعم إشعارات الويب بوش المستندة إلى المتصفح على واجهة متجرك، قم بما يلي:

1. اذهب إلى Online Store → Themes → Customize
   
2. افتح App Embeds من القائمة اليسرى
3. قم بتبديل Push Init Embed إلى وضع التشغيل (ON)

ملاحظة

الآن يمكن لمتجرك أن يطالب المستخدمين بالاشتراك في إشعارات الويب بوش مباشرة من واجهة المتجر.

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

السيناريو	الأداة المستخدمة
متابعة شخصية	Notification by Customer
تذكير بالتخلي عن عربة التسوق	Shopify Flow + Pushwoosh action
عرض ترويجي قائم على الشريحة	Notification by Segment
رسالة ترحيب بعد التسجيل	Flow + Metafield tracking
الاشتراك في الإشعارات الفورية (Push)	Theme Embed + Push Init Toggle