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

ملاحظة

متوفر بدءًا من SDK 5.2.2

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

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

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

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

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

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

نصيحة

لمعرفة كيف يمكنك استخدام الأحداث الافتراضية لإنشاء حملة تسويقية في Pushwoosh وتحويل المستخدمين المجانيين تلقائيًا إلى عملاء مدفوعين، شاهد هذا الفيديو التعليمي:

فيديو يوتيوب: كيف يمكنك استخدام الأحداث الافتراضية لإنشاء حملة تسويقية في Pushwoosh وتحويل المستخدمين المجانيين تلقائيًا إلى عملاء مدفوعين

استخدام الجهاز والتطبيق

PW_DeviceRegistered

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

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

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

PW_DeviceUnregistered

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

سمات الحدث

• message_id (string)
• message_code (string)
• campaign_id (string)

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

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

PW_ApplicationOpen

للتطبيقات المحمولة فقط

يتم تشغيل حدث ApplicationOpen في كل مرة يفتح فيها المستخدم تطبيقك المحمول على جهازه.

سمات الحدث

• device_type (integer): رمز نوع الجهاز. ارجع إلى registerDevice للحصول على التفاصيل.
• application_version (string): إصدار التطبيق.

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

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

PW_ScreenOpen

للتطبيقات المحمولة فقط

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

سمات الحدث

• application_version (string): إصدار التطبيق.
• device_type (integer): رمز نوع الجهاز. ارجع إلى registerDevice للحصول على التفاصيل.
• screen_name (string): الاسم التقني للشاشة الذي تم الحصول عليه من تطبيقك.

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

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

PW_ApplicationMinimized

للتطبيقات المحمولة فقط

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

سمات الحدث

• device_type (integer): رمز نوع الجهاز. ارجع إلى registerDevice للحصول على التفاصيل.
• application_version (string): إصدار التطبيق.

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

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

PW_UserIdle

للتطبيقات المحمولة فقط

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

لبدء تلقي أحداث PW_UserIdle، ستحتاج إلى مساعدة من فريق المطورين لديك. شارك ملاحظات إعداد SDK أدناه.

يتم إطلاق هذا الحدث عندما يكون المستخدم داخل تطبيقك ولكنه لم يتفاعل مع الشاشة لفترة قابلة للتكوين. على عكس PW_ApplicationMinimized، الذي يتم تشغيله بعد مغادرة المستخدم للتطبيق، يتم إطلاق PW_UserIdle بينما لا يزال المستخدم في التطبيق. يلتقط اللحظة التي ينخفض فيها الانتباه، أو يتردد المستخدم، أو يتشتت انتباهه. استخدمه كإشارة من جانب الخادم لعرض رسالة In-App في الوقت المناسب، أو تقديم المساعدة، أو حث المستخدم على اتخاذ الخطوة التالية.

يتم تعطيل اكتشاف الخمول افتراضيًا على كلا النظامين. عندما يكون مفتاح المهلة مفقودًا أو مضبوطًا على 0، لا يتم إرسال أي أحداث PW_UserIdle. لتمكينه، قم بتعيين المهلة (30 ثانية كحد أدنى) في تكوين منصة تطبيقك:

• iOS: أضف مفتاح Pushwoosh_IDLE_TIMEOUT_SECONDS (رقم، 30 كحد أدنى) إلى Info.plist الخاص بتطبيقك.
• Android: أضف بيانات التعريف com.pushwoosh.idle_timeout_seconds (عدد صحيح، 30 كحد أدنى) إلى AndroidManifest.xml الخاص بك.

سمات الحدث

• screen_name (string): الشاشة التي أصبح المستخدم خاملاً فيها. على Android، يتم تنسيقها كـ ActivityName/FragmentName عندما تكون الشاشة الحالية متداخلة. وإلا، اسم النشاط. على iOS، يتم تنسيقها كـ ParentVC/ChildVC عند التداخل. وإلا، اسم وحدة التحكم في العرض.
• idle_seconds (integer): مهلة الخمول المكونة التي انقضت.
• session_duration (integer): الثواني منذ آخر مرة تم فيها إحضار التطبيق إلى المقدمة.
• device_type (integer): رمز نوع الجهاز. ارجع إلى registerDevice للحصول على التفاصيل.
• application_version (string): إصدار التطبيق.

السلوك

• يتم إطلاقه مرة واحدة على الأكثر لكل جلسة في المقدمة. العودة إلى الخلفية والعودة إلى المقدمة تبدأ جلسة جديدة.
• يتوقف المؤقت تلقائيًا أثناء فتح لوحة المفاتيح اللينة، وأثناء وجود مربع حوار مشروط أو مطالبة نظام على الشاشة، وأثناء وجود التطبيق في الخلفية.
• التفاعل المادي مع الشاشة (اللمس، التمرير، والكتابة) يعيد ضبط المؤقت.

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

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

PW_ApplicationExit

للتطبيقات المحمولة فقط

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

لبدء تلقي أحداث PW_ApplicationExit، ستحتاج إلى مساعدة من فريق المطورين لديك. شارك ملاحظات إعداد SDK أدناه.

يتم إطلاق هذا الحدث عندما يقوم المستخدم بوضع التطبيق في الخلفية ولا يعود خلال مهلة قابلة للتكوين. على عكس PW_ApplicationMinimized، الذي يتم إطلاقه فور مغادرة المستخدم، يتم إطلاق PW_ApplicationExit فقط بعد انقضاء التأخير المكون. يؤكد أن المستخدم قد غادر الجلسة بالفعل بدلاً من التبديل بين التطبيقات لفترة وجيزة. استخدمه لإعادة إشراك المستخدمين الذين تخلوا عن جلسة في منتصفها، أو لتشغيل حملات متابعة بعد خروج مؤكد.

يتم تعطيل اكتشاف نية الخروج افتراضيًا. لتمكينه، قم بتعيين المهلة (10-30 ثانية، يتم تقييد القيم خارج هذا النطاق تلقائيًا) في تكوين منصة تطبيقك:

• Android: أضف بيانات التعريف com.pushwoosh.exit_intent_timeout_seconds (عدد صحيح، 10-30) إلى AndroidManifest.xml الخاص بك.
• iOS: أضف مفتاح Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS (رقم، 10-30) إلى Info.plist الخاص بتطبيقك.

سمات الحدث

• screen_name (string): آخر شاشة نشطة عندما قام المستخدم بوضع التطبيق في الخلفية.
• session_duration (integer): الثواني منذ آخر مرة تم فيها إحضار التطبيق إلى المقدمة.
• exit_intent_seconds (integer): المهلة الفعلية التي انقضت قبل إطلاق الحدث (10-30 ثانية).
• device_type (integer): رمز نوع الجهاز. ارجع إلى registerDevice للحصول على التفاصيل.
• application_version (string): إصدار التطبيق.

السلوك

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

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

• أعد إشراك المستخدمين الذين تخلوا عن عملية شراء أو تسجيل. قم بتشغيل إشعار فوري أو بريد إلكتروني مع تذكير أو خصم.
• ابدأ Customer Journey لاستعادة المستخدمين الذين يخرجون دون إكمال إجراء رئيسي (على سبيل المثال، ترك عربة التسوق أو التوقف في منتصف عملية التعريف).
• حدد الشاشات ذات معدل التخلي المرتفع عن طريق تصفية إحصائيات الأحداث حسب screen_name.

الويب

PW_SiteOpened

للوeb فقط

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

سمات الحدث

• device_type (integer): رمز نوع الجهاز. ارجع إلى registerDevice للحصول على التفاصيل.
• title (string): عنوان الصفحة التي تمت زيارتها.
• url (string): عنوان URL للصفحة التي تمت زيارتها.

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

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

التجارة

PW_InAppPurchase

للتطبيقات المحمولة فقط

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

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

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

ملاحظة

يرجى الأخذ في الاعتبار أنه يجب تحديد هذه العناصر في صفحة App Store الخاصة بتطبيقك.

لتنفيذ حدث الشراء داخل التطبيق:

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

سمات الحدث

• productIdentifier (string): يتم الحصول عليه من App Store.
• quantity (integer): عدد العناصر المشتراة.
• transactionDate (string): تاريخ الشراء.
• status (string): حالة الشراء.

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

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

الإشعارات الفورية

PW_NotificationSend

للمحمول والويب فقط

يتم إطلاق هذا الحدث بمجرد إرسال رسالة Pushwoosh إلى جهاز المستخدم.

سمات الحدث

• message_id (string)
• message_code (string)
• campaign_id (string)

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

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

PW_NotificationOpen

للمحمول والويب فقط

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

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

• قم بتكوين الوقت الأمثل لإرسال إشعار فوري.
• أنشئ شرائح بناءً على أداء الإشعارات خلال فترة زمنية محددة.

البريد الإلكتروني

PW_EmailSent

للبريد الإلكتروني فقط

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

سمات الحدث

• message_id (string): معرف الرسالة.
• message_code (string): المعرف الفريد لرسالة البريد الإلكتروني المحددة.
• status_code (integer): رمز حالة التسليم الذي تم إرجاعه من مزود البريد الإلكتروني لمحاولة الإرسال هذه.
• campaign_id (string): معرف الحملة. يتم تضمينه فقط إذا تم إرسال البريد الإلكتروني كجزء من حملة.
• campaign_code (string): الرمز الفريد للحملة. يتم تضمينه عندما يكون الإرسال جزءًا من حملة وينجح البحث عن الحملة. قد يكون campaign_code مفقودًا حتى عندما يكون campaign_id موجودًا.

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

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

PW_EmailOpen

للبريد الإلكتروني فقط

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

سمات الحدث

• campaign_code (string): الرمز الفريد للحملة المرتبطة بالبريد الإلكتروني.
• campaign_id (string): معرف الحملة.
• message_code (string): المعرف الفريد لرسالة البريد الإلكتروني المحددة.
• message_id (string): معرف الرسالة.
• opened_by (string): من أو ما الذي أدى إلى الفتح: user لفتح حقيقي من قبل المستلم، أو ampp لفتح آلي تم تشغيله بواسطة حماية خصوصية بريد Apple التي تجلب بكسل التتبع مسبقًا.

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

• تتبع فتح البريد الإلكتروني لتحديد المستخدمين الذين يتفاعلون بنشاط مع رسائلك الإلكترونية. استخدم هذه البيانات لإنشاء حملات متابعة، مثل إرسال أكواد خصم للمستخدمين الذين يفتحون رسائل البريد الإلكتروني الترويجية.
• إذا فتح المستخدمون بريدًا إلكترونيًا ولكن لم يكملوا الإجراء المطلوب (على سبيل المثال، إجراء عملية شراء)، يمكنك تشغيل رسائل بريد إلكتروني للمتابعة مع تذكيرات أو عروض مخصصة.
• حلل معدلات الفتح عبر الحملات لتحسين سطور الموضوع واستراتيجيات توقيت البريد الإلكتروني لحملات مثل إطلاق المنتجات أو العروض الترويجية الموسمية.
• أنشئ شريحة بناءً على PW_EmailOpen مع opened_by يساوي user لاستهداف المستلمين الذين فتحوا البريد الإلكتروني، باستثناء الفتحات التي تم تشغيلها بواسطة AMPP.

PW_EmailLinkClicked

للبريد الإلكتروني فقط

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

سمات الحدث

• message_id (string)
• message_code (string)
• campaign_id (string)
• redirect_link (string)
• original_link (string)

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

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

رسائل داخل التطبيق

PW_InAppShown

للتطبيقات المحمولة فقط

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

سمات الحدث

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

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

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

PW_InAppClicked

للتطبيقات المحمولة فقط

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

سمات الحدث

• 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 أو الرابط العميق المرتبط بالعنصر الذي تم النقر عليه.

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

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

الرسائل القصيرة (SMS)

PW_SMSSent

للرسائل القصيرة فقط

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

سمات الحدث

• message_id (string): معرف الرسالة.
• message_code (string): المعرف الفريد لرسالة SMS المحددة.
• status_code (integer): رمز حالة التسليم الذي تم إرجاعه من مزود الرسائل القصيرة لمحاولة الإرسال هذه. استخدمه للتمييز بين النجاح والفشل.
• campaign_id (string): معرف الحملة. يتم تضمينه فقط إذا تم إرسال الرسالة القصيرة كجزء من حملة.
• campaign_code (string): الرمز الفريد للحملة. يتم تضمينه عندما يكون الإرسال جزءًا من حملة وينجح البحث عن الحملة. قد يكون campaign_code مفقودًا حتى عندما يكون campaign_id موجودًا.

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

• تتبع نتائج الإرسال باستخدام status_code، بغض النظر عن القناة المستخدمة في مكان آخر في نفس الرحلة.
• أنشئ شرائح مستخدمين بناءً على عدد رسائل SMS المرسلة.
• اعرض جميع رسائل SMS المرسلة إلى مستخدم في سجل الأحداث وحلل سلوك المستخدم الإضافي.

واتساب

PW_WhatsAppSent

لواتساب فقط

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

سمات الحدث

• message_id (string): معرف الرسالة.
• message_code (string): المعرف الفريد لرسالة واتساب المحددة.
• status_code (integer): رمز حالة التسليم الذي تم إرجاعه من مزود واتساب لمحاولة الإرسال هذه. استخدمه للتمييز بين النجاح والفشل.
• campaign_id (string): معرف الحملة. يتم تضمينه فقط إذا تم إرسال رسالة واتساب كجزء من حملة.
• campaign_code (string): الرمز الفريد للحملة. يتم تضمينه عندما يكون الإرسال جزءًا من حملة وينجح البحث عن الحملة. قد يكون campaign_code مفقودًا حتى عندما يكون campaign_id موجودًا.

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

• تتبع نتائج الإرسال باستخدام status_code، بشكل منفصل عن حالة التسليم أو القراءة.
• أنشئ شرائح مستخدمين بناءً على عدد رسائل واتساب المرسلة.
• اعرض جميع رسائل واتساب المرسلة إلى مستخدم في سجل الأحداث وحلل سلوك المستخدم الإضافي.

PW_WhatsAppReceived

لواتساب فقط

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

سمات الحدث

• message (string): محتوى الرسالة المستلمة. بالنسبة لرسائل الموقع، تحتوي على الإحداثيات بتنسيق "latitude,longitude" (على سبيل المثال، "55.751244,37.618423").
• latitude (number): خط عرض الموقع المشترك. يتم تضمينه فقط عندما يشارك المستخدم موقعه الحالي.
• longitude (number): خط طول الموقع المشترك. يتم تضمينه فقط عندما يشارك المستخدم موقعه الحالي.

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

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