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

# Metrics & Analytics

> View email performance stats and analyze engagement across different email types

# Metrics & Analytics

Sequenzy provides comprehensive metrics to help you understand how your emails are performing. View aggregate stats, analyze trends over time, and break down performance by audience and email type.

## Available Metrics

### Core Email Metrics

| Metric            | Description                                 |
| ----------------- | ------------------------------------------- |
| **Sent**          | Total number of emails successfully sent    |
| **Delivered**     | Emails that reached the recipient's inbox   |
| **Opens**         | Number of times emails were opened          |
| **Unique Opens**  | Number of unique subscribers who opened     |
| **Clicks**        | Total link clicks across all emails         |
| **Unique Clicks** | Number of unique subscribers who clicked    |
| **Unsubscribes**  | Subscribers who unsubscribed via email link |
| **Bounces**       | Emails that failed to deliver               |
| **Complaints**    | Spam complaints received                    |

Open and click metrics exclude detected email-security scanners, link-preview clients, and tracked brand assets by default. Turn on "Include bots" in the dashboard, or pass `includeMachineEngagement=true` to analytics API endpoints, when you need raw scanner-inclusive counts for debugging.

If your audience sits behind aggressive email-security appliances (common with cold outreach and B2B lists), you can enable **Strict bot filtering** in Settings -> Tracking. It additionally filters opens and clicks from datacenter IPs, scripted HTTP clients, and single IPs sweeping links across many recipients. It is off by default because it can also discard some real engagement, which lowers your reported open and click rates.

Test sends are excluded from dashboard and API performance metrics, attributed revenue, recipient engagement, subscriber timelines, and sent-email history by default so previews do not skew results. They still count toward send usage and quota.

The same "Include bots" toggle is available when you drill into a metric's recipient list and on a subscriber's activity timeline. When bots are shown, automated opens and clicks are marked with a bot icon and their detected source (for example an email-security scanner or link-preview bot) so you can tell them apart from real engagement.

### Revenue Metrics

If you have [goals](/concepts/goals) configured with tracked value, the Metrics page can show attributed revenue in the overview. Revenue appears only when Sequenzy has attributed tracked value for the selected time period, audience, and email type.

### Calculated Rates

| Rate                 | Formula                            | What It Tells You                    |
| -------------------- | ---------------------------------- | ------------------------------------ |
| **Open Rate**        | Unique Opens / Delivered × 100     | Email subject line effectiveness     |
| **Click Rate**       | Unique Clicks / Delivered × 100    | Content engagement                   |
| **Click-to-Open**    | Unique Clicks / Unique Opens × 100 | Content relevance to engaged readers |
| **Unsubscribe Rate** | Unsubscribes / Delivered × 100     | Subscriber satisfaction              |
| **Bounce Rate**      | Bounces / Sent × 100               | List quality                         |

## Grouping by Email Type

Sequenzy allows you to filter and group metrics by email type, giving you insights into how different types of emails perform.

### Email Types

| Type              | Description                                               |
| ----------------- | --------------------------------------------------------- |
| **Transactional** | One-off emails triggered by user actions (receipts, etc.) |
| **Campaigns**     | Broadcast emails sent to a segment or list                |
| **Sequences**     | Automated emails from workflows                           |

### Why Group by Type?

Different email types have different benchmarks and purposes:

```
Transactional emails:
  └── High open rates (80%+) - recipients expect them
  └── Low unsubscribes - requested by user action

Campaigns:
  └── Moderate open rates (20-30%) - promotional content
  └── Higher unsubscribes - less personalized

Sequences:
  └── Higher engagement - triggered by behavior
  └── Variable rates - depends on automation type
```

Grouping helps you compare apples to apples and identify issues specific to each email type.

## Filtering by Audience

You can scope dashboard metrics to the audience you want to analyze:

| Audience filter      | Use it to analyze                                       |
| -------------------- | ------------------------------------------------------- |
| **All subscribers**  | Overall workspace performance                           |
| **Subscriber lists** | Performance for a specific imported or signup list      |
| **Saved segments**   | Performance for subscribers matching your segment rules |

Audience filters can be combined with date range and email type filters. For example, you can review campaign performance for a newsletter list over the last 30 days, or sequence engagement for a saved trial-user segment over the last 7 days.

## Viewing Metrics

### Dashboard Overview

Your dashboard shows high-level metrics across all emails or your selected audience and email type:

* Total emails sent (last 30 days)
* Overall open and click rates
* Trend charts showing performance over time
* Quick comparison to previous period
* Attributed revenue when revenue-driving goals have tracked value

### Ask From The Dashboard

The dashboard landing page also includes an expandable AI workspace for quick metric checks.

* Ask questions like `What are my metrics for last 30d?`
* Ask review-style prompts like `Tell me what happened last week`
* Ask scoped performance prompts like `Show my top performing sequence` or `What is my best campaign?`
* Sequenzy fetches a live company-level snapshot and shows the latest sends, deliveries, open rate, and click rate
* For sequence and campaign performance questions, Sequenzy can point to the specific sequence or campaign instead of only showing the company aggregate
* You can keep asking follow-up questions from the floating chat, so prompts like `Why did opens dip?` or `What should I improve next?` keep the earlier context
* You can jump from that summary straight into the full Metrics page if you want charts and deeper filters

### Detailed Analytics

In the Metrics section, you can:

1. **Select date range**: View metrics for any time period
2. **Filter by audience**: Scope metrics to all subscribers, a list, or a saved segment
3. **Group by email type**: Filter to see all emails, transactional emails, campaigns, or sequences
4. **View trends**: See how metrics change over time. Click any Overview metric (Emails sent, Deliverability, Open rate, Click rate, Unsub rate, Reply rate, or Revenue) to add or remove its line from the trend chart and compare several at once - Emails sent and Open rate are shown by default, and Revenue uses its own currency axis
5. **Export data**: Download metrics for further analysis

## Understanding Your Metrics

### Open Rates

| Open Rate | Interpretation                              |
| --------- | ------------------------------------------- |
| 40%+      | Excellent - highly engaged audience         |
| 20-40%    | Good - healthy engagement                   |
| 10-20%    | Average - room for improvement              |
| Under 10% | Low - review subject lines and list quality |

<Note>
  Open rates can be inflated or deflated due to email client behavior. Apple
  Mail Privacy Protection pre-fetches images, inflating rates. Some clients
  block images entirely, deflating rates. Focus on trends rather than absolute
  numbers.
</Note>

### Click Rates

| Click Rate | Interpretation                |
| ---------- | ----------------------------- |
| 5%+        | Excellent engagement          |
| 2-5%       | Good - content resonates      |
| 1-2%       | Average                       |
| \<1%       | Low - review content and CTAs |

### Bounce Rates

| Bounce Rate | Interpretation                                |
| ----------- | --------------------------------------------- |
| \<2%        | Healthy list                                  |
| 2-5%        | Needs attention - clean your list             |
| >5%         | Critical - high risk of deliverability issues |

### Delivery Failures vs Bounces

These look similar in a list of sends, but they mean opposite things and only
one of them is about your list.

A **bounce** is the receiving provider telling us the mailbox is bad. The
address is suppressed so you stop sending to it, and it counts toward your
bounce rate.

A **delivery failure** means every delivery route we had for that message was
exhausted without the provider ever judging the mailbox. It shows as "Delivery
failed" with the note "The recipient provider rejected all currently available
delivery routes." Nothing about the address is in question, so:

* the contact stays subscribed and is included in your next send;
* it does not count toward your bounce rate;
* it does not count toward the automatic sending pause that protects your
  sender reputation;
* webhooks receive `email.failed`, not `email.bounced`.

You cannot fix a delivery failure by cleaning your list, because the address is
not the problem. A cluster of them means the sending path had a temporary
problem, which we monitor and resolve on our side.

### Unsubscribe Rates

| Unsubscribe Rate | Interpretation                         |
| ---------------- | -------------------------------------- |
| \<0.5%           | Healthy                                |
| 0.5-1%           | Monitor closely                        |
| >1%              | Review frequency and content relevance |

## Using Metrics for Optimization

### 1. A/B Test Subject Lines

Compare open rates between campaigns to identify what resonates:

```
Campaign A: "Your weekly update" → 18% open rate
Campaign B: "3 tips to boost your sales" → 32% open rate

→ Specific, benefit-driven subject lines perform better
```

### 2. Optimize Send Times

Review when your emails get the highest engagement:

* Look at open rates by day of week
* Identify peak engagement hours
* Adjust your send schedule accordingly

### 3. Improve Click-Through

If opens are high but clicks are low:

* Review your call-to-action placement
* Make buttons more prominent
* Ensure content matches subject line promise

### 4. Reduce Unsubscribes

High unsubscribe rates indicate:

* Email frequency too high
* Content not matching expectations
* Wrong audience targeting

### 5. Clean Your List

High bounce rates hurt deliverability:

* Remove hard bounces automatically
* Re-engage inactive subscribers
* Use double opt-in for new signups

## Metrics by Email Type Examples

### Transactional Metrics

Best for tracking:

* Delivery success for critical emails
* Whether users are receiving receipts/confirmations
* Any deliverability issues with transactional sends

### Campaign Metrics

Best for tracking:

* Subject line performance
* Content engagement
* Audience growth and retention
* A/B test results

### Sequence Metrics

Best for tracking:

* Automation effectiveness
* Conversion through the funnel
* Drop-off points in sequences
* Which emails drive the most action

## Best Practices

### 1. Review Metrics Regularly

Set a weekly or bi-weekly schedule to review:

* Overall performance trends
* Any sudden drops in engagement
* Bounce and complaint rates

### 2. Benchmark Against Yourself

Industry benchmarks vary widely. Track your own metrics over time to establish your baseline, then work to improve it.

### 3. Segment Your Analysis

Don't just look at aggregate numbers. Break down by:

* Email type (transactional, campaigns, sequences)
* Subscriber lists
* Saved subscriber segments
* Individual campaigns or sequences

### 4. Act on Insights

Metrics are only valuable if you use them:

* Low open rates → Test new subject lines
* Low click rates → Improve content and CTAs
* High bounces → Clean your list
* High unsubscribes → Reduce frequency or improve targeting

## Common Queries via API

You can fetch metrics programmatically using the [Analytics API](/api-reference/analytics/metrics). Below are common questions mapped to the right API call.

### How many emails did we send in the last 7 days?

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/metrics?period=7d" \
 -H "Authorization: Bearer YOUR_API_KEY"
```

Check `stats.sent` in the response.

### What's the open rate for a specific campaign?

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/metrics/campaigns/{campaignId}" \
 -H "Authorization: Bearer YOUR_API_KEY"
```

Check `stats.openRate` in the response.

### Which step in my sequence has the highest drop-off?

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/metrics/sequences/{sequenceId}" \
 -H "Authorization: Bearer YOUR_API_KEY"
```

Compare `steps[].stats.sent` across steps — a large drop between consecutive steps indicates where subscribers disengage.

### Who opened or clicked my campaign?

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/metrics/recipients?campaignId={campaignId}" \
 -H "Authorization: Bearer YOUR_API_KEY"
```

Each recipient in the response includes `opened`, `clicked`, and `unsubscribed` fields. See [Get Recipients](/api-reference/analytics/recipients).

### Did a specific user engage with any of my emails?

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/metrics/recipients?email=user@example.com" \
 -H "Authorization: Bearer YOUR_API_KEY"
```

Returns all engagement events for that recipient across campaigns and sequences.

### How do I sync engagement data to my database on a schedule?

Call `/metrics/recipients` with a time window matching your cron interval:

```bash theme={null}
# Run daily — fetch yesterday's engagement
curl "https://api.sequenzy.com/api/v1/metrics/recipients?period=24h&limit=100" \
 -H "Authorization: Bearer YOUR_API_KEY"
```

Paginate through all results using `page` and store each recipient's `opened`, `clicked`, and `unsubscribed` data locally.

## Related

<CardGroup cols={2}>
  <Card title="Tracking" icon="eye" href="/concepts/tracking">
    Learn how email engagement is tracked
  </Card>

  <Card title="Campaigns" icon="paper-plane" href="/concepts/campaigns">
    Create and send broadcast campaigns
  </Card>

  <Card title="Sequences" icon="diagram-project" href="/concepts/sequences">
    Build automated email workflows
  </Card>

  <Card title="Transactional Emails" icon="receipt" href="/concepts/transactional-emails">
    Send triggered transactional emails
  </Card>
</CardGroup>
