Report push metrics

While this endpoint still works, you should take advantage of our universal metrics endpoint. It supports channels besides push and lets you provide additional information with some metrics.

Use this endpoint to report device-side push metrics—opened, converted, and delivered—back to Customer.io, so you can track the effectiveness of your push notifications. Customer.io has no way of knowing about these metrics, or associating metrics with a specific message, unless you report them back to us.

When Customer.io delivers a push notification, we include CIO-Delivery-ID and CIO-Delivery-Token parameters. Reference these in your payload as the delivery_id and device_id respectively with the type of device-side event metric that you want to associate with your push notification and the person represented by the device_id.

post/api/v1/push/events

Request body

delivery_idstring

The CIO-Delivery-ID from the notification that you want to associate the event with.

event'opened' | 'converted' | 'delivered'

The type of device-side event you want to report back to Customer.io.

device_idstring

The CIO-Delivery-Token representing the device that received the original notification.

timestampinteger

The unix timestamp when the event occurred.

Example request

{
  "delivery_id": "RPILAgUBcRhIBqSfeiIwdIYJKxTY",
  "device_id": "CIO-Delivery-Token from the notification",
  "timestamp": 1613063089
}

Response

The request was received.

Changes

No recorded changes to this endpoint across all 1 revision of this API.