Skip to content

Push Notifications Console

Notification Statuses

Successful delivery depends on multiple factors, including:

  • Notification attributes, such as push priority and push type
  • The destination device, such as the device’s power state
  • External factors, such as the device’s connection quality (both cellular and Wi-Fi)
  • A person’s actions, such as disabling push notifications or background refresh

Delivery Flow

APNs discards a push notification for a number of reasons:

  1. Your push token is no longer active on the destination device because a person removed your application or the push token for your application changes.
  2. A person disabled push notifications for your app in Settings on the destination device.
  3. The push notification expires.

notifications-delivery-flow

Delivery From Storage

When APNs tries to deliver a notification from the APNs persistent storage, it might get delivered successfully or get discarded, depending on a number of factors.

store-notifications-flow

Metrics

notifications-metric

  • Received by APNs
  • Delivered to Device
  • Delivered to Device (From Storage)
  • Stored - Device Offline means APNs stored the notification because the device was offline.
    A notification for an offline device may get delivered later when the device is back online. For that notification, saving in APNs storage and delivery are seperate data points for a single notification.
    Check the number of notifications preserved in APNs storage for offline devices and compare it with the number of push notifications delivered from APNs storage. If the former is significantly higher, it’s a strong indication that a large volume of notifications are sent to devices that aren’t active with APNs.
  • Stored - Power Considerations
  • Discarded - Token Unregistered
  • Discarded - Token Unregistered (From Storage)
  • Discarded - Expired
  • Discarded - Disabled means users disable push notifications.
  • Discarded - Disabled (From Storage)

References