Understand OneSignal Email delivery metrics and message performance analytics including opens, clicks, bounces, suppressions, and spam reports.
Email message reports help you track the performance of each email, including delivery stats, open rate, click rate, and error diagnostics. When viewing an email report in OneSignal, you’ll see real-time statistics showing how your message is performing.
Snapshot view of real-time email message data
Messages sent via the API are retained for ~30 days. To retain historical performance, export data using the Dashboard or API. See Exporting Data.
Understand how many recipients received your message, and why others didn’t.
Name | Description |
---|---|
Audience | Number of email subscriptions in the audience at send time. |
Sent | Subscriptions in the audience minus those remaining, bounced, failed, or suppressed. |
Delivered | Emails confirmed as delivered to recipients’ inboxes. |
Remaining | Emails still queued for sending. |
Bounced | Messages rejected due to invalid addresses, full inboxes, sender reputation, or DMARC issues. These addresses are added to the Suppression List. |
Failed | Emails dropped by OneSignal and never sent. See Why are emails marked as failed?. Tip: Export failure details in Audience Activity. |
Suppressed | Emails blocked due to prior bounces or spam reports. Suppression protects your sender reputation. Only applies to OneSignal Email. |
Open events are counted when the email is viewed, though privacy settings and inbox behavior may affect accuracy. See Why are open events low?.
Name | Description |
---|---|
Unique Opens | Count of individual recipients who opened the email. |
Total Opens | Total number of times the email was opened, including repeats. |
Measure engagement through link clicks in your email.
Name | Description |
---|---|
Click-Through Rate (CTR) | (Unique Clicks / Delivered) * 100% . Measures how many delivered emails resulted in a click. Requires Click Tracking to be enabled. |
Total Clicks | All link clicks, including repeat clicks from the same user. See URLs, Links and Deep Links. |
Click to Open Rate (CTOR) | (Unique Clicks / Unique Opens) * 100% . Measures how engaging the email was after being opened. |
CTR vs CTOR
Tip: Use UTM parameters for tracking in tools like Google Analytics.
If Click Tracking is enabled but click events are low, check for browser-level blocking (e.g., Brave or Firefox). Contact support@onesignal.com
if the issue persists.
Understand opt-outs and spam complaints so you can improve targeting and deliverability.
Name | Description |
---|---|
Unsubscribes | Number of recipients who opted out of receiving emails. Status is updated immediately. |
Reported as Spam | Recipients who marked your message as spam. These addresses are automatically added to the Suppression List. |
Use segmentation and send-time optimization to lower unsubscribe and spam rates.
Keep an eye on your unsubscribe and spam rates. If they’re too high, your app may get disabled until the issue is addressed. See:
Analyze performance trends over time, including engagement and delivery issues.
Message Statistics over 24-hour view
View metrics by:
You can toggle additional metrics like Bounced, ESP Failed, Sent, Spam, Suppressed, Total Clicks, and Total Opens.
Use the export icon in the top-right of the graph to download the data.
See detailed activity per recipient, including delivery, opens, clicks, unsubscribes, failures, and spam reports. Timestamps reflect the most recent event for each user.
Data is retained for 30 days.
What you can do:
Track which links were clicked and how many times.
Name | Description |
---|---|
Unique Clicks | Count of links clicked by recipients. |
Total Clicks | All link clicks, including repeat clicks from the same user. See URLs, Links and Deep Links. |
Click-Through Rate (CTR) | (Unique Clicks / Delivered) * 100% . Measures how many delivered emails resulted in a click. Requires Click Tracking to be enabled. |
Failure reasons are shown in the Audience Activity export. Common causes include:
@gmial.com
)Open tracking is not always 100% reliable. Test on multiple devices and networks for comparison.
Two main reasons:
If the message stays in Pending, it’s likely sent but not confirmed. Check Sent at in Audience Activity for clues.
Understand OneSignal Email delivery metrics and message performance analytics including opens, clicks, bounces, suppressions, and spam reports.
Email message reports help you track the performance of each email, including delivery stats, open rate, click rate, and error diagnostics. When viewing an email report in OneSignal, you’ll see real-time statistics showing how your message is performing.
Snapshot view of real-time email message data
Messages sent via the API are retained for ~30 days. To retain historical performance, export data using the Dashboard or API. See Exporting Data.
Understand how many recipients received your message, and why others didn’t.
Name | Description |
---|---|
Audience | Number of email subscriptions in the audience at send time. |
Sent | Subscriptions in the audience minus those remaining, bounced, failed, or suppressed. |
Delivered | Emails confirmed as delivered to recipients’ inboxes. |
Remaining | Emails still queued for sending. |
Bounced | Messages rejected due to invalid addresses, full inboxes, sender reputation, or DMARC issues. These addresses are added to the Suppression List. |
Failed | Emails dropped by OneSignal and never sent. See Why are emails marked as failed?. Tip: Export failure details in Audience Activity. |
Suppressed | Emails blocked due to prior bounces or spam reports. Suppression protects your sender reputation. Only applies to OneSignal Email. |
Open events are counted when the email is viewed, though privacy settings and inbox behavior may affect accuracy. See Why are open events low?.
Name | Description |
---|---|
Unique Opens | Count of individual recipients who opened the email. |
Total Opens | Total number of times the email was opened, including repeats. |
Measure engagement through link clicks in your email.
Name | Description |
---|---|
Click-Through Rate (CTR) | (Unique Clicks / Delivered) * 100% . Measures how many delivered emails resulted in a click. Requires Click Tracking to be enabled. |
Total Clicks | All link clicks, including repeat clicks from the same user. See URLs, Links and Deep Links. |
Click to Open Rate (CTOR) | (Unique Clicks / Unique Opens) * 100% . Measures how engaging the email was after being opened. |
CTR vs CTOR
Tip: Use UTM parameters for tracking in tools like Google Analytics.
If Click Tracking is enabled but click events are low, check for browser-level blocking (e.g., Brave or Firefox). Contact support@onesignal.com
if the issue persists.
Understand opt-outs and spam complaints so you can improve targeting and deliverability.
Name | Description |
---|---|
Unsubscribes | Number of recipients who opted out of receiving emails. Status is updated immediately. |
Reported as Spam | Recipients who marked your message as spam. These addresses are automatically added to the Suppression List. |
Use segmentation and send-time optimization to lower unsubscribe and spam rates.
Keep an eye on your unsubscribe and spam rates. If they’re too high, your app may get disabled until the issue is addressed. See:
Analyze performance trends over time, including engagement and delivery issues.
Message Statistics over 24-hour view
View metrics by:
You can toggle additional metrics like Bounced, ESP Failed, Sent, Spam, Suppressed, Total Clicks, and Total Opens.
Use the export icon in the top-right of the graph to download the data.
See detailed activity per recipient, including delivery, opens, clicks, unsubscribes, failures, and spam reports. Timestamps reflect the most recent event for each user.
Data is retained for 30 days.
What you can do:
Track which links were clicked and how many times.
Name | Description |
---|---|
Unique Clicks | Count of links clicked by recipients. |
Total Clicks | All link clicks, including repeat clicks from the same user. See URLs, Links and Deep Links. |
Click-Through Rate (CTR) | (Unique Clicks / Delivered) * 100% . Measures how many delivered emails resulted in a click. Requires Click Tracking to be enabled. |
Failure reasons are shown in the Audience Activity export. Common causes include:
@gmial.com
)Open tracking is not always 100% reliable. Test on multiple devices and networks for comparison.
Two main reasons:
If the message stays in Pending, it’s likely sent but not confirmed. Check Sent at in Audience Activity for clues.