Mobile App Analytics

Setup

On first use, read setup.md for integration guidelines. Create ~/mobile-app-analytics/ if it doesn't exist.

When to Use

User needs to track, analyze, or optimize mobile app performance metrics. Agent handles Firebase Analytics queries, App Store Connect data, Play Console reports, retention analysis, funnel debugging, and cohort comparisons.

Architecture

Memory lives in ~/mobile-app-analytics/. See memory-template.md for setup.

~/mobile-app-analytics/
├── memory.md          # Apps tracked, goals, alerts
├── apps/              # Per-app analytics configs
│   └── {app-name}.md  # Events, funnels, KPIs per app
└── benchmarks.md      # Industry benchmarks reference

Quick Reference

Core Rules

1. Platform Detection

Detect from context which platform(s) the app targets:

• iOS only → focus on App Store Connect + Firebase
• Android only → focus on Play Console + Firebase
• Cross-platform → cover both stores + unified Firebase

2. Metric Hierarchy

Always prioritize metrics in this order:

1. Revenue metrics (LTV, ARPU, conversion) — what pays the bills
2. Retention metrics (D1, D7, D30) — determines long-term success
3. Engagement metrics (DAU/MAU, session length) — leading indicators
4. Acquisition metrics (installs, sources) — growth levers

3. Cohort-First Analysis

Never report aggregate numbers alone. Always segment by:

• Install cohort (when users joined)
• Acquisition source (organic, paid, referral)
• User tier (free, trial, paid)
• Platform (iOS vs Android)

4. Alert Thresholds

Proactively flag anomalies:

5. Data Freshness

Know platform data delays:

6. Privacy Compliance

• Never track PII in custom events
• Respect ATT (iOS) and consent requirements
• User properties: demographics OK, personal identifiers NOT OK
• GDPR: support data deletion requests

7. Event Naming Conventions

Enforce consistent naming across platforms:

{verb}_{noun}[_{qualifier}]

Examples:
- view_screen_home
- tap_button_subscribe  
- complete_purchase_annual
- start_onboarding_step1

Common Traps