Segment export: Klaviyo

Prerequisites

To export to Klaviyo, this destination must be set by the administrator. 

Exportable

Exportable shows how many customer profiles will be exported to your destination.

This number is defined by the conditions you choose to segment the audience and mandatory attributes set up by the administrator (that must be present to export to your destination).

For example, if you segment 1000 profiles, but only 10 have mandatory attributes present, only those 10 will be exported to your destination.

Mandatory attributes are visible in the Data Library/ Destinations tab.

For exports to Klaviyo, the mandatory attribute are:

Email

Parameters

One of  list-name or list-id is required

• If list-id is provided the component will expect the list already exists and will update the contacts in it
• If list-name is provided the component will create the list with the given name and populate it

If both list-id and list-name are provided the component will update the contacts, however, will NOT rename the list in case a different name is provided

Data Requirements

Input file structure

• Component expats export.ndjson file
• Each line contains one contact object that will be exported to Klaviyo
• Email address is required
• Each additional JSON attribute on the contact object will be pushed to Klaviyo contact as custom property

Example:

{
   "email":"callum.dempsey@gmail.com",
   "first_name":"Callum",
   "last_name":"Dempsey",
   "product":{
      "product_name":"Race Car",
      "product_price": "15",
      "product_category":"Car miniatures"
   }
}

{
   "email":"jane@doe.com",
   "first_name":"Jane",
   "last_name":"Doe",
   "product":{
      "product_name":"Lego",
      "product_price": "25"
   }
}

{
   "email":"antonio.rivera@gmail.com",
   "first_name":"Antonio",
   "last_name":"Rivera",
   "phone_number":"+420731145567"
}

Does export create a new audience or update an existing one?

If list-name is provided the component creates a new Contact List

If list-id is provided the component updates contacts in the Contact List. 

The Contact List must exist in this case or the component will fail.

Can I add a new contact list?

Yes. When you provide a list-name but no list-id the component created a new Contact List.

Can I update the existing contact list with new customer profiles?

Yes. Provide an existing list-id and the component will add or update the contacts in the list. Contacts are never deleted from the list.

Are there any limits for exports?

There are no (known) limits on the number of contacts.

What data is exported to Klaviyo?

In the most simple use case, only emails will be exported to Klaviyo. However additional attributes can be exported as well, including nested JSON objects.

Data analysts need to prepare the correct data structure for the component.