How-to
Analytics dashboard
Use the Analytics Dashboard tab to track bounce and complaint rates and build a widget grid of sends, bounces, opens, clicks and breakdowns.
The Dashboard tab of Email APIAnalytics is available on every plan. It shows your bounce and complaint rates and a grid of widgets that you can rearrange to fit what you watch every day. The layout is saved for the workspace, so everyone in it sees the same dashboard.
Bounce rate and complaint rate
Two cards sit at the top of the tab. They can’t be removed.
| Card | Shows | Reference lines |
|---|---|---|
| Bounce rate | Bounced emails divided by sent emails in the selected range, with a trend line and the change from the previous period. | Warning at 3%, Possible suspension at 5%. |
| Complaint rate | Spam complaints divided by sent emails. | Warning at 0.05%, Possible suspension at 0.3%. |
If a rate is approaching the second line, act before your domain is paused: see Sending health and Bounces and complaints.
Default widgets
A new workspace starts with this layout:
| Widget | Chart | Shows |
|---|---|---|
| Sends | Timeseries, half width | Outgoing emails created. |
| Bounces | Timeseries, half width | Emails whose status is bounced. |
| Complaints | Timeseries, third width | Spam complaints. |
| Loads | Timeseries, third width | Opens, counting every load. |
| Clicks | Timeseries, third width | Tracked link clicks, counting every click. |
| Delivery by provider | Bar, full width | Delivery rate for Gmail, Outlook, Live, Hotmail, Yahoo, iCloud and other providers. |
Add a widget
-
Open the dialog. Select the + (Add widget) button next to the date range.
-
Choose a metric. Pick one from the list below.
-
Choose a chart type. Timeseries, Stacked, Bar, Pie, Stat or Table. If the metric doesn’t support the type you pick, the widget uses the metric’s default type.
-
Add it. Select Add. The widget is placed in the first free spot at half width.
| Metric | Chart types | What it measures |
|---|---|---|
| Sends | Timeseries, Stat | Outgoing emails created. |
| Bounces, Failed, Rejected, Suppressed | Timeseries, Stat | Emails whose latest status is that status. |
| Complaints | Timeseries, Stat | Spam complaints received. |
| Loads, Clicks | Timeseries, Stat | Every open or click. |
| Unique loads, Unique clicks | Timeseries, Stat | Emails opened or clicked at least once. |
| Unique emails | Timeseries, Stat | Distinct emails in the range. |
| Avg delivery time | Timeseries, Stat | Average duration of delivery attempts. |
| Delivery status | Table, Pie, Timeseries | Emails by their latest status. |
| Top countries | Table, Pie | Countries where emails were opened, top 10. |
| Top links | Table | Most-clicked links by link ID, top 10. |
| By domain | Table, Pie | Sends per sending domain. |
| By API key | Table, Pie | Sends per API key. |
| By campaign | Table, Pie | Sends per campaign. |
| By tag | Table, Pie | Sends per tag. Usually a single “(none)” row, because API and SMTP mail isn’t tagged. |
| Delivery by provider | Bar, Table, Timeseries, Pie | Delivered emails divided by sent emails, per recipient mailbox provider. |
Loads and clicks need tracking turned on for the sending domain. See Tracking.
Arrange and size widgets
- Move: drag a widget by its body. Other widgets move out of the way.
- Resize: drag the handle in the bottom-right corner. Widths snap to a quarter, a third, half or the full width of the grid (3, 4, 6 or 12 of 12 columns), and heights to 1, 2 or 3 rows.
- Remove: open the widget’s menu (…) and select Remove.
Changes are saved automatically for the whole workspace.
Widget menu
Each widget’s … menu has:
- View details: a larger chart with a breakdown table, for example the per-provider sent, delivered, bounced, opened and clicked counts for Delivery by provider.
- Refresh: reloads only this widget.
- Range: shows this widget for a different preset than the page, or Page range to follow the page again. The override lasts until you leave the page.
- Remove
Filters
The Sending domain and API key filters and the date range at the top of the page apply to every widget and to the rate cards. See Analytics for presets, time zones and retention.