Setting Up Delivery and Clicks Analytics

Notification delivery and open rates allow you to analyze the success of your mobile push campaigns in more detail. To display this data in Yespo, you need to implement the return of the status of messages to our system.

Before proceeding with this step, connect your app to your Yespo account and upload the contact database.

Choose one of the two available methods for transferring push notification status data from your app.

Public API

Use this Update interaction status API method to return DELIVERED status (if the notification was delivered to the device).

In addition to the status value in interactionId, also pass the FCM token and the time of status change on the device in the request's body.

Example:

{
    "token": "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "status": "DELIVERED",
    "time": "2020-07-09T15:11:17"
}

There are differences for exporting message delivery data from different operating systems.

iOS

Getting a report on push notifications is possible using Notification Service Extension and calling the API inside the service extension.

1. Add Notification Service Extension to your app.
2. In didReceiveNotificationRequest add your code for calling web service to report to your server about the received message.

• override func didReceive (_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) → Void)
• didReceiveNotificationRequest should consist of a http request (PUT) with delivered status to Update interaction status.

Enable Background fetch in Capabilities → Background Modes of your app.

Learn more about modifying content in delivered notifications in Apple's guide.

Android

Use a service that extends FirebaseMessagingService to receive messages. A service should override the onMessageReceived and onDeletedMessages callbacks.

Tracking click-through rates

In the message editor, you can add a link to the message body without being able to analyze its click rate.

When adding a link, two more fields - es_link_raw and es_link - will be passed in the push notification body:

• es_link_raw – http://example.com/somelink – contains the original link that can be opened in the device’s browser or can be an internal link, directing to other app sections;
• es_link – https://hh.esclick.me/37NdHw333DjRcukc0l – created based on the added link and contains a wrapped link used for click tracking.

Integration with Firebase Message Cloud and BigQuery

BigQuery allows you to process large amounts of data, analyze it in detail using BigQuery SQL, export the information to other services, and or use the data for your custom machine learning models. In order to transmit the statuses of sent mobile notifications to Yespo through this platform, you need to follow these steps:

1. Link your project to BigQuery.

2. Set up data export from the app to BigQuery:

• iOS;
• Android.

3. Integrate your Yespo account with BigQuery.