Kordant/tasks/web-production/26-analytics.md

26. Analytics Integration (Plausible/PostHog)

meta: id: web-production-26 feature: web-production priority: P2 depends_on: [] tags: [analytics, marketing, production]

objective:

• Implement privacy-respecting analytics to understand user behavior and measure conversion funnels

deliverables:

• Analytics tracking setup
• Custom event tracking for key actions
• Conversion funnel measurement
• Dashboard for key metrics

steps:

1. Set up analytics platform:
   • Choose: Plausible (privacy-first, simple) or PostHog (powerful, self-hostable)
   • Create account and add tracking script
   • Configure domain and goals
2. Add tracking to app:
   • Add script to web/src/entry-client.tsx or layout
   • Respect cookie consent (load only after opt-in)
   • Respect Do Not Track
   • Exclude admin traffic
3. Track page views:
   • All public pages
   • Dashboard pages (anonymized)
   • Blog post reads
4. Track custom events:
   • signup_started, signup_completed
   • login, logout
   • subscription_started, subscription_completed
   • darkwatch_scan_initiated
   • alert_viewed, alert_resolved
   • feature_page_viewed (voiceprint, spamshield, etc.)
5. Create conversion funnels:
   • Landing → Signup → Onboarding → Dashboard
   • Dashboard → Pricing → Checkout → Subscription
   • Blog → Signup (content marketing ROI)
6. Set up dashboards:
   • Daily/weekly active users
   • Signup conversion rate
   • Subscription conversion rate
   • Feature adoption (DarkWatch, VoicePrint, etc.)
   • Churn rate
   • Revenue metrics (via Stripe integration)
7. Add A/B testing foundation:
   • PostHog feature flags or Split.io
   • Test landing page variants
   • Test pricing page variants

tests:

• Integration: Verify events fire correctly
• Privacy: Confirm no PII in analytics payload
• Consent: Test analytics blocked until cookie consent

acceptance_criteria:

• Analytics tracking active on all public pages
• Custom events firing for signup, login, subscription, key features
• Conversion funnels visible in dashboard
• No PII (names, emails, IDs) sent to analytics
• Analytics loads only after cookie consent (if required)
• Admin pages excluded from tracking
• Daily active users metric available
• Subscription conversion rate tracked
• A/B testing framework ready for use

validation:

• Visit landing page → pageview event in analytics
• Sign up → signup_completed event with funnel progression
• Check analytics dashboard → conversion rates visible
• Inspect network tab → no email addresses in payload
• Reject cookies → analytics script not loaded

notes:

• Plausible is GDPR-compliant without cookie consent banner
• PostHog offers more features but requires consent in EU
• Consider self-hosting Plausible for complete data control
• Stripe can send revenue data to analytics automatically