Funnel

Analytics → Funnel (/analytics/funnel) is the acquire-to-monetize funnel. It tells you where users leak between first exposure and second purchase.

The 5 steps

preview_view  →  ep1_start  →  paywall_hit  →  unlock  →  repeat_unlock

Step	Event	Meaning
1. Preview view	`preview_reel_view`	User saw the hero preview reel.
2. Ep1 start	`episode_watch_start` (ep 1)	User pressed play on the first episode.
3. Paywall hit	`paywall_show`	User reached an unlock prompt (usually ep 4).
4. Unlock	`episode_unlock`	User paid coins to unlock an episode.
5. Repeat unlock	2nd `episode_unlock` for same user	User unlocked at least one more time.

Reading the funnel

Each step shows:

Absolute count (users who reached this step)
% of previous step (conversion rate)
% of top of funnel (cumulative)

Typical healthy conversions:

Step	Conversion
Preview → Ep1 start	30–50% (some users just browse)
Ep1 start → Paywall hit	15–30% (many drop before ep 4)
Paywall hit → Unlock	8–20% (this is the money step)
Unlock → Repeat unlock	40–70% (once they pay, they usually pay again)

Filters

Date range
Market
Install cohort (users who installed in a specific window: best for A/B analysis)

Where the data comes from

Rollup: rollup_funnel_daily (day, country, previews, ep1_starts, paywall_hits, unlocks, repeat_unlocks) built by rollups-hourly cron.
Raw drilldown: analytics_event with the 5 event allowlist above.

Optimizing each step

Preview → Ep1: improve the hero reel picks and thumbnails.
Ep1 → Paywall: the first 3 episodes must hook. If drop-off is at ep 2, that episode is bad.
Paywall → Unlock: pricing (market override) and paywall design lever.
Unlock → Repeat: the series must earn a second unlock. If it doesn’t, the hook was fake.

Gotchas

Guest users can complete the funnel: a device-keyed user hits paywall and unlocks. Their subsequent signup preserves everything.
Multi-day funnels: a user might preview today, unlock tomorrow. The rollup attributes each event to its own day; funnel view uses a 7-day sliding attribution window by default (configurable).
Duplicate events: the mobile client deduplicates on the way in (event_id + client_dedup_key). Server-side idempotency is on client_dedup_key.

API call

Action	Endpoint
Funnel data	`GET /v1/admin/analytics/funnel`

Full details in API: Analytics.