انتقل إلى المحتوى
وثائق المطورالدعم طلب عرض توضيحي تسجيل الدخول
Pushwoosh.com

الدخول المستند إلى مُشغِّل

يبدأ الدخول المستند إلى مُشغِّل (Trigger-based entry) الرحلة عندما يقوم المستخدم بتنفيذ حدث معين (على سبيل المثال، اتخاذ إجراء معين).

لإعداد الدخول المستند إلى مُشغِّل، حدد موقع عنصر الدخول على اللوحة واختر الحدث (Event) الذي سيعمل كمُشغِّل.

لمزيد من المعلومات حول كيفية تكوين الأحداث، راجع توثيق الأحداث (Events).

إذا كان للحدث (Event) المحدد سمات، فيمكنك تضييق شروط الدخول باستخدام تلك السمات. انقر فوق إضافة شرط (Add condition) عند تحرير العنصر، ثم اختر سمة من القائمة المنسدلة وحدد عاملها وقيمتها.

اختر الحدث الذي سيعمل كمُشغِّل

تحديد من يدخل الحملة

Anchor link to

حدد المستخدم (المستخدمين) الذي يجب أن يدخل الرحلة عند وقوع حدث معين.

استخدم القائمة المنسدلة من يدخل الحملة؟ (Who enters the campaign?) للاختيار بين الوضعين المتاحين:

المستخدمون الذين يقومون بالحدث (الافتراضي)

Anchor link to

المستخدم الذي يُشغِّل الحدث هو الذي يدخل الرحلة.

اختر المستخدمين الذين يقومون بالحدث

مثال يكمل مستخدم عملية شراء (حدث CheckoutSuccess). يدخل نفس المستخدم (على سبيل المثال، User ID: 123) في رحلة ما بعد الشراء تتضمن رسالة شكر أو توصيات بالمنتجات أو استبيان رضا.

المستخدمون من سمة حدث

Anchor link to

بدلاً من تسجيل المستخدم الذي شغّل الحدث، يمكنك تمرير معرف مستخدم (User ID) واحد أو أكثر في سمة حدث مخصصة. سيدخل المستخدمون المدرجون في تلك السمة الرحلة.

لهذا، حدد المستخدمون من سمة حدث (Users from an event attribute) واختر مفتاح سمة (على سبيل المثال، recipient_ids، target_user_id). يجب أن يتطابق هذا المفتاح مع بنية حمولة الحدث الخاصة بك.

اختر المستخدمين من سمة حدث

مثال على الحمولة (مستخدم واحد)
Anchor link to
{
  "application": "XXXXX-XXXXX",
  "event": "invitation",
  "attributes": {
      "targetId": 321
  },
  "userId": 123
}

يدخل المستخدم 321 (من targetId) الرحلة.

مثال على الحمولة (مستخدمون متعددون)
Anchor link to

إذا قدمت معرفات مستخدمين متعددة، فاستخدم مصفوفة JSON من السلاسل النصية.

{
    "application": "XXXXX-XXXXX",
    "event": "invitation",
    "attributes": {
        "targetIds": [1,2,3,4]
    },
    "userId": 123
}

سيدخل المستخدمون 1 و 2 و 3 و 4 الرحلة.

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

Anchor link to

إشعارات التعليقات

عندما يعلق شخص ما على منشور مستخدم، يتم إخطار مالك المنشور.

مثال: يتضمن حدث التعليق معرف مالك المنشور في سمة target_user_id. يدخل هذا المستخدم في رحلة لتلقي الإشعار.

برامج الإحالة

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

مثال: يقوم المستخدم 123 بتشغيل الحدث، ويدخل المُحيل 456 (من سمة referrer_id) في حملة مكافآت.

شراء الهدايا

عندما يشتري مستخدم هدية، تتم إضافة المستلم إلى رحلة باستخدام recipient_user_id من حمولة الحدث.

مثال يشتري المستخدم 123 هدية للمستخدم 456، الذي يتلقى بعد ذلك إشعارًا أو تدفقًا تمهيديًا أو رسالة شكر.

تعيين إتاحة الدخول

Anchor link to

تحكم في الوقت الذي يمكن للمستخدمين فيه الدخول إلى رحلة عبر الدخول المستند إلى مُشغِّل. لديك خياران:

  • السماح بالدخول في أي وقت: يمكن للمستخدمين الدخول إلى الرحلة كلما وقع حدث المُشغِّل.

  • تقييد الدخول إلى فترة محددة: لا يمكن للمستخدمين الدخول إلى الرحلة إلا إذا وقع حدث المُشغِّل ضمن النطاق الزمني المحدد.

    عند تقييد الدخول، حدد تاريخ البدء و تاريخ الانتهاء و المنطقة الزمنية. تبدأ نافذة الدخول في الساعة 00:00 في تاريخ البدء وتنتهي في الساعة 23:59 في تاريخ الانتهاء، بناءً على المنطقة الزمنية المختارة.

تعيين إتاحة الدخول

التحكم في عدد الجلسات التي يمكن للمستخدم أن يمتلكها في نفس الوقت

Anchor link to

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

اختر أحد الخيارات التالية من القائمة المنسدلة:

  • جلسة نشطة واحدة لكل مستخدم
  • جلسات نشطة متعددة لكل مستخدم

جلسة نشطة واحدة لكل مستخدم

Anchor link to

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

اختر جلسة نشطة واحدة لكل مستخدم

حالات الاستخدام
Anchor link to
  • تدفقات الإعداد (Onboarding flows) حيث لا يجب على المستخدم إعادة التشغيل حتى ينهي الرحلة الحالية
  • تذكيرات تجديد الاشتراك حيث لا يجب أن يتلقى المستخدمون إشعارات متداخلة
  • العروض أو التجارب محدودة الوقت حيث يُسمح بتشغيل حملة نشطة واحدة فقط لكل مستخدم
  • حملات جمع الملاحظات لضمان أن يقدم كل مستخدم مدخلاته مرة واحدة قبل الدخول مرة أخرى

جلسات نشطة متعددة لكل مستخدم

Anchor link to

يمكن للمستخدمين أن يكون لديهم أكثر من جلسة نشطة واحدة في الحملة. يجب تحديد كل جلسة بسمة حدث فريدة (على سبيل المثال، order_id، product_id).

لإعداد هذا:

  1. حدد جلسات نشطة متعددة لكل مستخدم (Multiple active sessions per user) في القائمة المنسدلة.

  2. اختر سمة معرف الجلسة (على سبيل المثال، order_id، product_id). ستميز هذه السمة جلسة عن أخرى.

اختر جلسات نشطة متعددة لكل مستخدم

مثال

  • OrderPlaced مع order_id = "1001" ← يبدأ الجلسة 1

  • OrderPlaced مع order_id = "1002" ← يبدأ الجلسة 2

إذا تم إرسال حدث OrderReady بدون order_id، فسيتم تمييز كل من الجلسة 1 والجلسة 2 على أنهما “جاهزتان”، حتى لو كان طلب واحد فقط هو الجاهز بالفعل.

حالات الاستخدام
Anchor link to
  • مشتريات التجارة الإلكترونية: يبدأ كل طلب رحلته الخاصة، بحيث يمكن تتبع طلبات متعددة من مستخدم واحد بشكل مستقل. (السمة: order_id)
  • برامج الإحالة: تنشئ كل إحالة جلسة جديدة، مما يسمح لمستخدم واحد بإحالة عدة أصدقاء. (السمة: referral_id)
  • برامج الولاء: تتبع النقاط أو المكافآت من معاملات مختلفة تعمل بالتوازي. (السمة: transaction_id)
  • حجوزات التذاكر: يطلق كل حجز رحلته الخاصة، بحيث يمكن للمستخدمين إدارة تذاكر متعددة في وقت واحد. (السمة: booking_id)
  • جدولة المواعيد: يتم التعامل مع كل موعد كجلسة منفصلة. (السمة: appointment_id)

بمجرد تكوين عنصر الدخول، انقر فوق تطبيق (Apply) لحفظ التغييرات.

سيناريو مثال: رحلة طلب تجارة إلكترونية بجلسات متعددة

Anchor link to

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

  1. أنشئ الحدث OrderPlaced وتأكد من أنه يتضمن السمة order_id. تعرف على المزيد حول إنشاء الأحداث

إنشاء حدث OrderPlaced 2. عيّن هذا الحدث كمُشغِّل لرحلتك.

عيّن هذا الحدث كمُشغِّل لرحلتك

  1. في إعدادات الجلسة، حدد جلسات نشطة متعددة لكل مستخدم (Multiple active sessions per user) واختر order_id كمعرف للجلسة.

اختر جلسات نشطة متعددة لكل مستخدم

في هذا الإعداد، يبدأ كل طلب جديد جلسة رحلة منفصلة.

  • OrderPlaced مع order_id = 1001 يبدأ الجلسة 1
  • OrderPlaced مع order_id = 1002 يبدأ الجلسة 2
  1. بعد ذلك، أضف عنصر انتظار المُشغِّل (Wait for Trigger) لتتبع متى يكون الطلب جاهزًا للاستلام أو التسليم. استخدم الحدث OrderReady، الذي يجب أن يتضمن أيضًا نفس order_id. هذا يضمن تحديث كل طلب في الجلسة الصحيحة:
  • OrderReady مع order_id = 1001 ينطبق فقط على الجلسة 1
  • OrderReady مع order_id = 1002 ينطبق فقط على الجلسة 2

استخدم الحدث OrderReady في عنصر انتظار المُشغِّل

  1. أخيرًا، أضف هدف تحويل، على سبيل المثال حدث OrderDelivered. يجب أن يتضمن هذا الحدث أيضًا نفس order_id حتى يمكن مطابقته مع الجلسة الصحيحة.

  • إذا تضمن OrderDelivered order_id = "1001"، فإنه يسجل تحويلاً لـ الجلسة 1.

  • إذا تضمن OrderDelivered order_id = "1002"، فإنه يسجل تحويلاً لـ الجلسة 2.

اختر جلسات نشطة متعددة لكل مستخدم