الأحداث الافتراضية
ما هي الأحداث الافتراضية
Anchor link toالأحداث الافتراضية هي تفاعلات أساسية يقوم بها المستخدمون في التطبيقات أو المواقع الإلكترونية بغض النظر عن صناعتها أو وظائفها. تشكل هذه الإجراءات الرئيسية للمستخدمين جوهر التواصل مع العملاء ويمكن الاستفادة منها لأي منتج وعميل في أي مرحلة من مراحل دورة حياة العميل.
الأحداث الافتراضية متاحة بشكل جاهز لإصدارات SDK المحدثة. لا تحتاج إلى إعدادات إضافية باستثناء PW_InAppPurchase (انظر التفاصيل أدناه).
للعثور على الأحداث الافتراضية المتاحة في Pushwoosh وتفعيلها، اتبع الخطوات التالية:
- انتقل إلى علامة التبويب Events داخل قسم Audience.
- انقر على Create Event.
- حدد Default Event من القائمة المنسدلة.
- في النافذة المنبثقة، اختر الحدث المطلوب وانقر على Activate.

بمجرد تفعيلها، يمكن استخدام الأحداث الافتراضية في الرسائل القائمة على السلوك. على سبيل المثال، استخدمها كـ Trigger-based Entry في Customer Journey أو كمشغل لرسائل In-App.
PW_DeviceRegistered
Anchor link toيتم إطلاق هذا الحدث مرة واحدة فقط لكل جهاز، عند تشغيل التطبيق لأول مرة وتهيئة SDK. كما يوحي الاسم، يتتبع هذا الحدث تسجيل الجهاز في تطبيقك.
حالات الاستخدام
- أطلق حملة تهيئة للمستخدمين المسجلين حديثًا - أضف Trigger-based Entry باستخدام حدث PW_DeviceRegistered إلى Customer Journey للتهيئة.
- حدد أنشطة الاستحواذ التي تجلب لك المزيد من القادمين الجدد باستخدام إحصائيات الحدث.
- أشرك المستخدمين منذ زيارتهم الأولى: استقبلهم بـ In-Apps التي يتم تشغيلها بواسطة حدث DeviceRegistered.

PW_DeviceUnregistered
Anchor link toيتم إطلاق هذا الحدث عند إلغاء تثبيت التطبيق، أو عندما يختار المستخدم إلغاء الاشتراك من رسائل البريد الإلكتروني أو الإشعارات الفورية.
سمات الحدث
- message_id (string)
- message_code (string)
- campaign_id (string)
حالات الاستخدام
- احتفظ بالمستخدمين عندما يقررون التوقف عن استخدام تطبيقك. على سبيل المثال، يمكنك إرسال بريد إلكتروني بعرض خاص لكل مستخدم قام بإلغاء تثبيت التطبيق.
- حافظ على التواصل مع المستخدمين الذين ألغوا اشتراكهم من إحدى قنواتك. على سبيل المثال، إذا لم يعد المستخدم يرغب في تلقي الإشعارات الفورية، يمكنك إرسال بريد إلكتروني أو عرض in-app لتشجيعهم على استخدام التطبيق بشكل أكثر تكرارًا.
PW_ApplicationOpen
Anchor link toللتطبيقات المحمولة فقط
يتم تشغيل حدث ApplicationOpen في كل مرة يفتح فيها المستخدم تطبيقك المحمول على جهازه.
سمات الحدث
- device_type (integer device type code, ارجع إلى registerDevice للتفاصيل)
- application_version
حالات الاستخدام
- اجمع إحصائيات الاحتفاظ بالمستخدمين بناءً على إحصائيات حدث ApplicationOpen.
- قم بتشغيل حملات رسائل داخل التطبيق للمستخدمين النشطين في التطبيق.
PW_ScreenOpen
Anchor link toللتطبيقات المحمولة فقط
يتم إطلاق هذا الحدث في كل مرة يعرض فيها المستخدم شاشة معينة في تطبيقك المحمول.
سمات الحدث
- application_version
- device_type (integer device type code, ارجع إلى registerDevice للتفاصيل)
- screen_name (اسم الشاشة الفني الذي تم الحصول عليه من تطبيقك)
حالات الاستخدام
- أرسل رسائل ذات صلة تامة للمستخدمين الذين أبدوا اهتمامهم بأقسام معينة من التطبيق عن طريق بدء Customer Journeys بحدث PW_ScreenOpen.
- قم بتقييم وتحسين فعالية عروضك الترويجية: قم بـ A/B/n test لنسختين أو أكثر من عرضك، انتظر حدوث حدث ScreenOpen ثم انظر أي محتوى حقق أفضل أداء.
- تعرف على شاشات التطبيق الأكثر زيارة: قم بتصفية إحصائيات الحدث حسب اسم الشاشة.

PW_ApplicationMinimized
Anchor link toللتطبيقات المحمولة فقط
يتم إطلاق هذا الحدث عندما يقوم المستخدم بتصغير التطبيق (وليس إيقافه بالقوة) على جهازه.
سمات الحدث
- device_type (integer device type code, ارجع إلى registerDevice للتفاصيل)
- application_version
حالات الاستخدام
- تتبع متوسط وقت الجلسة بين أحداث ApplicationOpen و ApplicationMinimized.
- أرسل إشعارات فورية أثناء تشغيل التطبيق في الخلفية لجذب انتباه المستخدمين وإعادتهم إلى التطبيق.
PW_SiteOpened
Anchor link toلمنصات الويب فقط
يتم إطلاق حدث SiteOpened في كل مرة يفتح فيها المستخدم أيًا من صفحات موقعك الإلكتروني.
سمات الحدث
- device_type (integer device type code, ارجع إلى registerDevice للتفاصيل)
- title – عنوان الصفحة التي تمت زيارتها
- url – عنوان URL للصفحة التي تمت زيارتها
حالات الاستخدام
- حلل توزيع حركة المرور على موقعك وقارن عدد المرات التي يفتح فيها المستخدمون صفحات معينة. للقيام بذلك، قم بتصفية إحصائيات الحدث حسب سماته.
- تابع زيارة المستخدم للموقع بتواصل ذي صلة: أنشئ رحلة تبدأ بحدث SiteOpened مُعد لسمة ‘title’ أو ‘url’ معينة.

PW_InAppPurchase
Anchor link toللتطبيقات المحمولة فقط
يتم إطلاق حدث InAppPurchase في كل مرة يشتري فيها المستخدم عنصرًا داخل التطبيق في تطبيقك. تشمل الأمثلة الاشتراكات المدفوعة، وعناصر ميكانيكا الألعاب، والعملة داخل التطبيق، إلخ.
لتنفيذ حدث الشراء داخل التطبيق:
- بالنسبة لنظام iOS:
- قم بتفعيل حدث PW_InAppPurchase في Control Panel الخاص بك؛
- اضبط معامل
Pushwoosh_PURCHASE_TRACKING_ENABLEDفي Pushwoosh iOS SDK على ‘yes’.
- بالنسبة لنظام Android:
- قم بتفعيل حدث PW_InAppPurchase في Control Panel الخاص بك؛
- قم بتهيئة إرسال معلومات الشراء إلى Pushwoosh باستخدام هذا الدليل.
سمات الحدث
- productIdentifier (يتم الحصول عليه من App Store)
- quantity – عدد العناصر المشتراة
- transactionDate – تاريخ الشراء
- status – حالة الشراء
حالات الاستخدام
- اجمع إحصائيات عمليات الشراء داخل التطبيق.
- قم بتشغيل عروض ترويجية وتتبع نجاحها: اضبط حدث Wait for Trigger بعد الرسالة الترويجية.

PW_NotificationOpen
Anchor link toللمنصات المحمولة والويب
يتم إطلاق هذا الحدث في كل مرة يفتح فيها المستخدم إشعارًا فوريًا تم إرساله باستخدام Pushwoosh.
حالات الاستخدام
- قم بتهيئة الوقت الأمثل لإرسال إشعار فوري.
- أنشئ Segments بناءً على أداء الإشعارات خلال فترة زمنية محددة.
PW_NotificationSend
Anchor link toللمنصات المحمولة والويب
يتم إطلاق هذا الحدث بمجرد إرسال رسالة Pushwoosh إلى جهاز المستخدم.
سمات الحدث
- message_id (string)
- message_code (string)
- campaign_id (string)
حالات الاستخدام
- تتبع ما إذا تم إرسال رسالة، بغض النظر عن القناة المستخدمة.
- أنشئ Segments للمستخدمين بناءً على عدد الرسائل المرسلة.
- اعرض جميع الرسائل المرسلة إلى مستخدم في Events history وحلل سلوك المستخدم اللاحق.
PW_EmailLinkClicked
Anchor link toلمنصة البريد الإلكتروني فقط
يتم إطلاق هذا الحدث في كل مرة ينقر فيها المستخدم على رابط في بريد إلكتروني.
سمات الحدث
- message_id (string)
- message_code (string)
- campaign_id (string)
- redirect_link (string)
- original_link (string)
حالات الاستخدام
- قم بتشغيل حملات مستهدفة للمستخدمين الذين ينقرون على رابط معين في بريد إلكتروني.
- أرسل رسالة أخرى للمستخدمين الذين تجاهلوا الرابط في البريد الإلكتروني الأول لتشجيعهم على النقر عليه (أو اتخاذ إجراء آخر).
PW_EmailOpen
Anchor link toيتم إطلاق هذا الحدث عندما يفتح المستخدم بريدًا إلكترونيًا تم إرساله عبر Pushwoosh.
سمات الحدث
- campaign_code (string): الرمز الفريد للحملة المرتبطة بالبريد الإلكتروني.
- campaign_id (string): معرف الحملة.
- message_code (string): المعرف الفريد لرسالة البريد الإلكتروني المحددة.
- message_id (string): معرف الرسالة.
حالات الاستخدام
- تتبع فتح رسائل البريد الإلكتروني لتحديد المستخدمين الذين يتفاعلون بنشاط مع رسائلك. استخدم هذه البيانات لإنشاء حملات متابعة، مثل إرسال أكواد خصم للمستخدمين الذين يفتحون رسائل البريد الإلكتروني الترويجية.
- إذا فتح المستخدمون بريدًا إلكترونيًا ولكن لم يكملوا الإجراء المطلوب (مثل إجراء عملية شراء)، يمكنك تشغيل رسائل بريد إلكتروني للمتابعة تحتوي على تذكيرات أو عروض مخصصة.
- حلل معدلات الفتح عبر الحملات لتحسين سطور الموضوع وتوقيت البريد الإلكتروني لحملات مثل إطلاق المنتجات أو العروض الموسمية.
PW_InAppShown
Anchor link toيتم إطلاق هذا الحدث عند عرض رسالة داخل التطبيق للمستخدم.
سمات الحدث
- message_code (string): المعرف الفريد للرسالة المحددة المرتبطة بالرسالة داخل التطبيق.
- message_id (integer): معرف الرسالة.
- campaign_code (string): الرمز الفريد للحملة المرتبطة بالرسالة داخل التطبيق.
- campaign_id (integer): معرف الحملة التي أدت إلى تشغيل الرسالة داخل التطبيق.
- rich_media_code (string): المعرف الفريد لمحتوى الوسائط الغنية المعروض في الرسالة داخل التطبيق.
- inapp_code (string): الرمز الفريد الذي يحدد الرسالة المحددة داخل التطبيق التي تم عرضها.
حالات الاستخدام
- تتبع تكرار مشاهدة الرسائل داخل التطبيق لضبط استراتيجية المراسلة الخاصة بك، مثل إزالة الرسائل الزائدة التي قد تزعج المستخدمين.
- استخدم بيانات مرات الظهور داخل التطبيق لتقييم مدى وصول الحملات الترويجية مثل المبيعات السريعة أو ترقيات الاشتراك.
- إذا تم عرض رسالة داخل التطبيق ولكن لم يتم النقر عليها، يمكنك تشغيل إجراء متابعة، مثل إرسال إشعار فوري بمحتوى مشابه لتعزيز الرسالة.
PW_InAppClicked
Anchor link toيتم إطلاق هذا الحدث عندما يتفاعل المستخدم مع رسالة داخل التطبيق عن طريق النقر عليها.
سمات الحدث
- message_code (string): المعرف الفريد للرسالة المحددة المرتبطة بالرسالة داخل التطبيق.
- message_id (integer): معرف الرسالة.
- campaign_code (string): الرمز الفريد للحملة المرتبطة بالرسالة داخل التطبيق.
- campaign_id (integer): معرف الحملة التي أدت إلى تشغيل الرسالة داخل التطبيق.
- rich_media_code (string): المعرف الفريد لمحتوى الوسائط الغنية المعروض في الرسالة داخل التطبيق (إن وجد).
- inapp_code (string): الرمز الفريد الذي يحدد الرسالة المحددة داخل التطبيق التي تم النقر عليها.
- element_id (string): معرف العنصر المحدد داخل الرسالة داخل التطبيق الذي تم النقر عليه (مثل زر أو رابط).
- link (string): عنوان URL أو الرابط العميق المرتبط بالعنصر الذي تم النقر عليه.
حالات الاستخدام
- حلل سلوك النقر لتحديد الأزرار أو الروابط التي يتفاعل معها المستخدمون في أغلب الأحيان وتحسين تصميمات الرسائل داخل التطبيق المستقبلية. على سبيل المثال، اختبر دعوات لاتخاذ إجراء مختلفة في حملات ترقية الاشتراك.
- قم بتشغيل إجراءات آلية بناءً على نقرات المستخدم، مثل إعادة توجيه المستخدمين إلى صفحة منتج معينة أو إرسال إشعار فوري.
PW_WhatsAppReceived
Anchor link toيتم إطلاق هذا الحدث عند استلام رسالة WhatsApp عبر النظام.
سمات الحدث
- message (string): محتوى أو معرف رسالة WhatsApp المستلمة.
حالات الاستخدام
- أتمتة إجراءات المتابعة استجابةً لرسائل WhatsApp الواردة (مثل بدء Customer Journey أو تتبع أحداث تفاعل المستخدم).
- قم بتقسيم المستخدمين بناءً على تفاعلاتهم مع رسائل WhatsApp لتمكين المراسلة المستهدفة أو الحملات المخصصة.