Getting started/How Analyse works

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.

  • pageview fires on every page load, and on route changes in single page apps.
  • page_leave fires 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:

  • Analytics The dashboard: overview, boards, retention, events, users, geography.
  • AI and MCP The built in assistant and the MCP server both query the same data with the same tools.
  • SEO engine Keyword tracking, Search Console data, and AI written blog posts grounded in your knowledge base.