كيفية إعداد حملة للسلات المتروكة

المتسوقون الذين يضيفون منتجات إلى سلة التسوق ويغادرون دون إتمام الشراء هم من أسهل التحويلات التي يمكن استعادتها. لقد أظهروا بالفعل نية الشراء.

يوضح هذا الدليل كيفية إرسال بريد إلكتروني للسلة المتروكة إليهم في Pushwoosh: أطلق حدث PW_AbandonedCart من متجرك، واعرض المنتجات المتبقية في البريد الإلكتروني باستخدام كتلة Products، وقم بتشغيل الإرسال من Customer Journey.

ما هو PW_AbandonedCart

PW_AbandonedCart هو حدث يشير إلى أن مستخدمًا ترك منتجات في سلة التسوق الخاصة به دون إتمام عملية الشراء. إنه ليس حدثًا افتراضيًا مدمجًا. بل هو اسم حدث مشترك يُستخدم عبر تكاملات التجارة الإلكترونية في Pushwoosh لضمان عمل journeys وكتلة Products والشرائح بنفس الطريقة.

• تكامل Magento: يرسل حدثي PW_AbandonedCart و PW_OrderCreated تلقائيًا بالنيابة عنك.
• تكامل Shopify: يرسل أحداث PW_AbandonedCart و PW_OrderCreated و PW_AbandonedCartUpdate (يتم إطلاقه مرة أخرى مع استمرار المتسوق في تعديل نفس عملية الدفع) تلقائيًا بالنيابة عنك، مع إثراء بيانات منتجات السلة من كتالوج المنتجات الخاص بك.
• أي متجر آخر أو خلفية مخصصة: يرسل فريقك كلا الحدثين عبر postEvent بالأسماء والسمات الموضحة في كيفية إرسال تذكيرات السلة المتروكة.

ماذا يحدث عند إرسال PW_AbandonedCart

إرسال PW_AbandonedCart يقوم بأمرين من جانب Pushwoosh:

1. يتم تسجيله مثل أي حدث مخصص آخر، لذا يمكنك رؤيته في إحصائيات الأحداث واستخدامه في الشرائح.
2. يقوم Pushwoosh بتخزين محتويات السلة ويضيف للمستخدم الوسوم التالية:
   • PW_AbandonedCartID: معرف للسلة الحالية، يُستخدم لجلب محتوياتها عند وقت الإرسال.
   • PW_AbandonedCartDate: قيمة abandonedDate من حمولة الحدث.

ماذا يحدث عند إرسال PW_OrderCreated

عندما يقوم المتسوق بإجراء طلب، أرسل PW_OrderCreated (أو PW_OrderUpdated). يقوم Pushwoosh بمسح PW_AbandonedCartID و PW_AbandonedCartDate لذلك المستخدم على الفور. لا تتم مطابقة قيم orderId: أي طلب من المستخدم يزيل كلا الوسمين، حتى لو كان الشراء لسلة مختلفة.

مثال: متسوق يترك سلة ORDER-100، ثم يشتري ORDER-200 قبل إرسال التذكير. يقوم Pushwoosh بمسح الوسوم، لذلك لن يتلقى تذكيرًا بخصوص ORDER-100.

ماذا يظهر في البريد الإلكتروني للتذكير

تقرأ كتلة Products السلة المخزنة في ملف تعريف المستخدم عند وقت الإرسال. ولا تستخدم قائمة المنتجات من حدث PW_AbandonedCart الذي بدأ الـ journey.

• نفس orderId: كل حدث PW_AbandonedCart جديد يقوم بالكتابة فوق السلة المخزنة. يعرض التذكير أحدث المنتجات.
• orderId مختلف: يقوم Pushwoosh بتخزين سلة منفصلة. لا يتم دمج المنتجات.

كيفية إرسال تذكيرات السلة المتروكة

اتبع هذه الخطوات لإنشاء الأحداث، وإرسالها من متجرك، وبناء البريد الإلكتروني، وإطلاق Customer Journey.

إنشاء الأحداث في Control Panel الخاص بك

يقوم Pushwoosh بإنشاء حدث وسماته تلقائيًا من أول استدعاء postEvent تحت اسم لا يتعرف عليه، مستنتجًا نوع كل سمة من القيمة المرسلة. هذا الاستنتاج غير موثوق به لحقول المبالغ المالية في PW_AbandonedCart. قم بتعريف كلا الحدثين بشكل صريح لضمان تعيين الأنواع بشكل صحيح:

1. اذهب إلى Audience → Events في Pushwoosh Control Panel الخاص بك وانقر على Create Event.
2. أنشئ حدثًا مخصصًا باسم PW_AbandonedCart بالسمات التالية:

السمة	النوع
email	string
orderId	string
customerId	string
orderUrl	string
abandonedDate	date
createdDate	date
totalPrice	decimal (price)
shippingAmount	decimal (price)
taxAmount	decimal (price)
discountAmount	decimal (price)
currency	string

3. كرر العملية لـ PW_OrderCreated بسمة orderId واحدة.

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

يقوم Pushwoosh بتخزين كل قيمة سمة فقط بالنوع المحدد لها، سواء تم تعريفه هنا أو تم استنتاجه لسمة تم إنشاؤها تلقائيًا. يتم تجاهل أي قيمة لا تتطابق مع النوع بصمت، ولا يزال postEvent يعيد نجاحًا، لذلك لن ترى في الاستجابة أنه تم فقدان البيانات. يمكنك إصلاح النوع الخاطئ لاحقًا عن طريق تحرير الحدث في Control Panel، ولكن أي بيانات تم إرسالها قبل الإصلاح قد فُقدت بالفعل.

لكي تعمل ميزة السلة المتروكة، طابق الأنواع في الجدول أعلاه:

• حقول المبالغ المالية (totalPrice, shippingAmount, taxAmount, discountAmount): استخدم decimal (price). إذا تُركت دون تعريف، فإن قيمة عدد صحيح مثل 129 يتم استنتاجها كـ integer. إذا تم تعريفها كـ string، فلن يتم تخزين السلة ولن يتم تعيين أي وسوم. إذا تم تعريفها كـ integer، فإن 129.90 تصبح 129.
• التواريخ (abandonedDate, createdDate): استخدم date.
• items: لا تقم بإضافتها إلى تعريف الحدث. أرسلها في حمولة JSON كمصفوفة من الكائنات. استخدم أرقام JSON حقيقية لـ price و quantity، وليس سلاسل نصية بين علامتي اقتباس.

تعرف على المزيد حول إنشاء الأحداث المخصصة.

إرسال الأحداث من الخلفية الخاصة بك

مطلوب مساعدة المطورين

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

اطلب من فريق التطوير الخاص بك استدعاء postEvent كلما تم ترك سلة تسوق، باستخدام مخطط السمات هذا:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "PW_AbandonedCart",
    "attributes": {
      "email": "shopper@example.com",
      "orderId": "ORDER-10293",
      "customerId": "CUST-4471",
      "orderUrl": "https://yourstore.com/cart/restore/ORDER-10293",
      "abandonedDate": "2026-07-28T10:15:00Z",
      "createdDate": "2026-07-28T09:40:00Z",
      "totalPrice": 129.90,
      "shippingAmount": 9.90,
      "taxAmount": 0,
      "discountAmount": 0,
      "currency": "USD",
      "items": [
        {
          "productId": "SKU-4821",
          "name": "Wireless headphones",
          "quantity": 1,
          "price": 119.90,
          "sku": "SKU-4821",
          "description": "Over-ear, noise-cancelling",
          "imageUrl": "https://yourstore.com/media/sku-4821.jpg",
          "productUrl": "https://yourstore.com/products/sku-4821",
          "category": "Audio"
        }
      ]
    },
    "userId": "shopper@example.com"
  }
}

عندما تتحول السلة إلى طلب، أرسل PW_OrderCreated مع orderId فقط لمسح وسوم السلة:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "PW_OrderCreated",
    "attributes": {
      "orderId": "ORDER-10293"
    },
    "userId": "shopper@example.com"
  }
}

نصيحة

إذا كنت تستخدم تكامل Magento أو تكامل Shopify، فلن تحتاج إلى إرسال هذه الأحداث من الخلفية الخاصة بك. يرسل Magento حدثي PW_AbandonedCart و PW_OrderCreated بالنيابة عنك وفقًا لجدول زمني؛ ويرسل Shopify هذه الأحداث (بالإضافة إلى PW_AbandonedCartUpdate لتعديلات الدفع الجارية) من webhooks في الوقت الفعلي.

إضافة كتلة Products إلى بريدك الإلكتروني

1. افتح محرر محتوى البريد الإلكتروني وأضف كتلة Products إلى لوحة العمل.
2. في لوحة الإعدادات، اضبط Source على Cart.

ملاحظة

يحتاج مصدر Cart في كتلة Products إلى Content Templates في خطتك و API access token. راجع كتلة Products.

3. اضبط Max products shown لتحديد عدد منتجات السلة التي تظهر في البريد الإلكتروني.

4. صمم الشبكة وقالب البطاقة حسب الحاجة. راجع تصميم الشبكة.

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

نصيحة

مصدر Cart متاح في محرر محتوى البريد الإلكتروني. لتذكير المتسوقين بإشعار push بدلاً من ذلك، استخدم خطوة Push مع التخصيص الذي يشير إلى تفاصيل السلة من الحدث.

بناء Customer Journey

1. أضف Trigger-based Entry باستخدام حدث PW_AbandonedCart.
2. أضف خطوة Wait for Trigger. اضبط فترة الانتظار الخاصة بها على ساعة أو ساعتين. قم بتسمية الفرع Order placed وأضف حدث PW_OrderCreated إليه.

تنبيه

اضبط فترة الانتظار على خطوة Wait for Trigger نفسها. لا تقم بإضافة خطوة Time Delay منفصلة قبلها.

Wait for Trigger تبدأ فقط في الاستماع لحدث PW_OrderCreated بمجرد وصول المتسوق إلى تلك الخطوة. إذا جاءت خطوة Time Delay أولاً وقام المتسوق بإجراء طلب خلال فترة التأخير هذه، فلن يتم اكتشاف حدث الطلب. ينتقل المتسوق إلى فرع Not triggered، ولكن PW_OrderCreated يكون قد مسح بالفعل PW_AbandonedCartID. لا تجد كتلة Products أي سلة وتتخطاها. لا يزال المتسوق يتلقى البريد الإلكتروني للسلة المتروكة بدون منتجات، على الرغم من أنه قد أتم عملية الشراء بالفعل.

3. وجه فرع Order placed إلى Exit. لقد اشترى المستخدم بالفعل، لذا لا تذكره.
4. وجه فرع Not triggered إلى خطوة Email. احفظ البريد الإلكتروني الذي أنشأته في إضافة كتلة Products إلى بريدك الإلكتروني كـ محتوى بريد إلكتروني، ثم حدده كمحتوى لهذه الخطوة.

اختبر قبل الإطلاق

1. أرسل حدث PW_AbandonedCart اختباريًا لجهاز اختبار. لا تقم بتعيين وسم PW_AbandonedCartID يدويًا: تقوم كتلة Products بتحميل محتويات السلة من السلة المخزنة التي ينشئها الحدث، وليس من قيمة الوسم. بدون حدث حقيقي، سيتم عرض الكتلة فارغة.
2. قم بمعاينة البريد الإلكتروني وتأكد من التخطيط ومحتوى المنتج قبل إرساله إلى المتسوقين الحقيقيين.