كيفية إعداد الأحداث

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

بمجرد جمع هذه البيانات بشكل صحيح، يمكن استخدامها في:

إطلاق رسائل قائمة على السلوك؛
تعديل تدفق تواصل المستخدم ضمن Customer Journey بناءً على سلوكهم؛
بناء شرائح من المستخدمين الذين يقومون بإجراء معين في التطبيق؛
الحصول على رؤى حول تدفق المستخدم ومقاييس الاستخدام والبيانات الإحصائية الأخرى.

أنواع الأحداث

هناك نوعان من الأحداث في Pushwoosh:

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

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

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

تعرف على المزيد حول الأحداث الافتراضية (Default Events)

الأحداث المخصصة

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

تتطلب الأحداث المخصصة (Custom Events) منك تنفيذها من جانبك.

تنفيذ الأحداث المخصصة

1. إنشاء الأحداث وتعيين السمات

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

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

2. استدعاء واجهة برمجة التطبيقات /postEvent

عندما يقع حدث تود تتبعه في تطبيقك، استدعِ واجهة برمجة التطبيقات /postEvent لإرسال هذا الحدث إلى Pushwoosh.

iOS

استدعِ postEvent لإرسال حدث إلى Pushwoosh:

Swift
Objective-C

PWInAppManager.shared().postEvent("eventName", withAttributes: nil)

[[PushNotificationManager pushManager] postEvent:@“eventName” withAttributes:@{}];

لإضافة تفاصيل حول الحدث (بالإشارة إلى السمات)، استخدم معامل السمات على النحو التالي:

Swift
Objective-C

let attributes: [String : Any] = ["AttributedString" : "someString",
                                  "AttributeInt" : 42,
                                  "AttributeList" : [123, 456, "someString"],
                                  "AttributeBool" : true,
                                  "AttributeDate" : NSDate()]

PWInAppManager.shared().postEvent("eventName", withAttributes: attributes)

NSDictionary *attributes = @{
  @"AttributeString" : @"someString",
  @"AttributeInt" : @(42),
  @"AttributeList" : @[ @(123), @(456), @"someString" ],
  @"AttributeBool" : @YES,
  @"AttributeDate" : [NSDate date]
};

[[PushNotificationManager pushManager] postEvent:@“eventName” withAttributes:attributes];

Android

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

استدعِ postEvent لإرسال حدث إلى Pushwoosh:

PushwooshInApp.getInstance().postEvent("eventName");

لإضافة تفاصيل حول الحدث (بالإشارة إلى السمات)، استخدم معامل السمات على النحو التالي:

TagsBundle attributes = new TagsBundle.Builder()
        .putInt("AttributeInt", 17)
        .putString("AttributeString", "str")
        .putDate("AttributeDate", new Date())
        .putBoolean("AttributeBool", true)
        .putList("AttributeList", Arrays.asList("item1", "item2", "item3"))
        .build();

PushwooshInApp.getInstance().postEvent("eventName", attributes);