product-analytics

# Product Analytics ## Core Principles - **Metrics over vanity** — Focus on actionable metrics tied to business outcomes - **Data-driven decisions** — Hypothesize, measure, learn, iterate - **User-centric measurement** — Track behavior, not just pageviews - **Statistical rigor** — Understand significance, avoid false positives - **Privacy-first** — Respect user data, comply with GDPR/CCPA - **North Star focus** — Align all teams around one key metric --- ## Hard Rules (Must Follow) > These rules are mandatory. Violating them means the skill is not working correctly. ### No PII in Events **Events must NEVER contain personally identifiable information.** ```javascript // ❌ FORBIDDEN: PII in event properties track('user_signed_up', { email: 'user@example.com', // PII! name: 'John Doe', // PII! phone: '+1234567890', // PII! ip_address: '192.168.1.1', // PII! credit_card: '4111...', // NEVER! }); // ✅ REQUIRED: Anonymized/hashed identifiers only track('user_signed_up', { user_id: hash('user@example.com'), // Hashed plan: 'pro', source: 'organic', country: 'US', // Broad location OK }); // Masking utilities const maskEmail = (email) => { const [name, domain] = email.split('@'); return `${name[0]}***@${domain}`; }; ``` ### Object_Action Event Naming **All event names must follow the object_action snake_case format.** ```javascript // ❌ FORBIDDEN: Inconsistent naming track('signup'); ...