Traffic
Visitors
Unique visitors in the date range. A visitor is oneanonymous_id: the persistent ID that the SDK stores in a first-party cookie. A visitor counts once in the period, even when active on several days. On a daily chart, a visitor counts once on each day that they are active.
Events without an anonymous_id (sent before consent in consent mode) do not count as visitors.
Page views
The number ofpage events. Each message_id counts once, so a retried event does not count twice.
Custom events
The number oftrack events.
Sessions
The number of sessions that count. A session counts when it has at least one event that the website or the game sent: a page view or a custom event of the website, or an event of a game session. A session is the clientsession_id that the SDK sends. A new session starts after 30 minutes without events, and when the session is 24 hours old. A session counts on the UTC day of its first event, and it does not split at midnight.
Each event from a website or a game has a session ID: the collector refuses an event that has an anonymous_id and no session_id, or a session_id equal to the anonymous_id. An event before consent has neither, and it is in no session.
A server event is the one event that can have no session ID. Send the session ID of the client with your server call: the event is then in that session, also when it comes late. Read the ID from the client SDK (getSessionId() in the web and Node SDKs, get_session_id() in Godot, SessionId in Unity) and send it to your backend with the request:
anonymous_id) that is active at that time, or one that starts in the next 30 minutes. If there is none, the event is in no session that counts.
Every report uses this one definition: the Overview, sessions by source and by page, the chart breakdowns, user paths, sessions per user, the dashboard templates and SQL charts that read the sessions table (see Explorer). So, without a filter, the sessions of all sources add up to the Sessions of the Overview.
The sessions table of SQL charts reads stored session rows, so that a chart can read a long date range. A test in the repository compares it with the reports on each change. A server event is in the same session in both: with the session ID of the client, or attached by time when it has none. Two rare cases differ:
- A client that keeps one session ID for more than 24 hours. The reports split its events by inactivity. The
sessionstable has one session of at most 24 hours. The SDKs start a new session ID before that. - A page view that a server sends with no session ID. In the reports it can be the entry page of the session that it joins. In the
sessionstable it adds a page view to the session that it joins, and nothing else. Send the session ID of the client with a server call.
- A session belongs to one visitor (
anonymous_id). Events without ananonymous_idhave no session. - A report reads the events of its date range only. A session that starts before the range counts on the day of its first event in the range.
- A filter selects the visitors with a matching event. All sessions of those visitors count.
- A session has one source: the source of its first page view, or of its first event when it has no page view. A tagged page later in the session does not change it.
Game sessions in the Sessions metric
A game or app build (the Godot and Unity SDKs, or app events) sends events withchannel app and no page view. A session with at least one event of channel app is a game session, and it counts as a session. So for a game, the Sessions metric, sessions per user and user paths have the game sessions.
A website session with custom events only (no page view) counts too. A server event that joins no session is not a session.
A game session has no page view, and a website session with custom events only has none. So such a session has no entry page and no exit page, and it is not in the bounce rate.
The Game KPIs and Game health templates count one run of the game from the session ID of the game SDK (
session_start to session_end). The two numbers agree for the Godot and Unity SDKs, because the Sessions metric uses the same session ID. A game that stays open gets a new session every 24 hours (session_end, then session_start).Bounce rate
The share of the sessions with a page view that have one page view and no custom event. Lower is better. A session with no page view (a game session, or a website session with custom events only) is not a bounce, and it is not in the sessions that the rate divides by.Session duration
The average time from the first event to the last event that the website or the game sent in a session, over all sessions that count (game sessions too). A session with one such event has a duration of 0. A server event is not user activity: it is in the session (its event and its revenue count there), and it does not change the duration.Where the session metrics are
The Overview tiles and trend, the Key metrics and Events over time reports of Ask AI, and thekpis and event_timeseries reports of the MCP server show these figures. Daily sessions add up to the total of the date range, because a session counts on one day only.
With a filter, sessions, bounce rate and session duration count all activity of the visitors that match the filter. Visitors, page views, custom events and revenue count only the events that match. Ask AI and the MCP server do not show the session metrics with a filter on an event name or on an event property.
Sessions by source and by page, user paths, sessions per user and the dashboard templates use the same sessions. The Sources, Countries and Technology cards follow the same filter rule: a filter selects the visitors with a matching event, then all sessions of those visitors count. So with the filter “Channel is not Direct”, a visitor with one paid session and one direct session adds a row for Direct.
Live visitors
Visitors with activity in the last five minutes. This is a rolling activity count, not a signal that a browser tab is open. See Live view.Revenue
Revenue (events)
The sum of the numericrevenue property on custom events, for example track('purchase', { revenue: 49 }). Each message_id counts once. Revenue by source uses the acquisition fields on each revenue event.
Billing revenue
Paid invoices and refunds from a connected billing provider (Stripe or Paddle), in the original currency. Recurring revenue uses the latest active or past-due subscriptions with a fixed price. Metered prices are left out; they do not count as zero. See Revenue.People
A user is the explicituser_id, else the one user that the anonymous_id links to, else the anonymous_id. Retention, funnels, user paths, lifecycle and profiles count people. See core concepts.
Identified users
People with auser_id from identify().
Lifecycle stages
Each user active in the date range has one stage. The stages are checked in this order:
Activity is page views and custom events.
identify events do not count. See Audience insights.
Sessions per user
The number of sessions of each user in the date range, in buckets: 1, 2, 3 to 5, 6 to 10, 11 to 25, 26 to 50, and more than 50. The previous period has the same number of days. A user with no session in a period (for example a user with server events only) is not in the report for that period. A player has game sessions.Engagement
Funnel conversion
The share of people who complete each step of a funnel in order, within the conversion window (24 hours by default, from 1 minute to 90 days). An open funnel counts each step at any time in the range, in any order.Retention
The share of a cohort that does the returning event in a later week or day. A week starts on Monday (UTC). Period 0 is always 100%. Recurring retention counts a user in period N only when they return in that period. Rolling retention counts a user who returns in period N or later. See Retention.Crash-free sessions
1 minus the share of sessions withapp_unclean_exit or an unhandled critical error. See Errors and crashes.
Game
The Game KPIs dashboard template reads the app event conventions. A player is one install (anonymous_id), and only events that the game sends count: events with context.app. These are the app events of a native build (channel app) and the web events of a browser game that sets the web SDK app option. Server events do not count, even with context.app. The Godot and Unity SDKs send game_open, session_start and session_end for you. A browser game sends them with track.
DAU, MAU and stickiness
DAU is the average number of players active per day over the days of the date range. MAU is the number of players active in the 30 days that end on the last day of the range, whatever the range. Stickiness is DAU / MAU.D1, D7 and D30 retention
Day N retention follows the day the player returns. For each day of the range, take the players whose firstgame_open (is_first_open true) was N days earlier. DN retention is the share of them with a session_start on that day. So D30 has data in a 30-day range. The Install cohorts chart is the retention report by day: players grouped by their first game_open, returning with session_start.
Sessions per DAU and session length
Sessions per DAU is the number of game sessions (session_id) per player per active day. Session length is the average duration_s of session_end events, in minutes.
ARPDAU and ARPPU
Revenue is the sum ofpurchase events from the game: amount_cents / 100, else the revenue property, in the purchase currency. Send one currency: the dashboard does not convert currencies, and the cards show no currency symbol. A retried event (the same message_id) counts once. ARPDAU is revenue per player per active day. ARPPU is revenue per paying player in the range.
Levels and economy
The Levels table counts, perlevel value, the players who started it, the level_start, level_complete and level_fail events, and the fail rate: fails / (completes + fails). Numeric levels sort as numbers. The Level funnel goes from game_open to level_complete for levels 1 to 4; edit its steps for your own milestones (a funnel has up to five steps). Currency sources and sinks sums amount of resource events per currency, split by flow (source or sink).
Acquisition
Channel
The acquisition channel of an event (channel_type), such as Organic Search, Paid Social or Direct. The collector sets it from the campaign fields, click IDs and the referrer. Visitors and sessions use the source of the first page of each session. See Attribution.
Do not confuse
channel_type (acquisition) with channel (event origin: web, app, server or a billing provider). See common fields.