Funnels

A funnel is an ordered sequence of registered metrics with a mandatory goal.

Defining one#

define_funnel({
  key: "activation",
  name: "New user activation",
  goal: "Take a new signup to their first export within 14 days",
  steps: [
    { metric_key: "signup", label: "Signed up" },
    { metric_key: "first_export", label: "First export" }
  ],
  window_seconds: 1209600
})

Why steps are metrics, not events#

Steps reference registry metric keys, never raw event names. So the funnel inherits each step's purpose: the insight layer knows not just "conversion 2→3 dropped" but "conversion into activation dropped, whose goal is X".

The window#

window_seconds is anchored at the first step. Match it to the journey — activation: 1–14 days; purchase: hours.