Skip to main content

Analytics Overview

The Analytics dashboard provides a centralized view of how users interact with your flows, pages, and in-app content. Use these metrics to measure adoption, identify friction points, and optimize your digital adoption strategy.

Dashboard Overview

Navigate to Analytics > Overview to see a summary of your key adoption metrics. The overview panel displays aggregate data for the selected date range, giving you a quick health check across all published content.

The overview response includes:

MetricDescription
totalFlowsTotal number of flows created in your company
publishedFlowsFlows currently in a published (live) state
activeUsersUnique users who triggered at least one event
totalEventsTotal SDK events received (page views, clicks, flow interactions)
flowCompletionsNumber of times users completed a flow end-to-end
totalFlowStartsNumber of times users started a flow
completionRatePercentage of started flows that were completed

Date Range Filtering

All analytics endpoints accept from and to query parameters to scope data to a specific time window. If omitted, the API defaults to the last 30 days.

GET /api/analytics/overview?from=2025-01-01&to=2025-01-31

Time-series data is automatically bucketed by granularity based on the selected range:

  • Up to 48 hours -- bucketed by hour
  • Up to 30 days -- bucketed by day
  • Up to 12 weeks -- bucketed by week
  • Beyond 12 weeks -- bucketed by month

Event Pipeline

Events flow through the system in the following stages:

  1. The Runtime SDK batches user interactions (page views, clicks, flow events) on the client side.
  2. Batched events are sent to POST /api/sdk/events and written as RawEvent records.
  3. A BullMQ job is enqueued for asynchronous processing. If Redis is unavailable, events are processed synchronously as a fallback.
  4. The event-processor worker normalizes raw events into analytics tables: PageView, ClickEvent, FlowAnalytics, and SurveyResponse.

These processed tables power the analytics dashboard, flow analytics, and heatmap views.

Next Steps

  • Flow Analytics -- Drill into per-flow performance and step drop-off
  • Heatmaps -- Visualize click patterns on your pages