Michael Freno
b1cfce3661
- Documents existing Mixpanel implementation - Full event taxonomy from shared-analytics package - Frontend integration via useAnalytics hook - Required actions for Mixpanel account setup
1.9 KiB
1.9 KiB
ShieldAI Mixpanel Analytics Configuration
Current Implementation Status
✅ Already Implemented:
Backend (packages/shared-analytics)
- Full MixpanelService with Segment analytics integration
- Event taxonomy defined in
EventTypeenum:- User events:
user_signed_up,user_logged_in,user_upgraded, etc. - Subscription events:
subscription_created,subscription_cancelled, etc. - Product-specific events: DarkWatch, VoicePrint, SpamShield events
- User events:
- User identification and group tracking
- KPI definitions (MAU, MRR, conversion rate, churn, etc.)
Frontend (packages/web)
- Analytics hook (
useAnalytics.ts) with:- Mixpanel initialization via
VITE_MIXPANEL_TOKEN - Event tracking (
trackEvent) - Page view tracking (
trackPageView) - Waitlist signup tracking (
trackWaitlistSignup)
- Mixpanel initialization via
- GA4, Meta Pixel, and LinkedIn Insight integration
Required Actions
1. Create Mixpanel Project (Manual - Requires Account)
- Sign up for Mixpanel at https://mixpanel.com
- Create project: "ShieldAI"
- Get project token from Project Settings → Project Token
2. Configure Environment Variables
# Backend (.env)
MIXPANEL_TOKEN=<your-mixpanel-token>
MIXPANEL_API_SECRET=<optional-api-secret>
# Frontend (.env)
VITE_MIXPANEL_TOKEN=<your-mixpanel-token>
3. Event Taxonomy Documentation
See packages/shared-analytics/src/config/analytics.config.ts for full event definitions.
4. User Property Definitions
Standard properties tracked:
userId: User identifiersessionId: Session identifierplatform: web, mobile, desktop, apiversion: App versionenvironment: development, production, staging
Integration Points
DarkWatch: Exposure detection eventsSpamShield: Spam detection and blocking eventsVoicePrint: Voice enrollment and analysis eventsWaitlist: Signup tracking with source attribution