> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tell.rs/llms.txt
> Use this file to discover all available pages before exploring further.

# Visitors & Page Views

> Track unique visitors with DAU, WAU, and MAU — broken down by device, country, or any field.

Know how many people use your product each day, week, or month. Tell counts unique visitors (by device ID) and gives you DAU, WAU, and MAU out of the box.

## Quick start

```bash theme={null}
# Daily active users, last 30 days
tell metrics dau --range 30d

# Weekly active users, broken down by country
tell metrics wau --range 90d --breakdown country
```

Or via the API:

```bash theme={null}
curl "https://your-tell-server/api/v1/metrics/dau?range=30d" \
  -H "Authorization: Bearer $TOKEN"
```

## Metrics

**DAU** (daily active users) — distinct visitors per day. If a user visits three times in one day, they count once.

**WAU** (weekly active users) — distinct visitors per rolling 7-day window.

**MAU** (monthly active users) — distinct visitors per rolling 30-day window.

**User count** — total user records over time from the users table, distinct from active user metrics.

## Breakdowns

Split any visitor metric by a dimension to see where your users come from:

```bash theme={null}
# Visitors by device type (desktop, mobile, tablet)
tell metrics dau --range 30d --breakdown device_type

# Visitors by operating system
tell metrics dau --range 30d --breakdown operating_system

# Visitors by country
tell metrics dau --range 30d --breakdown country
```

Via the API, add `&breakdown=device_type` to any active user endpoint.

## Comparing periods

See how visitor numbers changed compared to the previous period or same period last year:

```bash theme={null}
# DAU this month vs last month
tell metrics dau --range 30d --compare previous

# Year-over-year comparison
tell metrics mau --range 90d --compare yoy
```

The response includes the current total, previous total, absolute change, and percent change.

## Drill-down

When you see a spike or drop in visitors, drill into the raw data to see which specific users were active:

```bash theme={null}
curl "https://your-tell-server/api/v1/metrics/dau/raw?range=7d&limit=50" \
  -H "Authorization: Bearer $TOKEN"
```

This returns individual device IDs within the time range, so you can investigate further.

## Time ranges and granularity

All visitor metrics support the full set of [time ranges and granularity options](/analytics/filtering) — from minute-level resolution up to yearly buckets, with predefined ranges like `today`, `wtd`, `mtd`, `ytd`, or custom date ranges.