# Statistics

> Statistics in MailCamp report on what happened after a campaign was sent — how many emails were delivered, opened, clicked, bounced, or led to an unsubscribe. Statistics are available per campaign and as aggregate views across multiple campaigns.

## What it is

Statistics is the analytics surface of MailCamp. It does not change behaviour; it answers the question "did this work?" Numbers are updated as events arrive from recipients' email clients and the sending infrastructure.

## Key concepts

- **Sent**: the number of recipients the campaign was dispatched to.
- **Delivered**: the number of sends successfully received (sent minus permanent bounces).
- **Opens**: how many recipients opened the email. Shown as both unique and total opens.
- **Clicks**: how many recipients clicked a link in the email. Shown as both unique and total clicks.
- **Click-through rate (CTR)**: the share of delivered emails that received at least one click.
- **Bounces**:
  - **Hard bounce** — a permanent failure such as an invalid address. The contact is marked Bounced and excluded from future sends.
  - **Soft bounce** — a temporary failure such as a full mailbox. Retried where possible.
- **Unsubscribes**: the number of recipients who used the unsubscribe link.
- **Spam complaints**: reports filed with recipients' email providers; treated like an unsubscribe.

## Views

- **Per campaign**: each campaign has a dedicated statistics page at `/statistics/campaign/:id/overview`, with sibling tabs for opens, clicks, bounces, and unsubscribes. Shows headline numbers plus a timeline of when opens and clicks happened.
- **Aggregate**: `/statistics/campaigns` shows trends across multiple campaigns over time.

## Common workflows

### Reviewing a single campaign's performance

1. Open **Campaigns** and find the campaign in the list.
2. From its row, choose **Statistics** to navigate to `/statistics/campaign/:id/overview`.
3. Use the tab bar to drill into Opens, Clicks, Bounces, or Unsubscribes.

### Comparing campaigns over time

1. Open **Statistics → Campaigns**.
2. Select a date range.
3. Compare open rates and CTRs across sends to spot trends.

## Limits and edge cases

- Open tracking depends on the recipient's email app behaviour. Many modern clients hide opens by default, so absolute open numbers underrepresent reality — but trends across campaigns remain comparable.
- Click tracking only counts clicks on the campaign's tracked links; bare text URLs are not counted.
- Bounce updates may take a short time to appear after sending.
- Statistics for in-progress sends update live as the campaign goes out.

## Web routes

Paths use `:id` as the placeholder for a campaign's identifier.

- `/statistics/campaigns` — aggregate statistics across campaigns.
- `/statistics/campaign/:id/overview` — per-campaign summary, with sibling tabs `/opens`, `/clicks`, `/bounces`, and `/unsubscribes`.

## Related

- [Campaigns](/llms/campaigns.txt) — the unit statistics report on.
- [Contacts](/llms/contacts.txt) — bounces and unsubscribes update contact status.