Event taxonomy

A stable taxonomy prevents fragmented dashboards and broken comparisons over time.

  • Prefer snake_case event names (for example onboarding_step_complete).
  • Keep event names action-focused and past-tense where possible.
  • Use consistent property keys (for example always plan_id, not mixed planId/plan).
  • Version intentionally: add new events/properties instead of silently changing semantics.
Practical baseline: keep a short “event contract” doc in your repo and require product+engineering review for taxonomy changes.

Next step

Continue to Overview KPIs to map taxonomy quality to reporting quality.