Funnels & conversion

How do I track onboarding drop-off in my app? Call OnRamp.step('milestone_name') at each meaningful moment, then define an ordered funnel in the dashboard. OnRamp shows the conversion rate and absolute user count at every step, highlights the biggest drop-off in red, and charts daily conversion over time.

Funnels are the core of OnRamp. They show you how many users reach each step of your onboarding and exactly where they drop off.


Defining a funnel

Go to Dashboard → Funnel → New funnel. Add steps in order, using the exact same string names you pass to OnRamp.step().

A good onboarding funnel:

app_opened → signup_started → account_created → profile_setup → first_action

Steps are matched globally across all sessions in the selected date range. A user who completes step 1 on Monday and step 2 on Thursday is still counted as converted.


Reading the funnel

The funnel detail page shows:

  • Step-by-step ribbon - proportional volume at each step, with drop-off percentages between steps
  • Worst drop-off - highlighted in red - the single biggest opportunity
  • Users at each step - absolute unique user count

Trend chart

Above the funnel ribbon, a trend chart shows daily values for selected metrics. By default it shows Unique visitors and Conversion rate. Click any metric card to toggle it on or off.

Built-in metrics

MetricDescription
Unique visitorsDistinct users who entered the first step
Conversion rate% who reached the last step
Avg session timeMean session duration across all sessions
Online nowUsers active in the last 5 minutes (not plottable - card only)

Custom metrics

Any numeric property you attach to a step event can be added to the chart. Click + in the metric card row and pick a property and aggregation (Sum or Average).

ts
// Track a numeric property on a step
OnRamp.step('payment_completed', {
  properties: { amount_cents: 999 },
})

Then add amount_cents as a custom metric in the chart to see daily total or average payment value.


Segments

Drop-off cards at the bottom of each step show breakdowns by:

  • OS version - iOS 17 vs iOS 16, Android 14 vs 13
  • App version - spot regressions in specific releases
  • Device type - phone vs tablet

These segments help you rule out platform-specific bugs as a cause of sudden drop-off.


Multiple funnels

You can define as many funnels as you need - one per user segment, one per onboarding variant, etc. The funnel list page shows conversion rate and last-event date for each.

Start with a single end-to-end funnel before creating segment-specific ones. Knowing your overall baseline makes it easier to spot meaningful differences when you slice by cohort.