42

Capture Push Metrics

How it works

Customer.io supports device-side metrics that help you determine the efficacy of your push notifications: delivered when a push notification is received by the app and opened when a push notification is clicked.

As of version 1.0.0-beta.14 of our Expo plugin, we track both opened and delivered metrics automatically for you.

Beginning in version 1.0.0-beta.14 of our Expo plugin, the SDK automatically tracks opened and delivered events for push notifications originating from Customer.io. No more code is required for your app to track opened push metrics or launch deep links!

Read the sections below to see how you can add (optional) custom handling to various push events.

Choose whether to show push while your app is in the foreground

If your app is in the foreground and the device receives a Customer.io push notification, your app gets to choose whether or not to display the push.

To configure this behavior, set the following option in your Expo config file:

{
   ...
   "plugins": [
      ...
      [
        "customerio-expo-plugin",
        {            
            "ios": {
                "showPushAppInForeground": true,
            }
         }
      ]
   ]
}

If the push did not come from Customer.io, you’ll need to perform custom handling to determine whether to display the push or not.

Custom handling when users click a push

You might need to perform custom handling when a user clicks a push notification—like when you want to process custom fields in your push notification payload.

Follow our React Native SDK guide to setup handling in your app.

Custom handling when getting a push while the app is foregrounded

If your app is in the foreground and you get a push notification, your app gets to choose whether or not to display the push. For push notifications originating from Customer.io, your SDK configuration determines if you show the notification. But you can add custom logic to your app when this kind of thing happens.

Follow our React Native SDK guide to setup handling in your app.

Manually track push metrics

Follow our React Native SDK guide to setup manual push metrics in your app.

Disabling automatic push tracking

If you have a more advanced use case and want to manually track push metrics, you can disable automatic push tracking with the autoTrackPushEvents option in your Expo config.

{
   ...
   "plugins": [
      ...
      [
        "customerio-expo-plugin",
        {            
            "ios": {
                "autoTrackPushEvents": false,
            }
         }
      ]
   ]
}