تكامل Shopify

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

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

نوع التكامل

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

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

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

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

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

ملاحظة

أساليب مزامنة العملاء في 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 على كلا الجانبين، مما يضمن مزامنة متسقة.

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

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

Shopify	Pushwoosh
العميل (Customer)	UserID

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

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

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

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

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

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

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

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

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

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

من خلال تمكين تضمين 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، والذي يمكنك العثور عليه في لوحة تحكم Pushwoosh ← الإعدادات ← الوصول إلى API.

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

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

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

ملاحظة

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

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

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

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

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

الحقل	القيمة
مساحة الاسم والمفتاح	custom.pushwoosh_userid
مساحة الاسم	custom
النوع	نص من سطر واحد
التحقق من الصحة	لا يوجد
الوصول إلى حساب العميل	قراءة وكتابة
الوصول إلى واجهة برمجة تطبيقات واجهة المتجر	ممكّن

لماذا هذا مهم

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

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

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

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

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

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

الخطوات

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

نصيحة

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

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

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

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

الخطوات

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

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

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

نصيحة

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

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

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

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

الخطوات

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

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

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

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

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

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

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

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

1. اذهب إلى المتجر عبر الإنترنت ← الثيمات ← تخصيص
2. افتح App Embeds من القائمة اليسرى
3. قم بتبديل Push Init Embed إلى وضع التشغيل (ON)

ملاحظة

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

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

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