hermes/docs/analytics-taxonomy.md

Analytics Taxonomy

Rules

• All analytics events are structured
• No JSONB payloads
• Events live in analytics_events
• Attributes live in analytics_event_attributes

Event Groups

Lifecycle

• app_opened
• app_backgrounded
• app_closed
• session_started
• session_ended

Onboarding

• language_selected
• consent_viewed
• consent_accepted

Feed and Round Load

• feed_viewed
• round_card_viewed
• round_loaded
• event_manifest_received
• preview_prefetch_started
• preview_prefetch_completed

Playback

• preview_started
• preview_paused
• preview_resumed
• preview_completed
• reveal_started
• reveal_completed
• playback_error
• stream_reconnected

Timing and Odds

• countdown_visible
• countdown_warning_threshold_hit
• odds_panel_viewed
• odds_version_received
• odds_changed

Selection and Settlement

• outcome_focused
• outcome_selected
• selection_submitted
• selection_accepted
• selection_rejected
• duplicate_selection_attempt
• market_locked
• result_viewed
• next_round_requested

UI and Input

• screen_viewed
• cta_pressed
• gesture_swipe
• gesture_tap
• gesture_cancelled
• haptic_triggered

Localization and Errors

• localization_bundle_loaded
• locale_changed
• network_error

Common Attributes

• screen_name
• event_id
• market_id
• outcome_id
• odds_version_id
• countdown_ms_remaining
• locale_code
• experiment_variant
• network_type
• device_orientation
• playback_position_ms
• latency_ms

Research Metrics

• Decision latency
• Round completion rate
• Missed rounds
• Post-lock selection attempts
• Replay desire
• Exit rate
• Control vs modern comparison
• Locale effects
• Device platform effects