تكامل Shopify

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

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

نوع التكامل

• الوجهة: يرسل 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 لأتمتة رسائل الدفع
• واجهة المتجر: تُستخدم للحصول على موافقات إشعارات الدفع على الويب من خلال البرامج النصية المضمنة

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

Shopify	Pushwoosh
العميل	UserID

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

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

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

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

2. الأتمتة القائمة على الأحداث عبر Shopify Flow يوفر Pushwoosh إجراءات Flow تتيح لك أتمتة إشعارات الدفع بناءً على أحداث Shopify، مثل:

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

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

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

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

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

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

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

بيانات العملاء والأحداث في Shopify
         ↓
واجهة برمجة تطبيقات Pushwoosh (عبر التطبيق)
         ↓
UserID ← تقسيم ← إشعارات تلقائية أو يدوية

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

الجزء الأول: التثبيت

تسجيل الدخول إلى 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 ← الإعدادات ← الوصول إلى واجهة برمجة التطبيقات.

عند الاتصال، ستظهر رسالة نجاح: “تم ربط تطبيق Pushwoosh.”

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

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

ملاحظة

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

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

لتقديم إشعارات الدفع على الهاتف المحمول للمستخدمين المعرفين، يستخدم Pushwoosh User ID فريدًا لكل عميل. يخزن Shopify هذه القيمة داخل الحقول الوصفية للعملاء في Shopify.

1. اذهب إلى الإعدادات ← الحقول الوصفية والكائنات الوصفية ← العملاء

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

لماذا هذا مهم

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

الجزء الثالث: استخدام امتدادات Pushwoosh

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

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

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

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

الخطوات

1. افتح العملاء ← حدد عميلاً
2. انقر على إجراءات إضافية ← إشعار حسب العميل
3. حدد منصة المراسلة (على سبيل المثال، Email) وإعداد مسبق للمحتوى.
4. انقر على Send

نصيحة

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

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

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

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

الخطوات

1. اذهب إلى العملاء ← الشرائح

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

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

نصيحة

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

الامتداد 3. Pushwoosh في Shopify Flow

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

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

الخطوات

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

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

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

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

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

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

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

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

1. اذهب إلى المتجر الإلكتروني ← السمات ← تخصيص
2. افتح App Embeds من القائمة اليسرى
3. شغّل Push Init Embed

ملاحظة

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

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

السيناريو	الأداة المستخدمة
متابعة شخصية	إشعار حسب العميل
تذكير بسلة التسوق المتروكة	Shopify Flow + إجراء Pushwoosh
عرض ترويجي قائم على الشريحة	إشعار حسب الشريحة
رسالة ترحيب بعد التسجيل	Flow + تتبع الحقول الوصفية
الموافقة على تلقي إشعارات الدفع	تضمين السمة + مفتاح تهيئة الدفع