Skip to main content
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