تسمية الأحداث
كم حدث بأسماء واضحة يجاوبون أكثر من مية حدث غامض. ابدأ بخمسة إلى ثمانية.
تتبّع النتائج اللي لها معنى
مشاهدات الصفحات والنقرات تنسجّل أصلًا. الأحداث المخصصة للأشياء اللي datacub ما يقدر يشوفها: إن شيء نجح فعلًا. أحداث أولى مناسبة لأغلب المنتجات:
| الحدث | متى ينطلق | الخصائص |
|---|---|---|
signup_completed | تم إنشاء الحساب | method |
onboarding_step_completed | كل خطوة في التهيئة، كحدث واحد | step |
project_created | أول لحظة يستفيد فيها المستخدم (عندك ممكن تكون غير) | template |
checkout_completed | السيرفر أكّد الدفع | plan، currency، value |
subscription_started، subscription_cancelled | الاشتراك تغيّر | plan |
invite_sent | انرسلت دعوة لعضو فريق | role |
القواعد
object_actionبحروف صغيرة وبصيغة الماضي:invoice_paid،report_exported. موClicked Pay ButtonولاpaymentSuccess.- حدث واحد مع خاصية أحسن من أحداث كثيرة:
onboarding_step_completedمع{ step: 'profile' }، موonboarding_profile_doneوonboarding_team_done. - الأسماء ما تتغيّر: الحدث اللي يتغيّر اسمه يصير حدث جديد، والرسوم القديمة ما تطابقه. اختر بعناية، وبعدها اثبت عليه.
- لا قيم في الأسماء: أبد لا تسوي
plan_pro_selectedأو اسم فيه معرّف. القيم مكانها الخصائص. - الخصائص قليلة ومسطحة ومتكررة: أسماء الباقات، الخطوات، الأعداد، true أو false. مو نص حر، ولا مين هو المستخدم.
- الأسماء بالإنجليزي، والواجهة بأي لغة: الأسماء لفريقك ولكودك، والتقارير تعرضها زي ما كتبتها.
// one event, the step as a property
datacub.track('onboarding_step_completed', { step: 'profile' })
datacub.track('onboarding_step_completed', { step: 'invite_team' })وين تحط الاستدعاء
جنب الكود اللي ينفّذ الإجراء، بعد ما ينجح. كذا يبقى الحدث صحيح حتى لو انتقل الزر، أو تغيّر النص، أو صارت شاشة ثانية تسوي نفس الشيء.
export async function inviteTeammate(email: string, role: 'admin' | 'member') {
await api.createInvite({ email, role })
// the email stays in your system; datacub only needs the fact
datacub.track('invite_sent', { role })
}لمسارات التحويل المبنية على هذي الأحداث، شوف مسارات التحويل والعودة.