تسمية الأحداث

كم حدث بأسماء واضحة يجاوبون أكثر من مية حدث غامض. ابدأ بخمسة إلى ثمانية.

تتبّع النتائج اللي لها معنى

مشاهدات الصفحات والنقرات تنسجّل أصلًا. الأحداث المخصصة للأشياء اللي 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 })
}

لمسارات التحويل المبنية على هذي الأحداث، شوف مسارات التحويل والعودة.