9

Journeys Message Metrics Source

Customer.io Journeys automatically acts as multiple sources of data in Data Pipelines: one source for Journeys Message Metrics and individual sources for each set of Journeys (Track) API credentials. This page is specifically about Journeys Message Metrics. If you want to learn more about using our Track API, web SDK, and mobile SDKs as Data Pipelines sources, see the Journeys API page.

How it works

Journeys captures events relating to message activity—the messages you send, whether or not people open them, when people click them, and so on.

By default, we also forward these events to Data Pipelines as a source. This is the default Journeys Message Metrics source that you see on the Connections page in Data Pipelines.

Treating incoming Journeys metrics as a source lets you send data to destinations that help you aggregate and analyze audience data, so you follow and chart how your audience reacts to different message channels in your marketing stack.

What metrics do we send to Data Pipelines?

Journeys Message Metrics are the same events we track with reporting webhooks. These include Customer subscribe/unsubscribe events, and events representing the message lifecycle for each message (email, SMS, push, etc).

Metric Events in Data Pipelines

We map properties from Journeys to Data Pipelines. You can see the complete list of properties in each event in our reporting webhooks. But we’ve provided an example below to show how a metric event recorded in Journeys maps to Data Pipelines.

The event name is the channel and metric—like Email Opened as shown in the example below.

The properties object contains information about the customer, the message (delivery_id), the campaign, broadcast, or transactional ID the message originated from, and so on.

{
  "type": "track",
  "event": "Email Opened",
  "userId": "12345",
  "messageId": "01H8F21G9KK14JKX233RDFJCNM",
  "timestamp": "2023-08-22T16:42:55.003Z",
  "sentAt": "2023-08-22T16:42:57.739Z",
  "context": {
    "integration": {
      "name": "customer.io",
      "version": "2.0.0"
    },
    "traits": {},
    "ip": "35.225.6.73",
    "userAgent": "Customer.io/go1.20.4 (test; +https://customer.io/actions)"
  },
  "properties": {
    "customer_id": "12345",
    "delivery_id": "RKK4AwUAAYoeIC5PHMYd6-vTAYhWkQ==",
    "recipient": "cool.person@example.com",
    "subject": "Password reset request",
    "transactional_message_id": 8,
    "userId": "12345"
  },
  "integrations": {
    "Customer.io": false,
    "Customer.io (Actions)": false
  },
  "receivedAt": "2023-08-22T16:42:57.742Z",
  "originalTimestamp": "2023-08-22T16:42:55.000Z"
}