API Metrics
API metrics describe what happened after a message was accepted by Mailtarget. Use them to reconcile application state, detect deliverability issues, and report engagement.
Delivery metrics
| Metric | Meaning |
|---|---|
count_injected | Messages generated or relayed through Mailtarget. |
count_delivered | Messages accepted by the recipient mailbox provider. |
count_delayed | Messages temporarily rejected by a mailbox provider. Retry may still succeed. |
count_bounce | Bounced messages, including in-band and out-of-band bounces, excluding administrative bounces. |
Accepted is not the same as Delivered. Persist the transmissionId from send responses and reconcile it with webhook or analytics events.
Engagement metrics
| Metric | Meaning |
|---|---|
| Open rate | Percentage of unique confirmed opens over accepted messages. Treat this as directional because some clients block or prefetch images. |
count_clicked | Link clicks across messages. |
| Unsubscribed | A recipient used an unsubscribe mechanism. |
| Spam complaint | A recipient or mailbox provider marked the message as unwanted. |
Operational use
- Use delivery metrics for retry, suppression, and incident handling.
- Use engagement metrics for product analytics and campaign reporting.
- Use webhook events for near-real-time workflows.
- Use analytics endpoints for aggregate reporting and backfills.