Good to know: Event source
The Customer.io Source is an event source. This means that it sends data as events, which are behaviors or occurrences tied to a user and a point in time. Data from these sources can be loaded into your Segment warehouses, and also sent to Segment streaming destinations. Learn more about cloud sources.
Customer.io is an automated email tool. It lets you set up rules to automatically send emails to your users after they perform actions, making drip email campaigns really easy.
Take your company’s email analysis to the next level by adding Customer.io as a Source to Segment. Segment automatically collects email events like
Email Delivered and
Email Opened, forward them to your destinations, and load them into your data warehouse.
In your favorite BI or analytics tool, you’ll be able to analyze your email campaigns in SQL or through drag-and-drop reports. And, you’ll be able to join your Customer.io data with the event data you’re already sending through Segment to analyze the down-funnel effects of your emails. Learn more about how you can use Customer.io with Segment.
Good to know: This page is about the Customer.io Segment source, which sends data into Segment. There’s also a page about the Customer.io Segment destination, which receives data from Segment!
If you have previously enabled sending email events using the Customer.io destination during our beta (using a project write key), you do not need to create new Customer.io source. Your email data will continue to flow as normal.
From your workspace’s
segment.com/<your-workspace>/sourcespage, click Add source.
Give the Source a nickname and a schema name. The nickname is a label used in the Segment interface, and the schema name is the namespace you query against in your warehouse. We recommend using a name that reflects the Source itself, like
Customeriofor nickname and
customeriofor the schema name.
The next page (“Overview”) displays your Segment write key for Customer.io. Copy this write key.
To finish the set up, go to your Customer.io account, go to Settings > Integrations > Segment, and enter the Segment write key.
In Segment, click into your Customer.io Source in
segment.com/goto-my-workspace/sources. From there you’ll be able to add Destinations where you want to see email events.
That’s it! As you send emails, events will now be sent to your destinations and automatically loaded into any warehouses you have enabled.
Customer.io uses our stream Source component to send Segment email events. It uses a server-side
track method to send data to Segment. These events are then available in any destination that accepts server-side events, and available in a schema in your data warehouse, so you can query using SQL.
The default behavior is for Customer.io to pass the
userId associated with the email recipient as the
userId. There are cases in which Customer.io does not have an associated
userId, in which case the email address will be passed in as the
Collections are the groupings of data we pull from your Source. In your warehouse, each collection gets its own table, as well as a
tracks table that aggregates all the events into a single table.
|Email Delivered||Event||Message has been successfully delivered to the receiving server|
|Email Opened||Event||Recipient has opened the HTML message. You need to enable Open Tracking for getting this type of event|
|Email Link Clicked||Event||Recipient clicked on a link within the message. You need to enable Click Tracking for getting this type of event|
|Email Unsubscribed||Event||Recipient clicked on message’s subscription management link|
|Email Bounced||Event||Receiving server could not or would not accept message|
|Email Marked as Spam||Event||Recipient marked message as spam|
Send data to Customer.io
The Customer.io Source works better when you also connect Customer.io as a destination. With the Customer.io Destination, you can use Segment to send Cusotmer.io user and event data from which you trigger email campaigns. Want to start sending website or mobile data TO Customer.io? Head on over to our Customer.io destination docs.
This page was last modified: 20 Oct 2020
Questions? Problems? Need more info? Contact us, and we can help!