Klaviyo
Last updated
Last updated
is an an e-commerce focused multi-channel marketing platform. With Klaviyo, businesses of all sizes can deliver personalized experiences across owned marketing channels such as email and SMS.
When integrated with Klaviyo, Freshpaint will create and update user profiles in Klaviyo and associate events with those user profiles.
Accepts and calls
Supports
Connection Modes:
| Client-side | Server-side |
|---|
Go to the Klaviyo in Freshpaint and click "configure".
Find your public Klaviyo API Key under Account > Settings > API Keys and enter it into the Integration Settings in Freshpaint.
By default, email is set as the preferred user identifier in Klaviyo. If for some reason, you would like to prioritize a different identifier, uncheck this box.
Choose a connection mode. You can take a look at the differences between the connection modes in the reference section below.
In order to send events to Klaviyo, you'll need to enable the Klaviyo destination for the desired event in the event definition.
You can see events associated with user profile by clicking into a user profile
You must include one of the following: email, phone, or a unique identifier such as a user ID. If you have the "Use Email as Identifier" box checked under your configuration, Freshpaint will still create a profile in Klaviyo with another identifier. However, if you send an identify call later with an email, Freshpaint will prioritize that email identifier and the profiles will merge under the email address.
If a profile record with the given identifier already exists, Freshpaint will update the existing profile record. If no record with the identifier exists, Freshpaint will create a new user profile.
The following Freshpaint parameters map to Klaviyo's user traits when calling identify:
You can see the newly created/updated user profiles under "profiles" in Klaviyo.
There are some properties that are required for events to be accepted by Klaviyo. You can view them in the table below.
If you are sending a precision tracking event via Freshpaint's track method, or sending Autotrack events either server-side or client-side, Freshpaint will make sure any required properties are attached to the event.
You can view events in Klaviyo under the user's profile.
Events originating from the user's web browser will be sent directly to Klaviyo.
All events will be sent to Klaviyo using Freshpaint's servers. Your website will not send data directly to Klaviyo.
If you are in server-side connection mode you can use the event tester to test certain payloads to see if they are being sent correctly to Klaviyo. Here is an example of an identify event you might test sending to this destination along with the response code from Klaviyo:
In order to create profiles and attribute events to those profiles in Klaviyo, you need to have set up. See below for more on user identification specifically for Klaviyo.
When you call , Freshpaint will create or update a profile in Klavyio.
We highly recommend you consistently identify all individuals using only their email address ($email) or phone number ($phone_number), and do not pass $id values. Inconsistent identifiers sent to Klaviyo will result in inflated user profiles being created in Klaviyo. For more information, see Klaviyo's .
| Freshpaint Parameter | Klaviyo User Trait |
|---|
If you are using client-side connection mode, Freshpaint calls Klaviyo's identify method which calls their .
If you are in server-side connection mode, or if you otherwise have server-side identify calls set up, Freshpaint will create or update a user profile in Klaviyo by calling their at:
When you send events to Klaviyo from Freshpaint in client-side connection mode, Freshpaint creates an event in Klaviyo by calling their front-end Track method, which uses_learnq object to track customers. You can learn more about that .
When you send events to Klaviyo in server-side connection mode, or send server events to Klaviyo, Freshpaint creates an event in Klaviyo by calling their back-end at:
| Argument | Type | Description |
|---|
Both server-side connection mode and client-side mode are available for this destination. You can read more about the different connection modes .
Set up transformations to modify your data before it's sent to your destination. Read more about transformations .
You can read more about the Event Tester .
firstName | $first_name |
lastName | $last_name |
phone or phoneNumber | $phone_number |
title | $title |
id | $id |
| string |
| string | Name of the event you want to track |
| hash/dictionary | Properties of the profile that triggered this event. You must identify the person by their email using a |
| hash/dictionary |
| integer (10 digit unix timestamp) | When this event occurred. By default, Klaviyo assumes events happen when a request is made. If you'd like to track an event that happened in the past, use this property. |
Web |
Mobile |
Server |
Your (six characters long)
Properties of this event. Any properties included here can be used for creating segments later. There are also you can use here, denoted by a $, which map directly to some of Klaviyo’s features.
For example, if you track an event called Ordered Product, you can include a property for item type (e.g. image, article, etc.), size, etc.
