Skip to main content
Push message reports help you track the performance of each push notification, including delivery outcomes, user engagement (CTR), device-level confirmations, and error diagnostics.

Push message report high-level stats.


Delivery statistics and outcome definitions

Important concepts:
  • Push Subscriptions can refer to mobile and web push subscriptions depending on the audience and settings used in the message.
  • OneSignal (like all push providers) sends push notifications to the push services (Google (FCM), Apple (APNs), Huawei (HMS), etc.) which in turn sends them to your users.
  • The Delivered, Unsubscribed, and Failed responses are from the push services.
  • The Confirmed Delivery and Clicked responses come from the OneSignal SDK.
MetricDefinition
AudienceThe number of push Subscriptions in the included segments, excluding duplicates and any in excluded segments.
SentThe number of push Subscriptions in the audience sent the message. Excludes the unsubscribed, failed, remaining, or capped Subscriptions.
DeliveredThe number of push notifications that were successfully received by the push services.
Confirmed DeliveryThe number of push Subscriptions that confirmed receiving the message.
UnsubscribedThe number of push Subscriptions that did not receive the message because they uninstalled the app, cleared browser data, or opted out of push and have not opened the app since.
FailedThe number of push Subscriptions that did not receive the message because of an error. See Failure message troubleshooting.
RemainingThe number of notifications still queued on the OneSignal side for sending.
CappedThe number of notifications not sent due to frequency capping settings.
ClicksThe number of clicks on the message.
Click-Through RateCalculated as (Clicks / Delivered) * 100%.
Confirmed CTRCalculated as (Clicks / Confirmed Delivered) * 100%.
Influenced OpensThe number of app opens that occurred after receiving the notification, without clicking. Based on time window set in Settings > Push & In-App > Influenced Opens.

Failure message troubleshooting

These errors prevented OneSignal from delivering the message to the push provider:
ErrorTypeTroubleshooting Steps
401 UnauthorizedWebWeb push server gave an unclear 401 error. Retry cautiously — it may cause duplicate sends.
404 Not FoundWebInvalid push subscription endpoint (bad token).
Authentication ErrorFCMCheck your FCM credentials, re-upload the service account file, and try again.
DeviceTokenNotForTopicAPNsToken’s Bundle ID does not match your APNs key or certificate. Fix in p8 token or p12 setup.
Expired CertificateAPNsYour p12 certificate has expired. See certificate setup.
FcmV1InvalidToken / Not FoundFCMInvalid push token. Check Firebase credentials. Devices must reopen app to refresh tokens.
None / MissingFCMFirebase Cloud Messaging API may not be enabled in your project. Activate in the Firebase Console and retry.
Permission DeniedFCMCheck the full error message for which permission is missing. Update the permission for the Service Account file and re-upload it to OneSignal.
SenderIdMismatchFCMFCM v1 Sender ID mismatch. Verify Firebase credentials. Users must reopen the app for updated tokens.
TopicDisallowedAPNsAPNs token mismatch. Check your Team ID, Key ID, and Bundle ID in p8 config.

Delivery status

StatusDescription
DeliveredMessage has finished being sent to the push service.
ScheduledMessage is scheduled for future delivery.
SendingMessage is actively being sent.
QueuedMessage is waiting to be sent.
CanceledMessage was manually canceled. See Cancel push notifications.
No RecipientsNo valid audience at send time (e.g. unsubscribed or out of segment).
FailedOneSignal could not send the message due to errors.

Message statistics

Shows a graph of clicks, sessions, and custom outcomes over the last 30 days.

Image showing Outcome graph along with custom outcomes

  • Messages sent via the OneSignal API are only retained for 30 days.
  • Use Template Analytics to track message performance over time.
  • Export your message data via the Dashboard or API.

Audience activity

The Audience activity report shows how each subscription interacted with a specific message. Results are grouped into categories so you can quickly see how recipients engaged.
Audience activity screenshot

Audience activity tabs and table

  • Categories
  • Table columns
CategoryDescription
SentMessage was sent to the device.
Confirmed DeliveryDelivery was confirmed by the device.
Did Not Confirm DeliveryDelivery confirmation was not received.
ClickedUser clicked the notification.
Did Not ClickUser did not click the notification.
FailedDelivery failed.
UnsubscribedThe subscription unsubscribed after receiving the message.
Each tab displays the number of recipients in that category and lets you drill into the individual subscription records.
Audience activity data is only available for 30 days from the time the message is sent. Export results if you need to retain them longer.

Why audience activity is helpful

Audience activity helps you go beyond delivery counts by showing which specific users fall into each outcome. Use it to:
  • Diagnose delivery issues by reviewing failed or unconfirmed deliveries.
  • Measure engagement by comparing clicks vs. non-clicks.
  • Track churn by identifying unsubscribes tied to a message.
  • Segment audiences for retargeting or export.

Retargeting audiences

From the Audience activity view, you can send a Retargeted Message directly to any category (for example, all users who did not click). This makes it easy to follow up with users who didn’t engage, re-engage those who churned, or reinforce success with users who confirmed delivery.

Exporting results

You can download audience data with the Export menu:
  • Selected activity – exports only the currently viewed tab (for example, all users who failed delivery).
  • All activities – exports the full report across every category.
Exports let you analyze results offline, share with other teams, or merge with your CRM and analytics tools.

Message settings

This section shows the details of the message including and a visual summary of how the message was configured before delivery.
  • Audience - Details of the audience including:
    • Total number of recipients - How many Subscriptions were sent the message
    • How the message was sent: Targeting filters or segments used
  • Schedule - When the message started sending and per-user delivery options selected, if any.
  • Throttling - Any throttling, frequency caps, or channel overrides
  • Message - The message content.
    • Platforms targeted (Android, iOS, specific browsers)
  • Advanced Settings - Like Priority, Time to live, and Collapse ID.
  • Additional Data - Any custom data added to the message.

I