Types of Information Exchanged Between Klaviyo and Apps

read
Last updated at:

Overview

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:

  1. 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.
  2. 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.
  3. 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.

Where to View Event Data

Event data can be viewed in the following places within Klaviyo:

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.

Event Timeline Within a Profile

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.

Change events filter in Klaviyo to another metric

Metrics Snapshot within a Profile

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.

View and adjust metrics within Klaviyo profile

You can choose to display any and all events your customer has experienced in this section.

Dive Deeper into Metric Data

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.

    Click Details link under metric in 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.

    Placed order metadata

    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.

    Click on timestamp on the right of the page to see Activity Details

    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.

    Metadata in Activity Details

    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.

Metrics Listed in the Analytics Tab

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.

Metrics in your Klaviyo account

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.

Create targeted segments with events

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.

Create flows with events

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.

Where to View Profile Data

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.

Profile data within Klaviyo account

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.

Klaviyo and custom properties

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.

Location-based segmentation using profile data

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.

Klaviyo's built-in birthday flow

Head to our article on date property triggered flows for more information.

Where to View Catalog Data

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.

For help adding your catalog data via product blocks, see our guides on inserting a product block or product feeds and recommendations.

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.

Pull in catalog data to your email 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.

Import product feed to a flow-generated email

This is the second email within a customer winback where a product feed has been set up to display trending items.

Additional Resources

x
Was this article helpful?
14 out of 20 found this helpful