Documentation

Klaviyo provides a complete email marketing platform for Ecommerce businesses. It allows you to segment users based on who they are and what they’ve purchased, and automate the process of sending emails to them for specific reasons (e.g. abandoned carts, product reviews, welcome emails). Klaviyo provides a simple email template and newsletter sign-up form builder as well as a comprehensive analytics suite for evaluating campaign effectiveness.

Events

Certain event properties have special significance to Klaviyo. Replay collects these properties and transforms them so that they fit the expectations of Klaviyo’s API. The following table shows you the properties collected by Replay and the names of the Klaviyo properties to which they are mapped.

Name of Property Collected By Replay Klaviyo Property Name Required to track an event with Klaviyo
event_name event Yes
email customer_properties.$email Yes if no $id
distinct_id customer_properties.$id Yes if no $email
event_id properties.$event_id No
amount properties.$value No
timestamp time No

If you don’t specify $event_id, it will default to the timestamp of the event. In practice, you should send an $event_id if you have an unique identifier for each event, for example an order ID. All the other properities collected by Replay will be mapped into Klaviyo’s properties object.

Traits

Klaviyo also requires certain trait properties in order to create a user profile. User properties collected by Replay are transformed so they fit the expectations of Klaviyo’s API.

Name of Property Collected By Replay Klaviyo Property Name Required to store user profile with Klaviyo
distinct_id $id Yes if no $email
email $email Yes if no $id
first_name $first_name No
last_name $last_name No
phone $phone_number No
title $title No
organization $organization No

Klaviyo supports arbitrary traits, all traits collected by Replay will be mapped into Klaviyo’s properties object.