Sessions & Stickiness

Sessions tell you how often people come back. Stickiness tells you what fraction of your monthly audience is active on any given day or week — a direct measure of engagement.

Quick start

# Session volume over the last 30 days
tell metrics sessions --range 30d

# Daily stickiness (DAU/MAU ratio)
tell metrics stickiness --range 30d --type daily

Session metrics

Session volume — total session count over time. Each session record counts as one. Unique sessions — distinct session IDs per time bucket. Filters out duplicate records for the same session.

# Unique sessions, weekly buckets
tell metrics sessions --range 90d --granularity weekly --type unique

Via the API:

# Session volume
curl "https://your-tell-server/api/v1/metrics/sessions?range=30d" \
  -H "Authorization: Bearer $TOKEN"

# Unique sessions
curl "https://your-tell-server/api/v1/metrics/sessions/unique?range=30d" \
  -H "Authorization: Bearer $TOKEN"

Top sessions

See which device types, countries, or operating systems generate the most sessions:

# Top 10 device types by session count
curl "https://your-tell-server/api/v1/metrics/sessions/top?range=30d&property=device_type&limit=10" \
  -H "Authorization: Bearer $TOKEN"

Available groupings: device_type, country, operating_system, or any field in the context table.

Stickiness

Stickiness measures what proportion of your user base is active in a shorter window. Higher stickiness means better engagement. Daily stickiness = DAU / MAU. A value of 50% means half your monthly users visit every day. Weekly stickiness = WAU / MAU. A value of 80% means most monthly users visit at least once a week.

# Daily stickiness with weekly granularity
tell metrics stickiness --range 90d --type daily --granularity weekly

# Weekly stickiness
tell metrics stickiness --range 90d --type weekly

Via the API:

curl "https://your-tell-server/api/v1/metrics/stickiness/daily?range=30d" \
  -H "Authorization: Bearer $TOKEN"

Breakdowns and comparison

Session metrics support the same filtering and breakdowns as all other metrics — split by any field, compare to the previous period, and control time granularity.

# Sessions by country, compared to previous period
tell metrics sessions --range 30d --breakdown country --compare previous

Getting Started

Tracking

Pipeline

Analytics

Installing

Sessions & Stickiness

Quick start

Session metrics

Top sessions

Stickiness

Breakdowns and comparison

​Quick start

​Session metrics

​Top sessions

​Stickiness

​Breakdowns and comparison

Quick start

Session metrics

Top sessions

Stickiness

Breakdowns and comparison