Program messaging channel: Push notifications - usage and reporting

Learn how to use the Push notification program messaging node, and view statistics for your push notifications.


When users receive a push notification to their mobile phone through your app, they see the message regardless of whether they are using the app at the time. As a result, you can be sure that your messages aren't lost in a spam filter or buried in an inbox, increasing engagement.

There are lots of ways that you can use push notifications. For example:

  • to send a welcome message to your contacts.
  • with the abandoned cart module to send your contacts abandoned cart reminders.
    To learn more about abandoned carts, check out the article Using abandoned cart.
  • with our Magento connector to send your contacts order confirmations.

Before you start

Things you need to know:

  • To access all of the features of the Push notifications messaging node outlined below, you must upgrade to the latest version of our SDK. To learn more, check out our developer hub.

Use the push notification node in a program

To use the push notification node in your program:

  1. In the program builder, drag the Push notification node onto the canvas.
    To learn more about using program builder, check out the article Getting started with the program builder.
  2. Select the Push notification node to open the side panel.
  3. Enter a title and a message for your push notification.
    A maximum of 160 characters can be displayed in a push notification message and title. Extra characters are replaced by an ellipsis. To insert emojis into your message, copy and paste them from a website such as Emoji Keyboard 😎.

    iOS devices
    On iOS devices, titles are displayed only in the Notification Center. To learn more, check out Apple’s documentation.
  4. Expand the On tap drop-down menu, and choose the action you want to happen when a user taps the push notification:
    1. Open app - Opens the app on the user’s device.
    2. Open deep link - Opens the app at a deep link of your choice.
      You can enter individual deep links (URLs) for iOS and Android users.
      To make use of this option, your app must support any deep links entered. Your app developers can assist you with this.
      The Open deep link action also allows you to enter a standard web URL to send users to, such as a web form or Dotdigital landing page.
      This option is particularly useful if your app does not yet support deep links, for example.
    3. Pass data - For more advanced users, this lets you pass custom JSON data to perform a custom action. You must enter JSON separately for iOS and Android.
      To make use of this option, your app must support receiving data via push and understand any data entered. Your app developers can assist you with this.

  5. If you want to preview your message, select Preview.
    The Preview side panel opens, displaying a mock-up of how your notification will appear. You also see a confirmation of the action you have selected for On tap. You can change the orientation of the device in the preview using the icon in the top right.
    If you have used personalisation in your message and would like to preview as a particular contact, select PREVIEW AS, then select a contact. When you are finished with the preview, select CLOSE.
  6. Select APPLY to finish configuring your notification.

Viewing usage statistics for a push notification profile

The Push notification usage page displays reporting data for your push notification profile.

To access this page:

  1. Go to Settings (⋮) > Channel management > Push Notification.
  2. Select the link under Pushes delivered in the last 7 days.

The page displays four headline tiles detailing the total number of message sends that have been attempted from this profile in the specified date range, and the number successfully sent. It also displays the number of clicks for push notifications sent in the specified date range, along with the number of new warnings.

Further detail on any warnings is found in the Daily activity table at the bottom of this page.


Attempted sends

When a push message send is attempted, the message is added to a queue, which is managed by either Apple (APNS) or Google (FCM), depending on your app.

When a message leaves the queue, the message is sent to your contacts' devices. There is no way to find out if a push message was delivered.

The page also displays a graph which plots the total number of push notifications sent along with the total number of push clicks.


Finally, the page displays a Daily activity table which shows the following:

  • Date
    The date push notifications were sent.
  • Attempted to send
    The number of push notifications that the platform tried to send to your contacts.
    A push notification send may not succeed; this is most often due to the recipient having opted out of receiving push notifications and therefore when you next send a push to them it fails. Dotdigital detects this and clears the contacts PushOptin field to remove the contact from your push audience.
  • Sent
    The number of push notifications the platform was able to send to your contacts.
  • Clicked
    The number of clicks made by users on your push notifications.
  • Warnings
    Information about push notifications that could not be sent.

Filter the Push notification usage page

To change the date range for the information displayed:

  1. Select DATE RANGE in the top right.
  2. Select the radio button for either Pre-defined date range or Custom date range.
    1. Pre-defined date range
      Expand the Date range drop-down menu and select the date range you want to display.
    2. Custom date range
      Select the calendar icon next to Start date and End date, and select a date for each.
  3. Select APPLY.

You can also filter the information on this page to show only push notifications sent by a particular program.

To do this:

  1. Select FILTER in the top right.
  2. In the side panel, select the program you want to display data for.
    You can use the Search field to locate a particular program.
  3. Select APPLY

See also

Did you find this article helpful?

Can we help?

Thanks for using Dotdigital. If you need more help or support, then contact our support team.