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

الأحداث الافتراضية

ما هي الأحداث الافتراضية

Anchor link to

الأحداث الافتراضية (Default Events) هي تفاعلات أساسية يقوم بها المستخدمون في التطبيقات أو المواقع الإلكترونية بغض النظر عن صناعتها أو وظائفها. تشكل هذه الإجراءات الرئيسية للمستخدمين جوهر التواصل مع العملاء ويمكن الاستفادة منها لأي منتج وعميل في أي مرحلة من مراحل دورة حياة العميل.

الأحداث الافتراضية متاحة بشكل جاهز لإصدارات SDK المحدثة. لا تحتاج إلى إعدادات إضافية باستثناء PW_InAppPurchase (انظر التفاصيل أدناه).

للعثور على الأحداث الافتراضية المتاحة في Pushwoosh وتفعيلها، اتبع الخطوات التالية:

  1. انتقل إلى علامة التبويب Events داخل قسم Audience.
  2. انقر على Create Event.
  3. حدد Default Event من القائمة المنسدلة.
  4. في النافذة المنبثقة، اختر الحدث المطلوب وانقر على Activate.
قائمة منسدلة للأحداث الافتراضية تعرض الأحداث المتاحة للتفعيل

بمجرد تفعيلها، يمكن استخدام الأحداث الافتراضية في الرسائل القائمة على السلوك. على سبيل المثال، استخدمها كـ Trigger-based Entry في Customer Journey أو كمحفز لرسائل In-App.

PW_DeviceRegistered

Anchor link to

يتم إطلاق هذا الحدث (Event) مرة واحدة فقط لكل جهاز، عند تشغيل التطبيق لأول مرة وتهيئة SDK. كما يوحي الاسم، يتتبع هذا الحدث تسجيل الجهاز في تطبيقك.

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

  • أطلق حملة تعريفية للمستخدمين المسجلين حديثًا – أضف Trigger-based Entry باستخدام حدث PW_DeviceRegistered إلى Customer Journey تعريفية.
  • حدد أنشطة الاستحواذ التي تجلب لك المزيد من القادمين الجدد باستخدام إحصائيات الحدث.
  • أشرك المستخدمين مباشرة في زيارتهم الأولى: استقبلهم بـ In-Apps التي يتم تشغيلها بواسطة حدث DeviceRegistered.
رسالة In-App يتم تشغيلها بواسطة حدث 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 (رمز نوع الجهاز الصحيح، راجع registerDevice للتفاصيل)
  • application_version

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

  • اجمع إحصائيات الاحتفاظ بالمستخدمين بناءً على إحصائيات حدث ApplicationOpen.
  • قم بتشغيل حملات رسائل in-app للمستخدمين النشطين في التطبيق.

PW_ScreenOpen

Anchor link to

لتطبيقات الجوال فقط

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

سمات الحدث

  • application_version
  • device_type (رمز نوع الجهاز الصحيح، راجع registerDevice للتفاصيل)
  • screen_name (اسم الشاشة التقني الذي تم الحصول عليه من تطبيقك)

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

  • أرسل رسائل ذات صلة تامة للمستخدمين الذين أبدوا اهتمامهم بأقسام معينة في التطبيق عن طريق بدء Customer Journeys بحدث PW_ScreenOpen.
  • قم بتقييم وتحسين فعالية عروضك الترويجية: قم بـ A/B/n test لنسختين أو أكثر من عرضك، انتظر حدوث حدث ScreenOpen ثم انظر أي محتوى حقق أفضل أداء.
  • تعرف على شاشات التطبيق الأكثر زيارة: قم بتصفية إحصائيات الحدث حسب اسم الشاشة.
لوحة تحكم إحصائيات الحدث مفلترة حسب اسم الشاشة تعرض بيانات تفاعل المستخدم

PW_ApplicationMinimized

Anchor link to

لتطبيقات الجوال فقط

يتم إطلاق هذا الحدث عندما يقوم المستخدم بتصغير التطبيق (وليس إيقافه بالقوة) على جهازه.

سمات الحدث

  • device_type (رمز نوع الجهاز الصحيح، راجع registerDevice للتفاصيل)
  • application_version

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

  • تتبع متوسط وقت الجلسة بين أحداث ApplicationOpen و ApplicationMinimized.
  • أرسل إشعارات فورية أثناء تشغيل التطبيق في الخلفية لجذب انتباه المستخدمين وإعادتهم إلى التطبيق.

PW_SiteOpened

Anchor link to

لمنصات الويب فقط

يتم إطلاق حدث SiteOpened في كل مرة يفتح فيها المستخدم أيًا من صفحات موقعك الإلكتروني.

سمات الحدث

  • device_type (رمز نوع الجهاز الصحيح، راجع registerDevice للتفاصيل)
  • title – عنوان الصفحة التي تمت زيارتها
  • url – عنوان URL للصفحة التي تمت زيارتها

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

  • حلل توزيع حركة المرور على موقعك وقارن عدد المرات التي يفتح فيها المستخدمون صفحات معينة في الموقع. لهذا، قم بتصفية إحصائيات الحدث حسب سماته.
  • تابع زيارة المستخدم للموقع بتواصل ذي صلة: أنشئ رحلة تبدأ بحدث SiteOpened تم إعداده لسمة ‘title’ أو ‘url’ معينة.
تحليلات حركة مرور الموقع الإلكتروني تعرض إحصائيات زيارة الصفحات وأنماط سلوك المستخدم

PW_InAppPurchase

Anchor link to

لتطبيقات الجوال فقط

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

لتنفيذ حدث In-App Purchase:

  • لنظام iOS:
    • قم بتفعيل حدث PW_InAppPurchase في لوحة التحكم الخاصة بك؛
    • اضبط معامل Pushwoosh_PURCHASE_TRACKING_ENABLED لـ Pushwoosh iOS SDK على ‘yes’.
  • لنظام Android:
    • قم بتفعيل حدث PW_InAppPurchase في لوحة التحكم الخاصة بك؛
    • قم بتكوين إرسال معلومات الشراء إلى Pushwoosh باستخدام هذا الدليل.

سمات الحدث

  • productIdentifier (يتم الحصول عليه من متجر التطبيقات)
  • quantity – عدد العناصر المشتراة
  • transactionDate – تاريخ الشراء
  • status – حالة الشراء

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

  • اجمع إحصائيات عمليات الشراء داخل التطبيق.
  • قم بتشغيل عروض ترويجية وتتبع نجاحها: اضبط حدث Wait for Trigger بعد رسالة العرض الترويجي.
تكوين رحلة العميل يظهر خطوة الانتظار للمحفز مع حدث الشراء داخل التطبيق

PW_NotificationOpen

Anchor link to

لمنصات الجوال والويب

يتم إطلاق هذا الحدث في كل مرة يفتح فيها المستخدم إشعارًا فوريًا تم إرساله باستخدام Pushwoosh.

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

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

يتم إطلاق هذا الحدث عند عرض رسالة in-app للمستخدم.

سمات الحدث

  • message_code (string): المعرف الفريد للرسالة المحددة المرتبطة بـ in-app.
  • message_id (integer): معرف الرسالة.
  • campaign_code (string): الرمز الفريد للحملة المرتبطة بـ in-app.
  • campaign_id (integer): معرف الحملة التي أدت إلى تشغيل in-app.
  • rich_media_code (string): المعرف الفريد لمحتوى الوسائط الغنية المعروض في in-app.
  • inapp_code (string): الرمز الفريد الذي يحدد رسالة in-app المحددة التي تم عرضها.

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

  • تتبع تكرار مشاهدة رسائل in-app لضبط استراتيجية المراسلة الخاصة بك، مثل إزالة الرسائل الزائدة التي قد تزعج المستخدمين.
  • استخدم بيانات مرات ظهور in-app لتقييم مدى وصول الحملات الترويجية مثل المبيعات السريعة أو ترقيات الاشتراك.
  • إذا تم عرض رسالة in-app ولكن لم يتم النقر عليها، يمكنك تشغيل إجراء متابعة، مثل إرسال إشعار فوري بمحتوى مشابه لتعزيز الرسالة.

PW_InAppClicked

Anchor link to

يتم إطلاق هذا الحدث عندما يتفاعل المستخدم مع رسالة in-app عن طريق النقر عليها.

سمات الحدث

  • message_code (string): المعرف الفريد للرسالة المحددة المرتبطة بـ in-app.
  • message_id (integer): معرف الرسالة.
  • campaign_code (string): الرمز الفريد للحملة المرتبطة بـ in-app.
  • campaign_id (integer): معرف الحملة التي أدت إلى تشغيل in-app.
  • rich_media_code (string): المعرف الفريد لمحتوى الوسائط الغنية المعروض في in-app (إن وجد).
  • inapp_code (string): الرمز الفريد الذي يحدد رسالة in-app المحددة التي تم النقر عليها.
  • element_id (string): معرف العنصر المحدد داخل رسالة in-app الذي تم النقر عليه (مثل زر أو رابط).
  • link (string): عنوان URL أو الرابط العميق المرتبط بالعنصر الذي تم النقر عليه.

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

  • حلل سلوك النقر لتحديد الأزرار أو الروابط التي يتفاعل معها المستخدمون في أغلب الأحيان وتحسين تصميمات رسائل in-app المستقبلية. على سبيل المثال، اختبر دعوات لاتخاذ إجراء (CTAs) مختلفة في حملات ترقية الاشتراك.
  • قم بتشغيل إجراءات آلية بناءً على نقرات المستخدم، مثل إعادة توجيه المستخدمين إلى صفحة منتج معينة أو إرسال إشعار فوري.

PW_WhatsAppReceived

Anchor link to

يتم إطلاق هذا الحدث عند استلام رسالة WhatsApp عبر النظام.

سمات الحدث

  • message (string): محتوى أو معرف رسالة WhatsApp المستلمة.

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

  • أتمتة إجراءات المتابعة استجابةً لرسائل WhatsApp الواردة (مثل بدء Customer Journey أو تتبع أحداث تفاعل المستخدم).
  • قم بتقسيم المستخدمين بناءً على تفاعلاتهم مع رسائل WhatsApp لتمكين المراسلة المستهدفة أو الحملات المخصصة.