mParticle integration

mParticle is a customer data platform that allows you to unify your customer data and connect it anywhere to improve marketing performance, enhance analytics, and transform the customer experience. With mParticle you can easily connect Customer.io to your data stream to begin receiving real time event and audience data in Customer.io.

Send Events to Customer.io

Send event data to Customer.io by setting up Customer.io as an Event Output in mParticle. From the mParticle activity overview screen select Setup > Outputs > Event > Add Event Output and select or search for Customer.io from the dropdown list.

Customer.io Mparticle Add Event Output
Customer.io Mparticle Add Event Output

Next navigate to the Customer.io workspace you’d like to send your data to. From the main dashboard select > Integrations > Customer.io API (Settings). Here you will find your Site ID and API Key.

Customer.io Mparticle API Key
Customer.io Mparticle API Key

Next enter your API Key and Site ID keys into mParticles event configuration, name the configuration, and select the settings relevant to you.

Mparticle Customer.io Event Configuration
Mparticle Customer.io Event Configuration

Success! –– You have connected mParticle to Customer.io for Events

Send Audience data to Customer.io

Send audience data to Customer.io by setting up Customer.io as an Audience Output in mParticle. Start by navigating to the mParticle activity overview screen. Click Setup > Outputs > Audience > Add Audience Output and select or search for Customer.io from the dropdown list.

Customer.io Mparticle Add Audience Output
Customer.io Mparticle Add Audience Output

Next navigate to the Customer.io workspace you’d like to send your data to. From the main dashboard select > Integrations > Customer.io API (Settings). Here you will find your Site ID and API Key

Customer.io Mparticle API Key
Customer.io Mparticle API Key

Next enter your API Key and Site ID keys into mParticles audience configuration, name the configuration, and select the settings relevant to you.

Mparticle Customer.io Audience Configuration
Mparticle Customer.io Audience Configuration

 Create One user Attribute per Segment:

If enabled, mParticle will forward membership information for each segment as a seperate user attribute. For example, if you’re forwarding a segment named “New Users” mParticle will forward membership information for this segment in a user attribute called “In New Users, with a value of “true” or “false”. If disabled, mParticle will forward a single user attribute called “Segment Membership”, and it’s value will be a comma-separated list of mParticle segment IDs that the user is a member of, wrapped in single quotes. If you’re unsure what to select here we recommend enabling this feature.

Success! –– You have connected mParticle to Customer.io for Audience

Send message event data to mParticle

By setting up Customer.io as an mParticle Feed, you can pipe messaging activity out of Customer.io and into any one of mParticle’s hundreds of Output integrations. Data will be sent to mParticle as a custom event.

Setup

  1. Start by creating a new Input Feed in mParticle. Click Setup > Inputs > Feeds > Add Feed Input and select or search for Customer.io from the dropdown list.

    mparticle_add_feed_input.png
    mparticle_add_feed_input.png

  2. In the Feed Configuration modal, name your configuration and click Save to get your Server Token and Secret. You’ll need these to configure the integration in Customer.io.

    mparticle_configure_feed_input.png
    mparticle_configure_feed_input.png

  3. In Customer.io go to Data & Integrations > Integrations and click the mParticle Source card.

  4. Enter your mParticle Server Key and Secret and click Connect to test the connection.

    Add your mParticle credentials
    Add your mParticle credentials
  5. Select the events that you want to send to mParticle, enable the integration, and save your changes to start sending events from Customer.io to mParticle.

     Send only the first time the event occurs:

    This setting tells Customer.io to forward messaging events the first time they occur, and only the first time they occur. We won’t send subsequent events, even if a customer opens or clicks on a message multiple times. If you’re unsure what to select here we recommend that you select this option.

    Select the events you want to send
    Select the events you want to send

Events

The following events are available in the feed:

NameDescription
email_sentAn email was sent from Customer.io to the delivery provider
email_deliveredThe delivery provider reported the email was delivered to an inbox
email_openedAn email was opened
email_clickedA tracked link in an email was clicked
email_convertedA person matched a conversion goal attributed to an email
email_bouncedThe delivery provider was unable to deliver the email
email_spammedAn email was marked as spam by the recipient
email_failedAn email couldn’t be sent to the delivery provider
push_sentA push notification was sent from Customer.io to the delivery provider
push_openedThe app on a person’s device reported the push notification was opened
push_clickedA tracked link in a push notification has been clicked
push_convertedA person matched a conversion goal attributed to a push notification
push_bouncedThe delivery provider reported at least one invalid device token
push_failedA push notification couldn’t be sent to the delivery provider
sms_sentAn SMS was sent from Customer.io to the delivery provider
sms_deliveredThe delivery provider reported the SMS was delivered
sms_clickedA tracked link in an SMS has been clicked
sms_convertedA person matched a conversion goal attributed to an SMS
sms_bouncedThe delivery provider was unable to deliver the SMS
sms_failedAn SMS couldn’t be sent to the delivery provider

If you have a specific request for an event not listed here that you would like to be notified of, please let us know at win@customer.io.

Event Attributes

AttributeDescription
action_idIf the delivery was created as part of a Campaign or API Triggered Broadcast workflow, this is the ID for the unique workflow item that caused the delivery to be created. It can be used to retrieve full message details, including content, via the Campaign endpoint of our API.
broadcast_idIf applicable, the ID of the API Triggered Broadcast that generated the message. It can be used to retrieve full message details, including content, via the Campaign endpoint of our API.
campaign_idIf applicable, the ID of the Event-triggered, Segment-triggered, or Date-triggered Campaign that generated the message.
content_idIf the message was part of a newsletter split test, this is the ID of the split test variation.
delivery_idThe unique ID of the delivery record associated with the message.
journey_idThe ID for the path a person went through in a Campaign or API Triggered Broadcast workflow. In our Data Warehouse Sync, this is referred to as subject_id.
newsletter_idIf applicable, the ID of the Newsletter that generated the message. It can be used to retrieve full message details, including content, via the Newsletters endpoint of our API.
recipientThe address of the message recipient. This could be an email address, a phone number, a mobile device ID, a Webhook URL, or a Slack username or channel.
source_message_idThe unique ID of the event being sent. This can be useful for deduplicating purposes.
timestamp_unixtime_msThe timestamp at which the event being reported took place.

Additional Documentation

Copied to clipboard!
Is this page helpful?