Understand how OneSignal tracks confirmed push notification deliveries across platforms like iOS, Android, and Web. Learn how to enable it, troubleshoot issues, and interpret delivery confirmation status.
Confirmed Delivery tracks whether a device has actually received a push notification sent via OneSignal. This information appears in the notification’s Message Report under the status “Confirmed” or “Received.”
Once a push notification is successfully delivered to a device, the OneSignal SDK sends a receipt event back to OneSignal’s servers.
Confirmed Deliveries Flow
Push notifications are sent from OneSignal through platform-specific services (APNs for iOS, FCM for Android, etc.). Confirmed Delivery events happen only after the OneSignal SDK on a device successfully receives a notification and acknowledges it back to OneSignal.
Devices that are offline or retired will not receive push notifications. This is common when users change or abandon devices.
Tips for re-engagement:
Common Cause: Misconfigured of both the Notification Service Extension (NSE) and App Groups.
Must-haves:
group.your-main-app-target-bundle-id.onesignal
group.your-bundle-id.OneSignalNotificationServiceExtension.onesignal
mutable-content
set to 1
. This happens automatically, but you may be setting it to 0
in your code.If issues persist, see Troubleshooting the iOS Notification Service Extension guide for more debugging steps.
OneSignalSDKWorker.js
Service Worker script references the correct v16 script:
Case | Description |
---|---|
Displayed but NOT Confirmed | Device shows the notification but doesn’t report to OneSignal due to network error or crash. |
Confirmed but NOT Displayed | Notification received but not seen by user due to:
|
Delivered but NOT Confirmed and NOT Displayed | Not Confirmed because of message deduplication:
|
Need help?
Chat with our Support team or email support@onesignal.com
Please include:
We’re happy to help!
Understand how OneSignal tracks confirmed push notification deliveries across platforms like iOS, Android, and Web. Learn how to enable it, troubleshoot issues, and interpret delivery confirmation status.
Confirmed Delivery tracks whether a device has actually received a push notification sent via OneSignal. This information appears in the notification’s Message Report under the status “Confirmed” or “Received.”
Once a push notification is successfully delivered to a device, the OneSignal SDK sends a receipt event back to OneSignal’s servers.
Confirmed Deliveries Flow
Push notifications are sent from OneSignal through platform-specific services (APNs for iOS, FCM for Android, etc.). Confirmed Delivery events happen only after the OneSignal SDK on a device successfully receives a notification and acknowledges it back to OneSignal.
Devices that are offline or retired will not receive push notifications. This is common when users change or abandon devices.
Tips for re-engagement:
Common Cause: Misconfigured of both the Notification Service Extension (NSE) and App Groups.
Must-haves:
group.your-main-app-target-bundle-id.onesignal
group.your-bundle-id.OneSignalNotificationServiceExtension.onesignal
mutable-content
set to 1
. This happens automatically, but you may be setting it to 0
in your code.If issues persist, see Troubleshooting the iOS Notification Service Extension guide for more debugging steps.
OneSignalSDKWorker.js
Service Worker script references the correct v16 script:
Case | Description |
---|---|
Displayed but NOT Confirmed | Device shows the notification but doesn’t report to OneSignal due to network error or crash. |
Confirmed but NOT Displayed | Notification received but not seen by user due to:
|
Delivered but NOT Confirmed and NOT Displayed | Not Confirmed because of message deduplication:
|
Need help?
Chat with our Support team or email support@onesignal.com
Please include:
We’re happy to help!