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

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

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

ما هو PW_AbandonedCart

يشير PW_AbandonedCart إلى أن المستخدم ترك منتجات في سلته دون إتمام الشراء. إنه ليس حدثًا افتراضيًا (default event) مدمجًا. بل هو اسم حدث مشترك يُستخدم عبر تكاملات التجارة الإلكترونية لـ Pushwoosh حتى تعمل كل من Journeys وكتلة Products والشرائح (segments) بنفس الطريقة.

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

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

يؤدي إرسال PW_AbandonedCart إلى أمرين من جانب Pushwoosh:

1. يتم تسجيله مثل أي حدث مخصص آخر، لذا يمكنك رؤيته في إحصائيات الأحداث (Event statistics) واستخدامه في الشرائح (segments).
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)

1. اذهب إلى Audience → Events في لوحة تحكم Pushwoosh الخاصة بك وانقر على 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 تُرجع نجاحًا، لذلك لن ترى في الاستجابة أن البيانات قد فُقدت.

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

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

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

إرسال الأحداث من الواجهة الخلفية (backend)

تحتاج إلى مساعدة المطورين

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

اطلب من فريق التطوير لديك استدعاء 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، فلن تحتاج إلى إرسال هذه الأحداث من الواجهة الخلفية. يرسل Magento PW_AbandonedCart و PW_OrderCreated نيابة عنك وفقًا لجدول زمني.

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

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

ملاحظة

يحتاج مصدر السلة (Cart) في كتلة Products إلى قوالب المحتوى (Content Templates) في خطتك ورمز وصول API. انظر كتلة Products.

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

4. نسّق الشبكة وقالب البطاقة حسب الحاجة. انظر تنسيق الشبكة.

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

نصيحة

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

بناء 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. قم بمعاينة البريد الإلكتروني وتأكيد التخطيط ومحتوى المنتج قبل إرساله إلى المتسوقين الحقيقيين.