تكامل Shopify

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

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

نوع التكامل

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

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

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

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

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

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

• العملاء: يُستخدم لتعيين وتحديد User IDs في 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 عند توصيل التطبيق، وينفصل تلقائيًا إذا قمت بإلغاء تثبيته.
• الطلبات وعربات التسوق: أحداث من الخادم إلى الخادم من webhooks الخاصة بـ Shopify orders/paid، checkouts/create، وcheckouts/update. انظر تتبع الطلبات وعربات التسوق وخطوات الدفع.
• سلوك تصفح واجهة المتجر: مشاهدات المنتجات وإجراءات الإضافة إلى عربة التسوق، يتم جمعها بواسطة نفس تضمين السمة المستخدم لموافقات الإشعارات الفورية على الويب.
• خطوات الدفع: معلومات الاتصال المدخلة ومعلومات الدفع المقدمة، يتم جمعها عبر Shopify Web Pixel.

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

Shopify	Pushwoosh
Customer	User ID
orders/paid webhook	الحدث PW_OrderCreated — مشترك مع تكاملات التجارة الإلكترونية الأخرى (مثل Magento)
checkouts/create webhook	الحدث PW_AbandonedCart — نفس الحدث المشترك، يُستخدم أيضًا بواسطة مصدر عربة التسوق في كتلة المنتجات
checkouts/update webhook	الحدث PW_AbandonedCartUpdate — يتم إطلاقه عندما يستمر المتسوق في تعديل نفس عملية الدفع، مما يؤدي إلى الكتابة فوق عربة التسوق المخزنة من PW_AbandonedCart
Product page view	الحدث PW_ProductViewed
Add to cart (no page reload)	الحدث PW_AddToCart
Web Pixel checkout_contact_info_submitted	الحدث PW_CheckoutContactInfo
Web Pixel payment_info_submitted	الحدث PW_PaymentInfoSubmitted

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

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

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

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

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

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

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

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

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

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

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

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

بيانات العملاء والأحداث في Shopify
         ↓
Pushwoosh API (عبر التطبيق)
         ↓
User ID → التقسيم → إشعارات مشغلة أو يدوية

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

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

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

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

ملاحظة

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

تثبيت تطبيق Pushwoosh

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

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

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

1. انقر على Connect.

   

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

   

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

عندما يطلب Shopify أذونات (الطلبات، البكسلات، أحداث العملاء)، وافق عليها. هذه النطاقات مطلوبة لتتبع الجزء 5. إذا قمت بتوصيل التطبيق في وقت سابق، انظر هل قمت بالاتصال بالفعل؟ سيُطلب منك إعادة الموافقة على الوصول.

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

توصيل التطبيق يربط أيضًا موجز واجهة متجرك بـ كتالوج المنتجات في 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 واستخدم هذه القيم:

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

قم بتعيين Customer accounts access وStorefront API access كما في الجدول أعلاه.

لماذا هذا مهم

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

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

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

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

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

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

الخطوات

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

   

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

   

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

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

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

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

الجزء 4. تمكين الإشعارات الفورية على الويب (وأحداث تصفح واجهة المتجر)

اختياري للإشعارات الفورية على الويب وحدها. مطلوب إذا كنت بحاجة إلى أحداث عرض المنتج والإضافة إلى عربة التسوق في الجزء 5.

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

1. اذهب إلى Online Store → Themes → Customize

2. افتح App Embeds من القائمة اليسرى

3. قم بتبديل Push Init Embed إلى ON

   

ملاحظة

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

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

بعد توصيل التطبيق والموافقة على الأذونات المطلوبة من Shopify لتتبع الطلبات وعربات التسوق والدفع (read_orders، write_pixels، read_customer_events)، تبدأ أحداث الطلبات والدفع وخطوات الدفع في الوصول دون شاشة تتبع منفصلة في Pushwoosh. انظر المتطلبات الأساسية والجزء 1 لخطوة الموافقة. يحتاج تصفح واجهة المتجر (مشاهدات المنتجات والإضافة إلى عربة التسوق) أيضًا إلى Push Init Embed ON.

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

• الطلبات المدفوعة والدفع: تصل من Shopify حتى لو كان تضمين السمة معطلاً
• تصفح واجهة المتجر (مشاهدات المنتجات والإضافة إلى عربة التسوق): تحتاج إلى أن يكون تضمين السمة ON
• خطوات الدفع: تحتاج إلى أذونات تتبع الدفع من Shopify من الجزء 1 (write_pixels وread_customer_events)، والتي تتم الموافقة عليها بشكل منفصل عن إذن تتبع الطلبات (read_orders) أعلاه

قبل توصيل التطبيق، تحقق من كيفية تعامل Pushwoosh مع أنواع سمات المال والتاريخ لـ PW_OrderCreated وPW_AbandonedCart. لا يمكن إصلاح نوع خاطئ تم إرساله قبل اكتشافه بأثر رجعي.

أحداث الطلبات المدفوعة والدفع

استخدمها للمراسلة بعد الشراء (PW_OrderCreated)، ورحلات أو شرائح عربات التسوق المهجورة (PW_AbandonedCart / PW_AbandonedCartUpdate)، وتعيين تحويلات الشراء. تصل من Shopify حتى لو قام المتسوق بحظر تتبع المتصفح:

يتطلب توصيل التطبيق والموافقة على read_orders

لا يوجد تبديل إضافي بخلاف ذلك: قم بتوصيل التطبيق في الجزء 1 ووافق على إذن تتبع الطلبات من Shopify (read_orders). على عكس تصفح واجهة المتجر، لا تعتمد هذه الأحداث على تشغيل تضمين السمة.

اسم الحدث في Pushwoosh	متى يتم إطلاقه
PW_OrderCreated	عند دفع طلب
PW_AbandonedCart	عندما يبدأ المتسوق عملية الدفع
PW_AbandonedCartUpdate	عندما يضيف المتسوق أو يزيل أو يغير عناصر أثناء عملية دفع قائمة

تتوافق هذه مع إشعارات الطلبات والدفع التي يرسلها Shopify إلى Pushwoosh تلقائيًا (webhooks orders/paid، checkouts/create، وcheckouts/update، المدرجة تحت الكيانات المتزامنة).

شرط Flow الخاص بـ Shopify، وwebhook checkouts/create، ومصدر عربة التسوق في كتلة المنتجات هي ثلاثة أشياء مختلفة تسمى جميعها التخلي عن عربة التسوق. اختر ما يناسب ما تقوم ببنائه، باستخدام الجدول أدناه.

ما تريد بناءه	ماذا تستخدم
تذكير من Shopify Flow (شرط التخلي عن عربة التسوق الخاص بـ Shopify)	Shopify Flow + إجراء Pushwoosh send notification. ليس أسماء أحداث PW_AbandonedCart.
تذكير أو شريحة في Pushwoosh من بدء الدفع أو تغيير عربة التسوق	Customer Journey أو شريحة على PW_AbandonedCart / PW_AbandonedCartUpdate
عرض عناصر عربة التسوق للمتسوق داخل بريد إلكتروني	كتلة المنتجات مصدر عربة التسوق (يستخدم علامة PW_AbandonedCartID في وقت الإرسال). منفصل عن المشغل الذي بدأ الرحلة.

كيف تتصرف هذه الأحداث. checkouts/create يعني فقط أن عملية دفع قد بدأت. لم يقرر Shopify أنها مهجورة، ولم يتم تأكيد أي طلب أيضًا.

أثناء قيام المتسوق بتحرير عملية الدفع، يتم إطلاق PW_AbandonedCartUpdate مرة أخرى لنفس عملية الدفع ويكتب فوق عربة التسوق المخزنة من PW_AbandonedCart. رسائل التذكير الإلكترونية التي تستخدم مصدر عربة التسوق تلتقط أحدث العناصر في وقت الإرسال. لا تحتاج إلى مشغل رحلة ثانٍ فقط لتحديث عربة التسوق.

يقوم PW_AbandonedCart وPW_AbandonedCartUpdate بتعيين علامة PW_AbandonedCartID على المتسوق، وهو ما يقرأه مصدر عربة التسوق في وقت الإرسال. يقوم PW_OrderCreated بمسحها على الفور، لذا فإن المتسوق الذي قام بالدفع بالفعل يتخطى الكتلة بدلاً من الحصول على تذكير لعربة لم تعد لديه. انظر ماذا يحدث عند إرسال PW_OrderCreated للسلوك الدقيق للمسح.

المتسوق الذي يبدأ الدفع مرتين يعيد الدخول إلى الرحلة فقط إذا سمحت بذلك

بشكل افتراضي، لا يعيد Customer Journey إدخال شخص موجود بالفعل فيه، لذا يتم تجاهل checkouts/create ثانٍ من نفس المتسوق بينما لا تزال رحلة عربة التسوق المهجورة الأولى قيد التشغيل، ولا يتم إعادة تشغيلها. قم بتشغيل Allow re-entry على المشغل إذا كنت تريد أن تقوم كل عملية دفع جديدة بإعادة تعيين توقيت التذكير الخاص بهم بدلاً من ذلك. انظر التحكم في ما إذا كان يمكن للمستخدمين إعادة الدخول إلى الحملة.

سمات أحداث الطلبات والدفع

يتضمن PW_OrderCreated وPW_AbandonedCart:

السمة	الوصف
orderId	معرّف الطلب أو الدفع
email	البريد الإلكتروني للمتسوق
totalPrice	إجمالي الطلب أو عربة التسوق
shippingAmount	تكلفة الشحن
taxAmount	مبلغ الضريبة
discountAmount	مبلغ الخصم
currency	رمز العملة
items	بنود عربة التسوق
customerId	للعملاء المسجلين فقط، غير موجود لعمليات الدفع كضيف
orderUrl	صفحة حالة الطلب لـ PW_OrderCreated، أو عنوان URL لاسترداد عربة التسوق المهجورة لـ PW_AbandonedCart وPW_AbandonedCartUpdate. استخدمه لبناء رابط أو زر “أكمل عملية الشراء”.
createdDate	متى تم إنشاء الطلب أو الدفع
abandonedDate	PW_AbandonedCart وPW_AbandonedCartUpdate فقط. متى تم لمس عربة التسوق آخر مرة، وليس متى تم إنشاؤها لأول مرة

تأكد من صحة أنواع سمات المال والتاريخ

يستنتج Pushwoosh نوع كل سمة من أول حدث يراه، وهذا الاستنتاج غير موثوق به لحقول المال والتاريخ مثل totalPrice، shippingAmount، taxAmount، discountAmount، وcreatedDate/abandonedDate أعلاه. سعر عدد صحيح مثل 129 يُستنتج كعدد صحيح، والذي يقتطع بعد ذلك 129.90 إلى 129 في كل حدث لاحق.

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

هل قمت بالاتصال بالفعل؟ تحقق من الأنواع الآن: اذهب إلى Audience → Events في لوحة التحكم، افتح PW_AbandonedCart وPW_OrderCreated، وقارن كل سمة بنفس الجدول. إصلاح نوع خاطئ هناك يصححه للمستقبل، لكن أي قيمة تم إرسالها بالفعل تحت النوع الخاطئ قد فُقدت إلى الأبد.

لا يزال بإمكان عمليات الدفع كضيف إرسال أحداث الطلبات وعربات التسوق، ولكن بدون معرّف عميل مسجل في الحدث.

يحمل PW_AbandonedCartUpdate نفس السمات. إذا كان حسابك يحتوي أيضًا على تكامل Magento متصل، فإن طلباته وعربات التسوق المهجورة تُنشر على نفس أسماء الأحداث هذه، لذا فإن شريحة أو رحلة مبنية على PW_OrderCreated / PW_AbandonedCart تلتقط كلا المتجرين، وتنطبق أنواع السمات أعلاه على كليهما أيضًا. لا يوجد لدى Magento ما يعادل PW_AbandonedCartUpdate، لأنه لا يتتبع تعديلات الدفع قيد التقدم.

يصل items على وجه الخصوص من Shopify مع عدد قليل فقط من الحقول المملوءة.

يتم إثراء عناصر عربة التسوق من كتالوج المنتجات الخاص بك

تحمل items التي يرسلها Shopify على PW_AbandonedCart وPW_AbandonedCartUpdate فقط productId، name، sku، quantity، وprice. يقوم Pushwoosh بملء أي شيء آخر لا يزال هذا العنصر يفتقده، مثل description، imageUrl، productUrl، category، وحقول الكتالوج الأخرى، من المنتج المطابق في كتالوج المنتجات المتصل (انظر اتصال تلقائي بكتالوج المنتجات) كلما تطابق productId. لا يوجد شيء إضافي لإرساله لهذا الغرض. المنتج المفقود من الكتالوج يستمر في الظهور بالحقول التي أرسلها Shopify.

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

استخدمها لشرائح أو رحلات التخلي عن التصفح، ولاستراتيجيات توصية البريد الإلكتروني التي تحتاج إلى مشاهدات المنتجات (على سبيل المثال بناءً على ما شاهدوه). انظر كيفية إعداد توصيات المنتجات في البريد الإلكتروني.

يتطلب تشغيل Push Init Embed

قم بتشغيل Push Init Embed إلى ON في الجزء 4. نفس تضمين السمة مثل الإشعارات الفورية على الويب. لا شيء آخر لإضافته إلى السمة.

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

يتم جمع كلا الحدثين بواسطة نفس تضمين السمة. لا شيء آخر لإضافته إلى السمة بمجرد أن يكون Push Init Embed في وضع ON:

• PW_ProductViewed: يفتح المتسوق صفحة منتج.
• PW_AddToCart: يضيف المتسوق عنصرًا إلى عربة التسوق دون إعادة تحميل الصفحة، وهي الطريقة التي تعمل بها معظم سمات Shopify.

شيئان يجب التحقق منهما قبل البناء على هذه الأحداث

• PW_ProductViewed يحسب كل تحميل صفحة، بدون تصفية. عمليات إعادة التحميل، والمشاهدات المتكررة في نفس الزيارة، وحتى حركة مرور الروبوتات كلها تُحسب بنفس طريقة عرض المنتج الحقيقي. استراتيجية التوصية المبنية على هذا الحدث ترث هذا الضجيج.
• PW_AddToCart يتم إطلاقه فقط إذا كان زر Add to cart في متجرك لا يعيد تحميل الصفحة. اختبر هذا بنفسك: انقر على Add to cart في متجرك وشاهد ما يحدث. هل يتم تحديث عداد عربة التسوق فقط، أم يتم تحديث الصفحة بأكملها؟ معظم سمات Shopify تفعل الأول، حيث تقوم بتحديث العداد دون إعادة التحميل (طلب في الخلفية إلى /cart/add). إذا كانت سمتك تعيد تحميل الصفحة بدلاً من ذلك، فلن يتم إطلاق PW_AddToCart أبدًا، لكن PW_ProductViewed وأحداث الطلبات/الدفع لا تزال تعمل بشكل جيد في كلتا الحالتين.

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

يتضمن كلا الحدثين:

السمة	الوصف
items	المنتج (المنتجات) المعروضة أو المضافة، كل منها يحتوي على productId، name، sku، quantity، price
totalPrice	السعر المجمع لـ items
productUrl	الصفحة التي كان عليها المتسوق
currency	فقط عندما تكشف واجهة المتجر عنها

الرسالة التي تعرض totalPrice تحتاج إلى بديل عندما يكون currency مفقودًا، لأن الرقم وحده لا يوضح العملة التي هو بها.

لا يحمل أي من الحدثين email أو customerId كسمة. يتم تحديد هوية المتسوق بنفس الطريقة التي يفعلها بقية تضمين السمة، من خلال جلسة SDK المرتبطة بـ User ID في الحقل الوصفي (انظر الجزء 2)، وليس من خلال حمولة الحدث.

تحمل items في PW_ProductViewed وPW_AddToCart نفس الحقول التي يرسلها Shopify قبل الإثراء: productId، name، sku، quantity، price. لا يقوم Pushwoosh بملء بقية حقول الكتالوج لهذين الحدثين، بالطريقة التي يفعلها لـ items في PW_AbandonedCart (انظر يتم إثراء عناصر عربة التسوق من كتالوج المنتجات الخاص بك أعلاه).

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

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

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

يتطلب أذونات التطبيق المتعلقة بالبكسل

وافق على أذونات تتبع الدفع التي يطلبها Shopify عند توصيل التطبيق (write_pixels وread_customer_events). انظر الجزء 1 لتلك الخطوة. لا توجد خطوة تضمين سمة. يقوم Shopify بالإبلاغ عن هذه المعالم تلقائيًا بمجرد الموافقة على تلك الأذونات (تقنيًا، عبر Web Pixel الخاص بـ Shopify).

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

البيع المكتمل هو PW_OrderCreated من القسم أعلاه، وليس هذين الحدثين.

PW_AbandonedCart يخبرك فقط أن عملية دفع قد بدأت. يمثل هذان الحدثان نقطتين لاحقتين في نفس عملية الدفع، بهذا الترتيب: معلومات الاتصال أولاً، تفاصيل الدفع ثانيًا. المتسوق الذي وصل إلى PW_PaymentInfoSubmitted ولم يحصل أبدًا على PW_OrderCreated تالٍ قد وصل أبعد من الذي أطلق PW_AbandonedCart فقط، لذا يمكن لرسالة مبنية على تلك المرحلة أن تعالج دفعة متوقفة على وجه التحديد، بدلاً من تذكير عام بعربة التسوق.

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

يتضمن كلا الحدثين:

السمة	الوصف
items	بنود الدفع، كل منها يحتوي على productId، name، sku، quantity، price
orderId	رمز الدفع، أو معرّف طلب Shopify بمجرد أن يكون للدفع واحد
totalPrice	إجمالي الدفع
email	فقط عندما يكون للدفع واحد. عملية الدفع القائمة على الهاتف (بدون إدخال بريد إلكتروني) ترسل الحدث بدونه.
currency	فقط عندما يكون للدفع واحد

تحقق من أنه يعمل

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

• في القائمة المنسدلة Event عند إنشاء شريحة حسب الأحداث، يظهر اسم جديد على الفور.
• في القائمة المنسدلة Event عند إضافة مشغل Customer Journey، يمكن أن يستغرق ظهور اسم جديد ما يصل إلى 10 دقائق (تلك القائمة المنسدلة مخزنة مؤقتًا). إذا لم تره بعد، انتظر بدلاً من افتراض أن التكامل معطل.

إجراء الاختبار	الحدث
دفع طلب اختبار	PW_OrderCreated
بدء عملية دفع	PW_AbandonedCart
تغيير العناصر في تلك العملية	PW_AbandonedCartUpdate
فتح صفحة منتج (Push Init Embed ON)	PW_ProductViewed
إضافة عنصر إلى عربة التسوق	PW_AddToCart
إدخال معلومات الاتصال عند الدفع	PW_CheckoutContactInfo
إرسال معلومات الدفع عند الدفع	PW_PaymentInfoSubmitted

استخدم الأحداث

بعد أن تعرف الحدث الذي تحتاجه، استخدمه في مكانين:

• كمشغل أو شرط شريحة: اختره في القائمة المنسدلة Event عند إنشاء شريحة حسب الأحداث أو إضافة مشغل Customer Journey.
• في نص الرسالة: في خطوة الرسالة، قم بتشغيل Personalize message with event attributes واختر السمة (على سبيل المثال إجمالي الطلب من PW_OrderCreated). يمكنك أيضًا إدراج السمة باستخدام عنصر نائب Liquid. انظر المحتوى الديناميكي وقوالب Liquid في الرحلات.

بالنسبة للطلبات المدفوعة، يمكنك أيضًا تعيين PW_OrderCreated كـ حدث تحويل حتى تغذي مشتريات Shopify تقسيم RFM، وإسناد الرحلة، وإحصائيات كتلة المنتجات.

حملات مثال

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

• تذكير بعربة التسوق المهجورة. يلتقط كل متسوق بدأ عملية الدفع، بغض النظر عن مدى وصوله: أوسع جمهور هنا. قم ببنائه كـ Customer Journey: التشغيل على PW_AbandonedCart، انتظر PW_OrderCreated، ثم أرسل بريدًا إلكترونيًا مع كتلة مصدر عربة التسوق لمن لم يدفع. انظر كيفية إعداد حملة عربة التسوق المهجورة للإعداد الكامل.
• متابعة لعمليات الدفع المتوقفة. يلتقط فقط المتسوقين الذين وصلوا إلى حد إدخال معلومات الاتصال ولكن لم يدفعوا أبدًا، شريحة أضيق من الجمهور أعلاه. قم بالتقسيم على PW_CheckoutContactInfo، ثم استبعد أي شخص لديه أيضًا PW_PaymentInfoSubmitted أو PW_OrderCreated.
• استرداد لدفعة متوقفة. يلتقط المتسوقين الذين وصلوا إلى الدفع ولكن لم يكملوا الطلب أبدًا، أبعد من المتابعة أعلاه ومتنافية معها. قم بالتقسيم على PW_PaymentInfoSubmitted، ثم استبعد أي شخص لديه أيضًا PW_OrderCreated.
• بريد إلكتروني لتوصية التصفح. يلتقط المتسوقين الذين نظروا إلى المنتجات ولكن لم يبدأوا عملية الدفع على الإطلاق، جمهور مختلف عن التذكيرات أعلاه. استخدم PW_ProductViewed مع استراتيجية كتلة المنتجات بناءً على ما شاهدوه. انظر كيفية إعداد توصيات المنتجات في البريد الإلكتروني.

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

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

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

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

بعد ذلك، استخدم أسماء الأحداث أعلاه في الرحلات، أو الشرائح، أو تعيين التحويل. أمثلة:

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