Files
freno-dev/marketing/metrics/weekly.md
Paperclip Agent 39d874a7e2 analytics: make each weekly funnel stage separately measurable (FRE-366)
Gap 1 — click and served share one label: trackDownload now takes a
stage ("click" | "served") carried on a new VisitorAnalytics.stage
column; the Nook door and the tRPC proxy record clicks, the DMG file
route records served. summariseDownloads() and the /analytics downloads
block are untouched — the stage is a separate column, so the path
grouping cannot change.

Gap 2 — checkout start records nothing: the checkout route records a
created Stripe session through the shared trackRequest writer (same
referrer, campaign, country dimensions as every door) under its own
path, and STAGES.checkout reads it instead of the /checkout page proxy.

Gap 3 — loopback addresses, no host dimension: every writer now
resolves the client address through resolveClientIp, which trusts
x-forwarded-for only when the direct peer is the loopback production
proxy (trust boundary stated in request-client.ts), and records the
host on each row through the same site-context extractor routing uses.
stage and host reach the table through VISITOR_ANALYTICS_ADDED_COLUMNS;
the weekly job applies the same bootstrap before reading so it renders
seven stages against a database no deploy has migrated yet.

The weekly read splits downloadClick/dmgServed, scopes visits to
nook.freno.me, and computes its caveats from the window: pre-instrumentation
rows are stated and excluded, and the loopback warning now fires only
when rows recorded since the instrumentation still carry it.
2026-10-29 17:02:39 +00:00

2.1 KiB
Raw Blame History

Weekly funnel snapshot

Window: 2026-10-22 17:01:33 → 2026-10-29 17:01:33 UTC (7 days). Previous: 2026-10-15 17:01:33 → 2026-10-22 17:01:33 UTC.

Generated by bun --env-file=.env scripts/weekly-metrics.ts; regenerated weekly, never hand-edited. The analysis is the CMO's.

Funnel

Stage This week Last week Change
visit (nook.freno.me page views) 0 0 0
download click 0 0 0
DMG served 0 0 0
trial started 2 0 +2
checkout started (Stripe session) 0 0 0
purchase (licence issued) 0 0 0
activation 0 0 0

Campaigns

Top 10 by volume, untagged excluded — the same grouping getAnalyticsSummary.topCampaigns returns.

Source Medium Campaign Rows
x — — 1

1 of 291 rows in the window carry campaign tags; the rest are untagged and therefore unattributed.

The one thing that moved

trial started: 0 → 2 (+2).

Before acting on these numbers

  • 291 of 291 rows in the window predate the FRE-366 instrumentation. They carry no host, and their recorded address is the production proxy's loopback (127.0.0.1 / ::1) — the writers then recorded the direct peer, not the visitor. They are excluded from every host-scoped stage above (visits, and the download click/served split), and "unique visitors" over them still collapses to one host. Rows recorded since carry the real client address and the site they addressed.
  • Download rows are automation-heavy. Of this window's 137 download rows, 0 are clicks and 0 are served files; the remaining 137 predate the click/served stage label and cannot be split, so they count in neither stage. 112 of all 137 are not browser user agents (curl, Sparkle, link-preview crawlers).
  • No conversion rate before the cohort matures. Trial→paid belongs to the mature Day 28–35 read (FRE-197); a ratio from a partial cohort is not a metric.

Sources

  • VisitorAnalytics (freno.me Turso DB) — visits, downloads, campaigns.
  • trials, licenses, activations (the-nook Turso DB) — the paid funnel.
  • Generated 2026-10-29T17:01:33Z.