How Analyse works
The concepts behind the platform. What an event is, how sessions and people are stitched together, and how workspaces and sites relate to each other.
Events
Everything in Analyse is an event: a timestamped record of something that happened on your site, with a name and a set of properties. The SDK sends two kinds automatically.
pageviewfires on every page load, and on route changes in single page apps.page_leavefires when a visitor leaves a page. It carries time on page in seconds and how far they scrolled.
On top of those you can send your own custom events and the typed standard events for signups, checkouts, and trials.
Sessions
Events from the same visitor are grouped into sessions. A session ends after 30 minutes of inactivity. Session grouping happens without cookies, the SDK keeps an anonymous id in localStorage instead. See Privacy for the details.
Anonymous visitors and identified people
Every device gets a random anonymous id. When someone signs up or logs in, call identify(userId) and Analyse links that device's history to the person. Someone who reads your blog on Monday and signs up on Thursday shows up as one journey, not two visitors.
Identified people appear in the Users view with their traits and full event history.
Workspaces and sites
A workspace is the unit of billing and team membership. It holds one subscription, one set of members, and one credit balance. A site is a tracked domain inside a workspace, each with its own public key and its own analytics.
Most people have one workspace with one or a few sites in it. Agencies typically run one workspace per client, or one workspace with many sites, depending on how they bill. Plan limits apply per workspace, see Plans and limits.
Where the data lives
Raw events are stored in a column database built for analytics queries, which is why funnels and retention tables come back fast even on large sites. How long events are kept depends on your plan's retention window.
The three products on top
One event stream feeds three products:
AnalyticsThe dashboard: overview, boards, retention, events, users, geography.AI and MCPThe built in assistant and the MCP server both query the same data with the same tools.SEO engineKeyword tracking, Search Console data, and AI written blog posts grounded in your knowledge base.