Event Sequences
Event Sequences
Insights-first event sequence analytics with actionable summaries and raw diagnostics.
Audience: Product teams and growth analysts optimizing user flow progression.
Critical: This module is now a breaking-cutover API. Legacy endpoints were removed and replaced by /insights and /raw.
Who This Page Is For
Use this page when you need fast decision support first (coverage, bottlenecks, recommended actions) and raw transition diagnostics second.
Quick Start (2-5 Minutes)
Fetch insights payload
Get top actionable sequences, bottlenecks, and recommended actions.
GET /api/v1/analytics/event-sequences/:siteId/insights?minLength=2&maxLength=5&flowMode=hybrid&excludeLowSignal=true&dedupeConsecutive=true&minSupport=3&minTransitionCount=2&conversionProfile=commerceFetch raw payload
Inspect sequence rows, pattern rows, and transition matrix with row sample counts.
GET /api/v1/analytics/event-sequences/:siteId/raw?minLength=2&maxLength=5&flowMode=hybrid&excludeLowSignal=true&dedupeConsecutive=true&minSupport=3&minTransitionCount=2&conversionProfile=commerceCompare flow modes
Run same query once with hybrid and once with journey to compare flow coverage.
GET /api/v1/analytics/event-sequences/:siteId/insights?flowMode=journeyValidate confidence
Use raw transition matrix rowOutgoingCount and lowSample flags before acting.
GET /api/v1/analytics/event-sequences/:siteId/raw?minTransitionCount=2Event sequence endpoints
GET /api/v1/analytics/event-sequences/:siteId/insights
GET /api/v1/analytics/event-sequences/:siteId/raw
GET /api/v1/analytics/funnels/:siteIdRequired Fields / Query Contract
| Field | Required | Type | Used by events | Description |
|---|---|---|---|---|
siteId | Required | uuid | All event sequence endpoints | Site-level data boundary. |
startDate / endDate | Optional | ISO date | insights + raw | Time window. Defaults to service fallback window when omitted. |
minLength / maxLength / limit | Optional | number | insights + raw | Controls sequence window shape and result volume. |
flowMode | Optional | hybrid | journey | insights + raw | Hybrid groups by journeyId -> sessionId -> visitorId fallback. Journey uses journeyId only. |
excludeLowSignal / dedupeConsecutive | Optional | boolean | insights + raw | Noise reduction controls for repeated or weak-signal events. |
minSupport / minTransitionCount | Optional | number | insights + raw | Thresholds to suppress low-volume noise. |
conversionProfile | Optional | commerce | activation | campaign | recommendation | search | insights + raw | Controls conversion lead-up interpretation. |
Endpoint Decision Matrix
| Scenario | Use This | Why |
|---|---|---|
| Need actionable summary first | /analytics/event-sequences/:siteId/insights | Returns key metrics, bottlenecks, and recommended actions. |
| Need diagnostic table-level detail | /analytics/event-sequences/:siteId/raw | Returns sequence support rows, pattern rows, and matrix with confidence metadata. |
| Need strict step-by-step completion math | /analytics/funnels/:siteId | Funnel endpoint remains the strict progression contract. |
Common Errors and Fixes
Insights look too sparse
Cause: High minSupport/minTransitionCount with low data volume.
Fix: Reduce thresholds or widen date window.
Raw matrix has many lowSample rows
Cause: Outgoing transition counts are too small for confidence.
Fix: Use longer window or merge low-volume event variants.
Hybrid and journey outputs diverge heavily
Cause: journeyId coverage is incomplete in source events.
Fix: Inspect data ingestion and compare with session/visitor fallback behavior.
Conversion lead-up coverage unexpectedly low
Cause: Selected conversionProfile does not match tracked conversion semantics.
Fix: Switch conversionProfile and validate conversion attribution metadata.
Production Checklist
- Event taxonomy consistency is enforced before sequence analytics is consumed.Required
- Dashboards default to hybrid flow mode unless strict journey-only analysis is required.Required
- Low-signal filtering defaults are documented for all stakeholders.Required
- Transition actions are gated by row sample confidence checks.Required
- Sequence insights are linked to specific optimization experiments.Required