Session Frequency

Session Frequency: Average number of sessions per user per period.

Formula

Session Frequency = Total sessions / Active users

Computable definition

The canonical formula in the GASP formula grammar. The MCP server compiles it to SQL over the datasets listed below.

count_distinct(field.session_id) / count_distinct(field.user_id where field.product_event_type = 'qualifying')

Unit: ratio

Data requirements

Grain: Per event, aggregate monthly · Frequency: Daily · Aggregation: aggregate (month) · Staged: no · Main source: Product Analytics.

Field	Dataset	Type
`event_date`	product_event	date
`product_event_type`	product_event	string
`session_id`	product_event	string
`user_id`	product_event	string

Example SQL (Postgres)

SELECT (CAST((SELECT COUNT(DISTINCT session_id) FROM product_event WHERE event_date >= :period_start AND event_date <= :period_end) AS DOUBLE PRECISION) / NULLIF((SELECT COUNT(DISTINCT user_id) FROM product_event WHERE event_date >= :period_start AND event_date <= :period_end AND product_event_type = 'qualifying'), 0)) AS session_frequency

From an agent: with the GASP MCP server, call lookup_metric({ "name": "Session Frequency" }) or generate_query({ "metric": "Session Frequency", "adapter": "<your adapter JSON>" }).

What It Tells You

How often users return.

← Back to Product metrics