Customer.io provides a marketing automation platform for email, SMS, push messaging, and more. Features include app-event based segmentation and targeting.
In order to enable mParticle’s integration with Customer.io, you will need the Site ID and API Key of your Customer.io account. Both of these can be found on the “Integration” page of your Customer.io console.
mParticle will forward all events logged with the mParticle SDK
logScreen methods along with their attributes. When forwarding events, mParticle will include the timestamp of the events in JSON data format. When forwarding event names, mParticle trims the leading/trailing spaces and replace spaces with “_”.
mParticle will only forward event and user data to Customer.io for users that have a valid customer id (
MPUserIdentityCustomerId) or an email (
MPUserIdentityEmail) defined. When forwarding user data, mParticle primarly uses
MPUserIdentityCustomerId as the Customer.io user_id. If CustomerId is not defined, mParticle uses the email address instead. mParticle always forwards users’ $FirstName, and $LastName, and will optionally forward all user attributes if the configuration parameter “Include ALL user attributes?” is enabled.
Please note that users who opt out of event tracking via mParticle’s
optOut (in iOS) or
setOptOut SDK methods will be unsubscribed from email communications in Customer.io, but their user profiles will remain in Customer.io.
|The API Key of your Customer.io account. You can find it on the “Integration” page of your Customer.io console.
|The Site ID of your Customer.io account. You can find this ID on the “Integration” page of your Customer.io console.
|User ID Type
|Prefer Customer ID to Email
|This determines how the Customer.io user ID is set. Users missing the select ID cannot be forwarded. Note: ‘Prefer Customer ID to Email’ should only be used if users will not have customer IDs assigned after email. If that is selected and a user has a customer ID assigned after an email, duplicate Customer.io profiles might be created.
|Specify which Customer.io site your credentials belong to
|Include user attributes
|If enabled, mParticle will forward all user attributes to Customer.io. If disabled, mParticle will just send the users’ first and last names (so that they can be properly addressed in email campaigns).
|Send User’s Created At
|If enabled, mParticle will forward a value for user’s created_at field (the UNIX timestamp from when the user was created in the system). This value is first configured when a user opens up the application that contains mParticle’s SDK and it doesn’t change over time. It is device-specific, which means that the value will be constant among the same device type (eg. multiple Android devices) for the same user. Each device will have the same email and customer id, but the field will differ across different device types (Android, iOS, MobileWeb, AlexaOS, etc…). The created_at field will overwrite based on whatever device was last seen. Meaning that a user with multiple devices will take the created_at value of whatever the most recent device is.
Was this page helpful?