Klaviyo Source

Klaviyo is an email marketing platform that helps companies make more money. It lets you send personalized newsletters, triggered emails, product recommendations, push notifications and sync your data to facebook custom audiences. Visit Website

Take your company’s email analysis to the next level by adding Klaviyo as a Source to Segment. We’ll automatically collect email events like Email Delivered and Email Opened, forward them to your integrations, 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 Klaviyo 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 Klaviyo with Segment.

Getting Started

If you have previously enabled sending email events via the Klaviyo integration during our beta (using a project write key), you do not need to create new Klaviyo source. Your email data will continue to flow as normal.

  1. From your workspace’s segment.com/<your-workspace>/sources page, click Add source.

  2. Choose Klaviyo.

  3. Give the Source a nickname and a schema name. The nickname will be used to designate the Source in the Segment interface, and the schema name is the namespace you’ll be querying against in your warehouse. You can name them however you’d like, but we recommend sticking to something that reflects the Source itself, like Klaviyo for nickname and klaviyo for the schema name.

  4. The next page (“Overview”) will surface your Segment write key for Klaviyo. Copy this write key.

  5. To finish the setup, you’ll have to go into your Klaviyo account and enter this Segment write key in their integrations settings. Find the right place in Klaviyo by clicking Integrations > Segment.

  6. Click Save.

  7. In Segment, click into your Klaviyo Source in segment.com/<your-workspace>/sources. From there you’ll be able to add Integrations and Warehouses where you want to see email events.

That’s it! As you send emails, events will now be sent to your integrations and automatically loaded into any warehouses you have enabled.

Components

Stream

Klaviyo 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 integration that accepts server-side events, and available in a schema in your data warehouse, so you can query via SQL.

The default behavior is for Klaviyo to pass the userId associated with the email recipient as the userId. There are cases in which Klaviyo does not have an associated userId, in which case the email address will be passed in as the anonymousId.

Collections

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.

CollectionTypeDescription
Email DeliveredEventMessage has been successfully delivered to the receiving server
Email OpenedEventRecipient has opened the HTML message. You need to enable Open Tracking for getting this type of event
Email Link ClickedEventRecipient clicked on a link within the message. You need to enable Click Tracking for getting this type of event
Email UnsubscribedEventRecipient clicked on message’s subscription management link
Email BouncedEventReceiving server could not or would not accept message
Email Marked as SpamEventRecipient marked message as spam

Send data to Klaviyo

The Klaviyo Source works better when you also connect Klaviyo as an integration. With the Klaviyo Integration, you can use Segment to send Klaviyo user and event data from which you trigger email campaigns. Want to start sending website or mobile data TO Klaviyo? Head on over to our Klaviyo integration docs.


If you have any questions or see anywhere we can improve our documentation, please let us know or kick off a conversation in the Segment Community!