أحداث وحملات Shopify

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

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

• دفع الطلب والدفع (checkout): تصل من Shopify حتى لو كان تضمين القالب متوقفًا
• تصفح واجهة المتجر (مشاهدات المنتج والإضافة إلى السلة): يتطلب أن يكون تضمين القالب مفعّلًا
• خطوات الدفع: تتطلب أذونات تتبع الدفع من 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، المدرجة ضمن الكيانات المتزامنة).

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

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

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

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

يضبط PW_AbandonedCart وPW_AbandonedCartUpdate علامة PW_AbandonedCartID على المتسوق، وهي ما يقرأه مصدر Cart وقت الإرسال. يمحوها 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، أو رابط استعادة عملية الدفع المتروكة لـ 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 بالأنواع الصحيحة قبل ذلك، باستخدام الجدول في إنشاء الأحداث في Control Panel الخاص بك. تخطَّ خطوة Send the events from your backend في ذلك الدليل. يرسلها تكامل Shopify بالفعل نيابة عنك.

متصل بالفعل؟ تحقق من الأنواع الآن: انتقل إلى Audience → Events في Control Panel، وافتح 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 فقط.

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

استخدم هذه الأحداث لشرائح أو رحلات التخلي عن التصفح، ولاستراتيجيات توصيات البريد الإلكتروني التي تحتاج إلى مشاهدات المنتج (مثل Based on what they viewed). راجع كيفية إعداد توصيات المنتج في البريد الإلكتروني.

يتطلب تفعيل Push Init Embed

فعّل Push Init Embed في الجزء 4. نفس تضمين القالب المستخدم لـ web push. لا حاجة لإضافة أي شيء آخر إلى القالب.

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

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

• 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 (راجع يتم إثراء عناصر سلة التسوق من كتالوج المنتجات الخاص بك أعلاه).

تبحث استراتيجية التوصيات التي تحتاج إلى تفاصيل منتج كاملة، مثل Based on what they viewed، عنها في كتالوج المنتجات الخاص بك حسب productId عند عرض الرسالة. راجع كيفية إعداد توصيات المنتج في البريد الإلكتروني لمعرفة ما تحتاجه كل استراتيجية.

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

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

يتطلب أذونات تطبيق متعلقة بـ pixel

وافق على أذونات تتبع الدفع التي يطلبها 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 مفعّل)	PW_ProductViewed
إضافة عنصر إلى السلة	PW_AddToCart
إدخال معلومات الاتصال عند الدفع	PW_CheckoutContactInfo
إرسال معلومات الدفع عند الدفع	PW_PaymentInfoSubmitted

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

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

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

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

حملات نموذجية

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

• تذكير سلة التسوق المتروكة. يلتقط كل متسوق بدأ الدفع، بغض النظر عن مدى تقدمه — أوسع جمهور هنا. ابنِه كـ Customer Journey: مُشغّل على PW_AbandonedCart، انتظار PW_OrderCreated، ثم إرسال بريد إلكتروني مع وحدة مصدر Cart إلى كل من لم يدفع. راجع كيفية إعداد حملة سلة تسوق متروكة للإعداد الكامل.
• متابعة عمليات الدفع المتوقفة. يلتقط فقط المتسوقين الذين وصلوا إلى إدخال معلومات الاتصال لكنهم لم يدفعوا أبدًا، شريحة أضيق من الجمهور أعلاه. أنشئ شريحة على PW_CheckoutContactInfo، ثم استبعد أي شخص لديه أيضًا PW_PaymentInfoSubmitted أو PW_OrderCreated.
• استعادة دفعة متوقفة. يلتقط المتسوقين الذين وصلوا إلى الدفع لكنهم لم يكملوا الطلب أبدًا، أبعد من المتابعة أعلاه ومتنافيًا معها. أنشئ شريحة على PW_PaymentInfoSubmitted، ثم استبعد أي شخص لديه أيضًا PW_OrderCreated.
• بريد إلكتروني لتوصيات التصفح. يلتقط المتسوقين الذين نظروا إلى المنتجات لكنهم لم يبدؤوا الدفع من الأساس، جمهور مختلف عن التذكيرات أعلاه. استخدم PW_ProductViewed مع استراتيجية Based on what they viewed لوحدة Products. راجع كيفية إعداد توصيات المنتج في البريد الإلكتروني.