When you integrate a third-party application with Klaviyo, the two platforms exchange information. Most data exchange with Klaviyo is one-way; data is pulled into your Klaviyo account so you can leverage a broad scope of your customers' data within Klaviyo. In this article, we'll provide a brief overview of what types of data are exchanged between Klaviyo and external apps, and where that data is found in your Klaviyo account.
Types of Data
Klaviyo syncs several types of data with external applications:
- Event Data
Events are populated along a customer's timeline each time they take a certain action. Each event - such as Active on Site, Placed Order, or Fulfilled Order - is known as a metric. There can be multiple instances of metric data for one contact, as long as they take the corresponding action more than once. For instance, when a customer places several orders on your website, they will have several Placed Order metrics listed on their timeline.
- Profile Data
Profile data describes an aspect of a contact's identity, and is made up of both Klaviyo properties and custom properties. Klaviyo properties are natively tracked within Klaviyo and include attributes such as First Active, Last Active, Source, First Name, and Last Name. Custom properties are additional profile data which you can create and are often specific to your business. Common custom properties include gender, birthday, or product preference. Custom properties can also be pulled in through third-party integrations, which allow you to import reviews, ratings, and other information not natively tracked in Klaviyo.
- Catalog Data
Catalog data describes items found within your product catalog. This data is frequently modified on your ecommerce platform as you add or remove products from your store. Examples of catalog data include variants such as color and size. Within Klaviyo, catalog data is pulled in and used to populate product feeds, campaigns, and flow messages.
Event data can be viewed in the following places within Klaviyo:
- Dashboard Activity Feed
- Profile Event Timeline
- Profile Metrics Snapshot
- View metadata
- Metrics tab in Analytics
All event data associated with a customer can be found in their profile. Since you can use event data to build targeted segments and filter flows, you'll find event metrics listed as options within the segment and flow builders.
Use event data to filter and split your flow messaging and to create key segments of your customers to send to. This personalization will make your messaging more relevant to your subscribers, aligning your brand with their journey.
You can view a timeline of events associated with a customer within their profile. In your Klaviyo account, navigate to the Profiles tab and select a customer profile.
By default, the events filter is set to All Metrics. To change this metric, select another option from the dropdown.
Each profile has a METRICS snapshot located on the right-hand side. This section quantifies activity both from the last 30 days as well as from all-time. To adjust the metrics shown within this section, click Edit and select the metrics you want to see.
You can choose to display any and all events your customer has experienced in this section.
If a metric is more complex, it can have additional, related data associated with it. This is known as metadata. The information tracked in the metadata will vary according to the metric type. Simple metrics, such as Received email, have no associated metadata since there’s no additional data to track with the metric. A Placed Order metric, however, is considered to be a complex metric, since it can include the following details about the items in the order: price, style, quantity, discounts, etc.
Within a customer's event timeline, data associated with an event can be viewed in two places:
- Metric Details
Click Details beneath the metric listing.
Not every metric contains metadata, but when there is metadata associated with a metric, you’ll see it in Details.
This Placed Order event includes metadata related to Item, Quantity, Discounts, etc.
All metadata listed in this section can be used in both the segment builder and the flow builder.
- Metric Timestamp
Click on the timestamp to the right of an event to open an Activity Details window.
Activity Details contains a list of all metadata associated with the metric. Top-level attributes such as Collections, Discount Codes, and Items can be collapsed and expanded to display even more detailed information.
All data listed within Activity Details except for data listed in the extra section can be used in both the segment builder and flow builder. Data from the extra section can only be used in the flow builder, to populate flow email templates.
For example, the extra section may contain images or prices of items. Use this data to populate your abandoned cart emails with images and prices of items your customers left behind.
Navigate to Analytics > Metrics to see a list of all tracked metrics. Metrics include events tracked by Klaviyo, as well as events synced through third-party apps. Each metric has an associated icon that indicates where the metric is coming from: Klaviyo-originated metrics are associated with a Klaviyo icon, API-originated metrics are associated with a gear icon, and Shopify-originated metrics are associated with a Shopify icon.
Event Options within Targeted Segments
Event data can be used to define a segment. As a part of the segment set up process, you can choose a definition based on a metric that describes what a customer has or has not done. You can then choose one metric from a list of all metrics available in your Klaviyo account.
In this example, available metrics include Klaviyo metrics, API metrics, Typeform metrics, and Shopify metrics. For a complete list of metrics available, head over to the Metrics section within your Klaviyo account.
Event Options within a Flow Filter
Flows can be filtered based on an event. When you set up a flow filter, you can choose an event metric as part of the filter definition. For example, customers who enter an abandoned cart flow can be filtered out of the flow when they place an order.
In this abandoned cart flow, the Placed Order metric is chosen from the available metrics. Note that the Placed Order event is a Shopify metric, which was synced into Klaviyo when the customer placed an order in the Shopify store.
Event metrics can also be referenced in a flow email by inserting template tags. Template tags pull event data into an email. For example, you can include an image and price of an item in an abandoned cart email. Check out our guide on using template tags and variable syntax for more information.
Profile data and custom profile data can be viewed within your contacts' profile pages. You can also build segments and flows based on profile attributes.
Profile Data Listed on a Contact Record
To find profile data in your Klaviyo account, navigate to the Profiles tab and click on a contact. Both the CONTACT section and the INFORMATION section contain profile data, and the INFORMATION section contains specific Klaviyo properties and custom data.
Each piece of data listed in the INFORMATION section is known as a 'Klaviyo property', while each piece of data listed in the Custom Properties subsection under INFORMATION is referred to as a custom property.
You can add these custom properties to a contact's profile to track specific information about your customers. To learn more, head to our article on Adding Customer Properties to a Contact Profile.
Profile Data within Segment Definitions
You can use profile attributes to build targeted segments. For example, if you’re running a promotional event you’d like to target towards women in La Jolla, CA, you can use the region and gender attributes to build a segment of your contacts who are female and living within a 25-mile radius of that zip code.
Notice that the conditions Properties about someone and Someone's proximity to a location both point to a selection of profile data fields.
Profile Data in Flow Filters
You can pull profile data into flow filters to determine which customers should remain in a flow.
Flows can also be triggered by a date property. For example, Klaviyo's prebuilt birthday flow references a date field that occurs every year.
Head to our article on date property triggered flows for more information.
Catalog data includes information related to your product catalog such as photos, descriptions, and stock information. You can insert catalog data into your campaign and flow emails by embedding a product block in your email templates.
There are several ways to insert catalog items into your product block. Static catalog items can be inserted into a product block, or you can embed a dynamic product feed instead. Dynamic product feeds pull catalog items based on an algorithm, so you can choose to display trending items, best selling items, or a collection of items based on a customer's behavior.
Catalog Data in Campaign Emails
Products can be featured prominently in your campaign emails. For example, you can feature product images, product names, and product prices pulled from your product catalog in your new product launch campaign.
The images featured in this campaign email were inserted as part of a product block and selected manually from a product catalog.
Product Feeds in Flow Emails
Product feeds pull catalog data so they can be displayed dynamically in a customer email. For example, you may want to include a product feed of recommended items in a customer winback flow.
This is the second email within a customer winback where a product feed has been set up to display trending items.