Email Message Reports

OneSignal Email delivery and statistics

When clicking an email report, you will see the high-level stats like how the message was created, when it started sending, how long it took to fully send and any throttling limits set.

Find Email Message Delivery Stats within Delivery > Sent Messages.

15341534

Image showing snapshot view of realtime message data

Statistic

Description

Delivered

How many messages were sent from OneSignal to the Email Service Provider.

Open Rate

The rate of unique recipients who opened or looked at the email contents.

Click-Through Rate

The rate of unique recipients to whom an email was delivered and who clicked through any link.

N/A means link tracking was disabled for that message. More details in Email Links and Click Tracking.

🚧

API Message Data Retention Limit

Messages sent from the OneSignal API or Automated Messages are only saved for about 30 days.
You can export message data for your records through our API or Dashboard. See Exporting Data for more details.

Delivery Status

Delivery statistics provides you feedback on how your email performed.

Delivery Status

Description

Delivered

OneSignal has completed sending the message.

Queued

Messages are queued up in OneSignal and will be sent shortly.

Sending

Messages are currently sending.

Scheduled

Messages are scheduled to be delivered at the time based on Intelligent Delivery or Timezone option. They should be finished sending within 24 hours.

Canceled

You or a team member with access to your app has cancelled the delivery of this message.

No Recipients

Recipients are no longer subscribed or no longer fit in the Segment when it was originally scheduled.

Failed

The message failed to send.

688688

Image showing piecharts of delivery statistics

Statistic

Description

Total Sent

The number of emails targeted to be sent the message.

Delivered

The number of messages successfully sent to your Email Service Provider. This does not necessarily mean the devices have received these messages.

Delivered - Unique Opens

The number of unique recipients who have opened this email

Delivered - Unique Clicks

The number of unique recipients who have clicked links in this email.

Delivered - Unsubscribes

The number of recipients who opted out of your emails using the unsubscribe link in this email.

Delivered - Spam Reports

The number of recipients who reported this email as spam.

Bounced

The number of recipients who registered as a hard or soft bounce and didn’t receive your email.

Failed (Errored)

The message failed to send.

Remaining

The number of devices that have not received the message yet.

Message Settings

The Message Settings is a visual of all data sent within the message including which segment or filters used to target and total number of recipients (number of users targeted).


FAQ

Which Email Service Providers support which statistics?

Not all email service providers provide the full range of possible email statistics.

ESP

Unsubscribe

Bounce

Spam

Invalid

Drop

Block

Sendgrid

Yes

Yes

Yes

Yes

Yes

Yes

Mailgun

Yes

Yes

Yes

Yes (bounce)

Yes

Mandrill

Yes

Yes

Yes

How do you handle suppressions like blocks, spam reports, etc?

Because OneSignal is just acting as a relay to your email service provider, we rely on the email service provider to handle communications with email servers to determine if emails are working. When an email is no longer considered working, it is suppressed by the email service provider, and will no longer send. Each email service provider has slightly different logic to determine suppressions - for instance, how many emails an email address must receive that bounce before being suppressed.

If an email is forwarded, do the click and open events get tracked?

No, anyone that forwards your emails to someone else whom opens and clicks a link does not get counted in the message report stats.


Did this page help you?