Push Notifications - Tracking

Push Status

A push notification can have several different statuses as it goes through the process of being sent. When we attempt to deliver these, you may have told us to try reaching them on one or multiple devices. The status we display represents whether or the intended person was reached on any device. We do still track the response from all API calls; this way, you will be able to know which device(s) specifically failed or were successful.

Attempted

We show a status of “Attempted” until we’ve either succeeded or failed to reach all targeted devices.

This status means that your push notification has been created and we’ve tried to send it via the appropriate service — FCM for Android or APNS for iOS — which then would send to your customer’s device. If there are errors with our attempt, we’ll try to send it again up to ten times.

Sent

If your push notification is sent successfully for at least one device (that is, the push notification service accepted the request and is trying to deliver it to a device) and all the other devices have reached a final state, we mark it as Sent for the successful device.

Please note: Sent doesn’t mean successful delivery - it only means that the push notification service considered the device token valid and is attempting to send it. It’s possible that the device is offline and there is no guarantee the device will come back online to receive it.

Failed

If none of the attempts to send a push notification to the end-user’s device(s) are successful, then we mark the message as Failed. You’ll be able to see the failure reasons on the Delivery page.

Converted

This is treated the same as emails; when a user meets your campaign conversion goal, they are marked as Converted.

Campaign Overview data

At the bottom of your campaign overview, you’ll be able to see metrics for your push notifications.

image.png
image.png

We’ll also show an error rate for each message. This is the percentage of all messages in a campaign which were returned failed.

Opened

We are not able to automatically track the “Opened” metric. To track opened, you’ll first need to add some code to your app to detect when the open occurs and then send an event to our API as documented in our Technical Integration Guide. Note, you’ll need to include the CIO-Delivery-ID and CIO-Delivery-Token parameters from the push per the instructions linked above.

Delivery Logs data

image.png
image.png

When filtering deliveries, you can choose to only see push notifications. In this view, you’ll be able to see:

  • a name and link to the individual push notification
  • which customer triggered that message, and how many of their devices we attempted to send to
  • when the push notification was attempted
  • The push notification status (sent, failed, attempted, etc.)
  • conversion information

You’ll also have the option to retry sending the push notification if its status is ‘failed’:

image.png
image.png
Copied to clipboard!