All docs
3 min read

Funnel analytics

Funnel analytics measure how visitors move through a published /u/{slug} flow. Events are recorded server-side in funnel_events, so the dashboard keeps working even when browser pixels are blocked by privacy tools or ad blockers.

Metrics

The analytics endpoint returns four groups:

Group Meaning
totals Sessions, completed sessions, conversion rate, and conversion value.
per_screen View, next, and drop counts for each screen, plus next_rate.
by_variant Sessions, conversions, and conversion rate for each A/B variant.
by_device Session counts grouped by detected device type.

A session starts when a visitor lands on the funnel. A conversion is counted when a form_collect screen creates the underlying form submission. If the funnel has no form_collect screen, use CTA and redirect events to evaluate intent instead of submission conversion rate.

Screen drop-off

Use per_screen to find the step that blocks progress:

  • A high view count with a low next_rate usually means the screen is asking for too much too early.
  • A drop after a pricing or qualification question can be intentional if the funnel is filtering out poor-fit leads.
  • A drop on the final collection screen often points to form field friction, unclear value exchange, or a validation issue.

When you change screen order, copy, field requirements, or branching rules, compare analytics from before and after the edit. Screen edits clear the funnel analytics cache so the dashboard refreshes with the new structure.

Variants

When A/B testing is enabled, every session is assigned a deterministic variant. The by_variant section compares traffic and conversions for each variant key. Do not judge a variant from conversion rate alone if the session count is still small; first verify that the split is receiving enough traffic and that each variant reaches the same conversion goal.

Freshness

Aggregations are cached for five minutes per funnel. Event collection is immediate, but dashboard totals can trail recent traffic until the cache expires or a screen edit busts it. If numbers look stale after a campaign launch, wait for the cache window before assuming events are missing.

Troubleshooting

If analytics look empty, check that the funnel has been published and that you are viewing the funnel URL rather than only previewing screens inside the dashboard. For submission-based conversion, confirm the flow contains a form_collect screen and that the underlying form accepts the submitted payload. For advertising reports, compare server-side funnel totals with GA4, GTM, Meta Pixel, or TikTok Pixel data because each vendor can filter or sample traffic differently.