Send audiences to Klaviyo¶
Klaviyo is an email platform for targeting, personalizing, measuring, and optimizing email and Facebook campaigns.
Note
This destination uses the Klaviyo REST API .
Amperity uses the Update Profile endpoint in the Klaviyo REST API to send customer profile attributes to Klaviyo.
Review the rate limits that are applied to endpoints in the Klaviyo REST API to manage customer profiles.
Before sending a set of customer profiles to Klaviyo, and to help set expectations, you should review the rate limits and estimate the amount of time required to complete the process of adding your set of customer profiles to Klaviyo.
This topic describes the steps required to configure campaigns to send email address lists to Klaviyo.
Note
Ask your DataGrid Operator or your Amperity representative for help configuring Klaviyo as a destination to which you can send campaigns for customer activation.
Build a segment¶
Use the Segment Editor to build any audience using a series of drop-downs and picklists.
As you define the attribute profile for an audience be sure to refresh segment insights to view audience size and to see the value it brings to your business.
When the segment is ready, activate it, and then use it use it in a campaign to send to your preferred destinations for customer activation.
Which attributes should you use?
You can use any attribute that is in your customer 360 database to define your audience.
When sending the list of customers who belong to this audience to Klaviyo as part of a campaign you must choose specific attributes to send.
Klaviyo supports the following attributes: email address lists.
Add to a campaign¶
Use the campaign editor to configure Amperity to send data to Klaviyo. Add a segment, define exclusions and sub-audiences, and then define each audience sent to Klaviyo.
To add Klaviyo to a campaign
![]() |
Open the Campaign Editor. This is available from the Campaigns page. Click the Create campaign button in the top right corner of the page. |
![]() |
Assign Klaviyo as a destination for at least one treatment group. ![]() Note You may need to edit the attributes for the sub-audience to ensure Amperity is sending the right data to Klaviyo. |
![]() |
Click Edit attributes to review the attributes that Amperity sends to Klaviyo. Klaviyo requires only email addresses. You may configure campaigns to send additional customer profile attributes. Amperity pre-selects the list of attributes sent to Klaviyo. The Edit attributes page for Klaviyo is similar to: ![]() Note The Merged Customers table is the default table for sending data to Klaviyo, even though segments are often built against the Customer 360 table. This is by design. The Merged Customers table is the underlying table for customer profile data and is the source for all customer profile data that exists within the Customer 360 table. |
Configure default attributes¶
Each unique destination configured to send treatment group audiences to Klaviyo has a set of default attributes.
Configure default attributes by clicking the Default attributes link next to the Create campaign button on the Campaigns page.
The source table defaults to the Merged Customers table for most attributes. This is configurable.
Klaviyo has the following requirements for attributes.
Source attribute |
Destination attribute |
---|---|
Customer profile attributes |
Review the list of customer profile parameters your brand can send to Klaviyo. These may be configured as default attributes in Amperity. |
Customer profile parameters¶
The following table describes the parameters that may be sent to Klaviyo. Use the properties field to define a series of custom properties (as key/value pairs) to represent offline events.
Amperity uses the Update Profile endpoint in the Klaviyo API to send customer profile attributes to Klaviyo.
The list of customer profile parameters supported by Klaviyo are described in the following table. Parameters are listed alphabetically, but may be returned in any order.
Field name |
Description |
---|---|
address1 |
Optional The address connected with the location of a customer, such as “123 Main Street”. |
address2 |
Optional Address information, such as an apartment number or a post office box, connected with the location of a customer, such as “Apt #9”. |
city |
Optional The city connected with the location of a customer. |
country |
Optional The country connected with the location of a customer. |
Required The email address connected with a customer. A customer may have more than one email address. Important An email address is used by Klaviyo to generate a unique customer identifier for each customer profile that exists within Klaviyo. This email address is most often found in the email field in the Merged Customers table, but may be located elsewhere depending on how your brand has configured your customer 360 database and depending on the downstream use cases your brand wants to enable within Klaviyo. |
|
external_id |
Optional A unique identifier that associates Klaviyo profiles with customer profiles that exist within an external system. For example, a unique ID for a point-of-sale system or the Amperity ID. |
first_name |
Optional The first name connected with a customer. |
image |
Optional A URL that points to the location of a profile image for this customer profile. |
ip |
Optional An IP address that is associated with this customer profile. |
last_event_date |
Optional A timestamp for an event that is associated with this customer profile. For example, the date and time of the most recent transaction from your brand’s website or store. |
last_name |
Optional The last name connected with a customer. |
latitude |
Optional A latitude coordinate that may be used to define location-based segments in Klaviyo. Note This value should have a precision of four decimal places. |
longitude |
Optional A longitude coordinate that may be used to define location-based segments in Klaviyo. Note This value should have a precision of four decimal places. |
organization |
Optional The company, typically an employer or small business, connected with a customer. |
phone_number |
Optional The phone number connected with a customer. A customer may have more than one phone number. Note A phone number must be in E.164 format, which represents a phone number as a number up to fifteen digits in length (without spaces) that starts with a + symbol. For example: +12061234567. |
properties |
Optional A series of custom properties represented as key/value pairs for additional data that your brand wants to associate with this customer profile. For example, a store ID or the name (or SKU) of the most recent product purchase associated with this customer profile. |
region |
Optional The state or province connected with the location of a customer. |
timezone |
Optional The name of a timezome. Klaviyo recommends using the name of a timezone in the IANA Time Zone Database . |
title |
Optional The title that precedes a full name connected with a customer, such as “Mr”, “Mrs”, and “Dr”. |
zip |
Optional The zip code or postal code connected with the location of a customer. |