تكامل Shopify

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

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

نوع التكامل

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

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

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

متصل بالفعل؟ سيُطلب منك إعادة الموافقة على الوصول

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

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

• العملاء: يُستخدم لتعيين وتحديد 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 على كلا الجانبين، مما يضمن مزامنة متسقة.

• شرائح العملاء: تُستخدم للاستهداف والمراسلة القائمة على المجموعات
• الأحداث والمشغلات (على سبيل المثال، الطلبات المقدمة، العلامات المطبقة): تُستخدم في Shopify Flow لأتمتة المراسلة عبر القنوات
• واجهة المتجر: تُستخدم لالتقاط موافقات إشعارات الويب الفورية من خلال البرامج النصية المضمنة
• موجز المنتجات: يتصل موجز واجهة متجرك (products.json) تلقائيًا بـ كتالوج منتجات Pushwoosh عند توصيل التطبيق، وينفصل تلقائيًا إذا قمت بإلغاء تثبيته.
• الطلبات وعربات التسوق: أحداث من خادم إلى خادم من خطافات الويب orders/paid و checkouts/create في Shopify. انظر تتبع الطلبات وعربات التسوق وخطوات الدفع.
• سلوك تصفح واجهة المتجر: مشاهدات المنتجات وإجراءات الإضافة إلى عربة التسوق، يتم جمعها بواسطة نفس تضمين السمة المستخدم لموافقات إشعارات الويب الفورية.
• خطوات الدفع: معلومات الاتصال التي تم إدخالها ومعلومات الدفع التي تم إرسالها، يتم جمعها عبر Shopify Web Pixel.

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

Shopify	Pushwoosh
العميل	UserID
خطاف الويب orders/paid	الحدث PW_OrderCreated — مشترك مع تكاملات التجارة الإلكترونية الأخرى (مثل Magento)
خطاف الويب checkouts/create	الحدث PW_AbandonedCart — نفس الحدث المشترك، يُستخدم أيضًا بواسطة مصدر عربة التسوق في كتلة المنتجات
مشاهدة صفحة المنتج	الحدث PW_ProductViewed

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

اتصال كتالوج المنتجات التلقائي

يؤدي توصيل التطبيق أيضًا إلى توصيل موجز واجهة متجرك بـ كتالوج منتجات Pushwoosh تلقائيًا — لا حاجة لإعداد موجز منفصل. يتم التقاط عملة متجرك في نفس الوقت، ويتم تحديثها تلقائيًا إذا قمت بتغيير عملة متجرك بعد ذلك.

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

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

ملاحظة

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

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

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

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

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

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

لماذا هذا مهم

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

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

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

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

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

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

الخطوات

1. افتح Customers ← Select a customer
2. انقر على More actions ← Notification by customer
3. حدد منصة المراسلة (على سبيل المثال، Email) وإعداد محتوى مسبق.
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

ملاحظة

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

الجزء 5. تتبع الطلبات، عربات التسوق، وخطوات الدفع

بمجرد الموافقة على نطاقات read_orders و write_pixels و read_customer_events (انظر المتطلبات الأساسية)، يبدأ Pushwoosh في تلقي ثلاثة أنواع من أحداث التجارة من متجرك. تأتي من أماكن مختلفة وتتوقف بشكل مستقل عن بعضها البعض — لا تعاملها كموجز واحد.

أحداث الطلبات وعربات التسوق من جانب الخادم

يرسل Shopify أحداث الطلب المدفوع (خطاف الويب orders/paid، الحدث PW_OrderCreated) وإنشاء عملية الدفع (خطاف الويب checkouts/create، الحدث PW_AbandonedCart) إلى Pushwoosh مباشرة، من خادم إلى خادم. كلاهما مشترك مع تكاملات التجارة الإلكترونية الأخرى — يستخدم Magento نفس اسمي الحدثين. مثل أحداث خطافات الويب الواردة الأخرى (يعمل Stripe بنفس الطريقة)، تظهر في القائمة المنسدلة Event عند إنشاء شريحة أو إعداد مشغل Customer Journey، ويمكنك تعيين أي منهما كمصدر لـ أحداث التحويل لجلب إيرادات Shopify إلى تقسيم RFM، وإسناد الرحلة، وإحصائيات كتل المنتجات التي ترسلها في رسائل البريد الإلكتروني.

نظرًا لأن هذه الأحداث تأتي من خادم Shopify، وليس من متصفح المتسوق، فإنها تستمر في الوصول حتى للمتسوقين الذين يحظرون أدوات التتبع أو يستخدمون مانع الإعلانات.

التخلي عن عربة التسوق يعني ثلاثة أشياء مختلفة هنا

• مشغل التخلي عن عربة التسوق في Shopify Flow (انظر الأتمتة القائمة على الأحداث عبر Shopify Flow) هو شرط أصلي في Shopify، ولا علاقة له بأحداث Pushwoosh.
• خطاف الويب checkouts/create أعلاه يعني فقط أن عملية الدفع قد بدأت — لم يقرر Shopify أنها “مهجورة”، ولم يتم تأكيد أي طلب أيضًا.
• يقرأ مصدر عربة التسوق في كتلة المنتجات عربة المستلم عبر علامة PW_AbandonedCartID، بشكل مستقل عن هذه الأحداث.

اختر الخيار الذي يطابق ما تقوم ببنائه بالفعل، وليس الاسم الذي يبدو الأقرب.

أحداث تصفح واجهة المتجر

يتم جمع مشاهدات المنتجات (الحدث PW_ProductViewed) وإجراءات الإضافة إلى عربة التسوق بواسطة نفس تضمين السمة الذي قمت بتثبيته بالفعل لـ موافقات إشعارات الويب الفورية — لا يوجد شيء جديد لإضافته إلى سمتك، ولكن يجب تبديل التضمين إلى وضع التشغيل ON (انظر تمكين إشعارات الويب) حتى تصل هذه الأحداث. إذا تخطيت هذا التبديل، فلن تحصل على موافقات إشعارات الويب الفورية ولا أحداث واجهة المتجر.

أحداث واجهة المتجر تتطلب تمكين تضمين السمة

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

PW_ProductViewed ليس لديه إزالة للتكرار

يتم إطلاق PW_ProductViewed عند كل تحميل لصفحة المنتج — بما في ذلك الزيارات المتكررة في نفس الجلسة، وإعادة تحميل الصفحة، وحركة مرور الروبوتات أو برامج الزحف. لا توجد إزالة للتكرار أو تقييد. نظرًا لأن استراتيجيات مثل بناءً على ما شاهدوه تعتمد على هذا الحدث، فإن حركة المرور المزعجة تغذي تلك التوصيات أيضًا.

أحداث خطوات الدفع

يبلغ Web Pixel في Shopify عن مرحلتين رئيسيتين في عملية الدفع أثناء قيام المتسوق بملء نموذج الدفع:

• PW_CheckoutContactInfo: أدخل المتسوق معلومات الاتصال الخاصة به.
• PW_PaymentInfoSubmitted: أرسل المتسوق تفاصيل الدفع الخاصة به.

الشراء المكتمل ليس جزءًا من هذا البيكسل

لا يتتبع Web Pixel عن قصد الشراء المكتمل — هذا هو حدث الطلب المدفوع من جانب الخادم المذكور أعلاه. استخدم أحداث Web Pixel لمعرفة أين يتوقف المتسوقون أثناء عملية الدفع، وحدث الطلب لمعرفة أن عملية بيع قد حدثت بالفعل.

الجزء 6. الامتثال للبيانات

يتطلب Shopify من كل تطبيق عام الاستجابة لخطافات الويب الإلزامية الخاصة بـ GDPR/CCPA. يتعامل Pushwoosh معها على النحو التالي:

• customers/redact: عندما يطلب متسوق من المتجر محو بياناته، يقوم Pushwoosh بمحو سجلات Pushwoosh المطابقة حسب المعرفات التي يرسلها Shopify — البريد الإلكتروني، الهاتف، ومعرف عميل Shopify.
• customers/data_request: عندما يطلب متسوق نسخة من بياناته، ينشر Pushwoosh إشعارًا إلى القناة الداخلية للدعم، ويتعامل شخص مع الطلب يدويًا. يتطلب Shopify من التطبيقات الاستجابة لهذه الطلبات في غضون 30 يومًا.
• shop/redact: يرسل Shopify هذا بعد 48 ساعة من إلغاء تثبيت المتجر للتطبيق، طالبًا محو بيانات المتجر. ليس لدى Pushwoosh معالج منفصل له عن قصد — يؤدي إلغاء التثبيت بالفعل إلى حذف سجل التكامل الكامل للمتجر (بما في ذلك مفتاح واجهة برمجة تطبيقات الجهاز، ورمز التطبيق، ومعرفات الفوترة)، لذلك لا يتبقى شيء لهذا الخطاف ليمحوه بحلول وقت وصوله.

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

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