Klaviyo: Most-used fields#
The table below gives information about most-used fields that you can import from Klaviyo. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
$App Opened ({ID}) (count) Metric
The total number of times an application was opened by users, recorded as an event.
$Booking ({ID}) (count) Metric
The total number of booking events recorded.
$SignUp User ({ID}) (count) Metric
The total number of user sign-up events.
$SignUp User ({ID}) (sum_value) Metric
The sum of associated values for user sign-up events, such as a lead score or a promotional value.
$SignUp User ({ID}) (unique) Metric
The number of unique profiles who completed a sign-up action.
$Update user ({ID}) (count) Metric
The total number of user profile update events.
$expired_subscription ({ID}) Dimension
A system-generated field for a specific instance of the metric tracking when a subscription (e.g., to a list or service) has expired.
Abandoned Cart ({ID}) Metric
The total count of events where a customer added items to their shopping cart but did not complete the purchase, often associated with the 'Started Checkout' or 'Added to Cart' metrics.
Abandoned Cart ({ID}) (Unique) Metric
The number of unique profiles who initiated a checkout or added items to their cart but did not complete the purchase.
Active on Site ({ID}) Metric
A specific instance of the 'Active on Site' metric, identified by its unique metric ID.
Active on Site ({ID}) (Unique) Metric
The number of unique profiles who performed 'Active on Site' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Active on Site ({ID}) (count) Metric
The total count of 'Active on Site' events, recorded when an identifiable person visits your website, identified by a specific metric ID.
Added to Cart ({ID}) Dimension
A specific instance of the 'Added to Cart' metric, identified by its unique metric ID. This event tracks when an item is added to a customer's shopping cart.
Added to Cart ({ID}) (Unique) Dimension
This field represents the count of unique "Added to Cart" events. An "Added to Cart" event is recorded when a customer places an item in their shopping cart.
App Opened ({ID}) (count) Metric
The total number of times a specific 'App Opened' event occurred, identified by its unique metric ID. This field represents a count aggregation of app-open events, providing insight into user engagement with the application.
Attributed channel Dimension
The channel (e.g., email, SMS, mobile push) to which a particular event or conversion is attributed. This field is used for filtering and grouping aggregate metric data.
Bounced Email ({ID}) Metric
A specific instance of the 'Bounced Email' metric, identified by its unique metric ID.
Bounced Email ({ID}) (Unique) Metric
The number of unique email recipients for whom an email campaign or flow message resulted in a bounce.
Bounced Email ({ID}) (count) Metric
The total number of 'Bounced Email' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Bounced Email ({ID}) (sum_value) Metric
The total number of times an email sent from Klaviyo soft or hard bounced, indicating a delivery failure or rejection by the recipient's email server.
Bounced Push ({ID}) Dimension
The total count of push notifications that were sent but not successfully delivered to the recipient's device.
Bounced Push ({ID}) (Unique) Dimension
The number of unique profiles to whom a push notification was sent but failed to deliver.
Campaign Id Dimension
The unique identifier for a marketing campaign in Klaviyo.
Campaign Name Dimension
The name assigned to a marketing campaign in Klaviyo. This identifies the specific campaign associated with various performance metrics or events.
Campaign Type Dimension
The classification or category of a marketing campaign, such as 'email' or 'sms'.
Campaign channel Dimension
The communication channel used for a campaign message, such as 'email', 'sms', or 'mobile_push'. This field provides context for campaign performance reports.
Cancelled Order ({ID}) (Count) Dimension
The total number of 'Cancelled Order' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Cancelled Order ({ID}) (Unique) Dimension
The number of unique profiles who performed a 'Cancelled Order' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Cancelled Order ({ID}) (Value) Dimension
The total monetary value associated with 'Cancelled Order' events for a specific metric ID. This is a sum_value measurement type for metric aggregates.
Cancelled Subscription ({ID}) Dimension
The total count of events where a customer cancelled an active subscription.
Cancelled Subscription ({ID}) (Unique) Dimension
The number of unique profiles who cancelled a subscription.
Cart Items ({ID}) Metric
The total count of events related to items in a customer's shopping cart, often used in conjunction with abandoned cart flows.
Cart Items ({ID}) (Unique) Metric
The number of unique profiles associated with events related to items in a shopping cart.
Cart Items - {PLACEHOLDER} ({ID}) Dimension
A dynamic field representing a specific attribute of an item in the customer's cart, such as its name, category, or price. `{ID}` refers to the unique identifier for that specific cart item.
Cart Items - {PLACEHOLDER} ({ID}) (Unique) Dimension
The number of unique instances of a specific attribute of an item in the customer's cart, identified by its `{ID}`. This counts distinct items rather than the total quantity.
Checkout Started ({ID}) Metric
A specific instance of the 'Checkout Started' metric, identified by its unique metric ID.
Checkout Started ({ID}) (Unique) Metric
The number of unique profiles who performed a 'Checkout Started' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Clicked Email ({ID}) Metric
A specific instance of the 'Clicked Email' metric, identified by its unique metric ID.
Clicked Email ({ID}) (Unique) Metric
The number of unique email recipients who clicked a link within an email campaign or flow message.
Clicked Email ({ID}) (count) Metric
The total number of 'Clicked Email' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Clicked Email ({ID}) (sum_value) Metric
The sum of values associated with 'Clicked Email' events for a specific metric ID, as an aggregated metric.
Clicked Email ({ID}) ({ID}) Dimension
The total count of times a recipient clicked on a link within an email, indicating engagement with the email content.
Clicked Email ({ID}) ({ID}) (Unique) Dimension
The number of unique profiles who clicked on a link within an email, indicating individual engagement.
Clicked SMS ({ID}) Dimension
A specific instance of the metric tracking when a recipient clicks a link within an SMS message.
Clicked SMS ({ID}) (Unique) Dimension
The number of unique profiles who performed a 'Clicked SMS' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Clicked SMS ({ID}) (count) Metric
The total number of times recipients clicked a link within an SMS message. This metric indicates engagement with SMS campaigns.
Clicked email to unsubscribe ({ID}) (count) Metric
The total count of clicks on an unsubscribe link within an email, based on a specific metric ID.
Clicked email to unsubscribe ({ID}) (unique) Metric
This metric counts the number of unique profiles that have clicked an unsubscribe link within an email, indicating their intent to opt out of further email communications.
Created Dimension
The timestamp indicating when an object, such as a profile, metric, or campaign, was created in Klaviyo.
Date Dimension
A date used for filtering or grouping data in reports, representing the time an event occurred.
Dropped Email ({ID}) Dimension
A specific instance of the 'Dropped Email' metric, identified by its unique metric ID.
Dropped Email ({ID}) (Unique) Dimension
The number of unique profiles for whom an 'Dropped Email' event occurred for a specific metric ID. This is a measurement type available when querying metric aggregates.
Email domain Dimension
The domain part of a recipient's email address (e.g., 'example.com'). This field can be used to group or filter metric aggregates.
Excluded Lists Dimension
A list of profiles who are intentionally excluded from receiving campaign messages or flow emails.
Failed to Deliver SMS ({ID}) Dimension
An event indicating that an SMS message, identified by {ID}, failed to be delivered to the recipient.
Failed to Deliver SMS ({ID}) (Unique) Dimension
The number of unique profiles for whom a 'Failed to Deliver SMS' event occurred for a specific metric ID. This is a measurement type available when querying metric aggregates.
Failed to Deliver SMS ({ID}) (count) Metric
The total number of SMS messages that failed to reach their intended recipients. This metric helps monitor the deliverability of SMS campaigns.
Failed to deliver Automated Response SMS ({ID}) Dimension
The total count of automated response SMS messages that were sent but not successfully delivered to the recipient.
Failed to deliver Automated Response SMS ({ID}) (Unique) Dimension
The number of unique automated response SMS messages that were sent but not successfully delivered to the recipient.
Filled Out Form ({ID}) Metric
The total count of events where a customer submitted a form on the website.
Filled Out Form ({ID}) (Unique) Metric
The number of unique profiles who submitted a form on the website.
Filled Out Lead Ad ({ID}) Dimension
A specific instance of the 'Filled Out Lead Ad' metric, identified by its unique metric ID.
Filled Out Lead Ad ({ID}) (Unique) Dimension
The number of unique profiles who performed a 'Filled Out Lead Ad' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Flow Dimension
Refers to a marketing automation flow, identifiable by its name or ID.
Form submitted by profile ({ID}) (count) Metric
The total number of times a form was submitted by profiles. This metric is available through form reporting APIs for tracking form performance.
Form submitted by profile ({ID}) (unique) Metric
The total number of unique profiles that submitted a form. This metric is available through form reporting APIs for tracking unique form submissions.
From Email Dimension
The email address from which a campaign or flow email is sent.
From Name Dimension
The name of the sender of a campaign or flow email, as displayed to recipients.
Fulfilled Order ({ID}) (Count) Metric
The total number of 'Fulfilled Order' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Fulfilled Order ({ID}) (Unique) Metric
The number of unique profiles who performed a 'Fulfilled Order' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Fulfilled Order ({ID}) (Value) Metric
The total monetary value associated with 'Fulfilled Order' events for a specific metric ID. This is a sum_value measurement type for metric aggregates.
Fulfilled Order - {PLACEHOLDER} ({ID}) Dimension
The total count of 'Fulfilled Order' events for a specific metric ID.
Fulfilled Order - {PLACEHOLDER} ({ID}) (Unique) Dimension
The unique count of 'Fulfilled Order' events for a specific metric ID.
List0 Created Dimension
The timestamp indicating when a specific list was created in Klaviyo.
List0 Id Dimension
The unique identifier for a specific list in Klaviyo.
List0 Person Count Metric
The number of profiles currently in a specific list.
List0 Type Dimension
The classification of a list, indicating whether it is a standard list or a segment within Klaviyo.
List0 Updated Dimension
The timestamp indicating when a specific list was last updated in Klaviyo.
Lists Amount Metric
The number of profiles associated with a particular list, representing the total audience size of that list. This is available as 'profile_count' or 'person_count' in list-related API responses.
Manually Suppressed from Email Marketing ({ID}) Dimension
A specific instance of the metric tracking when a profile is manually suppressed from receiving email marketing messages.
Manually Suppressed from Email Marketing ({ID}) (Unique) Dimension
The number of unique profiles who were manually suppressed from email marketing for a specific metric ID. This is a measurement type available when querying metric aggregates.
Marked Email as Spam ({ID}) Metric
A specific instance of the 'Marked Email as Spam' metric, identified by its unique metric ID.
Marked Email as Spam ({ID}) (Unique) Metric
The number of unique profiles who performed a 'Marked Email as Spam' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Marked Email as Spam ({ID}) (count) Metric
The total count of times an email was marked as spam by a recipient, based on a specific metric ID.
Merged Profile ({ID}) Dimension
A specific instance of the 'Merged Profile' metric, identified by its unique metric ID.
Merged Profile ({ID}) (Unique) Dimension
The number of unique profiles for whom a 'Merged Profile' event occurred for a specific metric ID. This is a measurement type available when querying metric aggregates.
Message Dimension
The actual content of an email or SMS message sent as part of a campaign or flow.
Message Type Dimension
The type of message sent within a campaign, such as 'email' or 'sms'.
Num Recipients Metric
The total number of intended recipients for a campaign or flow message.
Opened Email ({ID}) Metric
A specific instance of the 'Opened Email' metric, identified by its unique metric ID.
Opened Email ({ID}) (Unique) Metric
The number of unique email recipients who opened an email campaign or flow message.
Opened Email ({ID}) (count) Metric
The total number of 'Opened Email' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Opened Email ({ID}) (sum_value) Metric
The sum of values associated with 'Opened Email' events for a specific metric ID, as an aggregated metric.
Opened Push ({ID}) Dimension
The total count of times a recipient tapped on a push notification and opened the associated app.
Opened Push ({ID}) (Unique) Dimension
The number of unique profiles who tapped on a push notification and opened the associated app.
Opened Text ({ID}) (unique) Metric
The number of unique profiles that opened an SMS message. This metric indicates unique engagement with SMS content.
Order Placed ({ID}) (count) Metric
The total count of placed orders. 'Placed Order' is a native Klaviyo e-commerce metric.
Order Placed ({ID}) (unique) Metric
The total count of unique placed orders. 'Placed Order' is a native Klaviyo e-commerce metric.
Ordered Product ({ID}) (Count) Metric
The total number of 'Ordered Product' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Ordered Product ({ID}) (Unique) Metric
The number of unique profiles who performed an 'Ordered Product' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Ordered Product ({ID}) (Value) Metric
The total monetary value associated with 'Ordered Product' events for a specific metric ID. This is a sum_value measurement type for metric aggregates.
Placed Order ({ID}) (Value) Metric
The total monetary value associated with 'Placed Order' events for a specific metric ID. This is a sum_value measurement type for metric aggregates.
Placed Order ({ID}) (count) Metric
The total count of 'Placed Order' events, representing instances when customers complete a purchase, identified by a specific metric ID.
Placed Order ({ID}) (sum_value) Metric
The total monetary value (e.g., revenue) from placed orders, based on a specific metric ID.
Placed Order ({ID}) (unique) Metric
The number of unique customers who placed an order.
Placed Order - {PLACEHOLDER} ({ID}) Dimension
The total count of 'Placed Order' events for a specific metric ID.
Placed Order - {PLACEHOLDER} ({ID}) (Unique) Dimension
The unique count of 'Placed Order' events for a specific metric ID.
Received Automated Response SMS ({ID}) Dimension
A specific instance of the metric tracking when a profile receives an automated response SMS.
Received Automated Response SMS ({ID}) (Unique) Dimension
The number of unique profiles who received an 'Automated Response SMS' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Received Email ({ID}) Metric
A specific instance of the 'Received Email' metric, identified by its unique metric ID.
Received Email ({ID}) (Unique) Metric
The number of unique recipients who received an email campaign or flow message.
Received Email ({ID}) (count) Metric
The total number of 'Received Email' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Received Email ({ID}) (sum_value) Metric
The sum of values associated with 'Received Email' events for a specific metric ID, as an aggregated metric.
Received Push ({ID}) Dimension
The total count of push notifications that Klaviyo recorded as successfully received by the recipient's device.
Received Push ({ID}) (Unique) Dimension
The number of unique profiles who received a push notification.
Received SMS ({ID}) Dimension
A specific instance of the metric tracking when an SMS message is successfully delivered to a recipient's device.
Received SMS ({ID}) (Unique) Dimension
The number of unique profiles who received an 'SMS' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Received SMS ({ID}) (count) Metric
The total number of SMS messages successfully received by profiles. This metric provides insight into the reach of SMS campaigns.
Rejected Payment ({ID}) Metric
The total count of events where a customer's payment for an order or subscription was declined or failed.
Rejected Payment ({ID}) (Unique) Metric
The number of unique profiles who experienced a rejected or failed payment.
Segmented Dimension
Indicates whether a campaign was sent to a specific segment of profiles.
Send Time Dimension
The specific time at which a campaign or message was sent or scheduled to be sent.
Sent At Dimension
The timestamp indicating the exact moment a campaign or message was sent.
Sent SMS ({ID}) Metric
A specific instance of the metric tracking when an SMS message is sent to a recipient.
Sent SMS ({ID}) (Unique) Metric
The number of unique recipients to whom an SMS message was successfully sent.
Sent SMS ({ID}) (count) Metric
The total number of 'Sent SMS' events for a specific metric ID. This is a measurement type available when querying metric aggregates.
Sent SMS ({ID}) (sum_value) Metric
The total number of SMS messages successfully sent to recipients' mobile devices. This metric provides insight into the reach of SMS campaigns.
Started Checkout ({ID}) Dimension
A specific instance of the 'Started Checkout' metric, identified by its unique metric ID.
Started Checkout ({ID}) (Unique) Dimension
The number of unique profiles that initiated a checkout process on the website, identified by a specific metric ID. This is a key e-commerce behavioral event.
Started Subscription ({ID}) Dimension
The total count of events where a customer initiated a new subscription.
Started Subscription ({ID}) (Unique) Dimension
The number of unique profiles who initiated a new subscription.
Status Dimension
The current status of a campaign (e.g., 'draft', 'sent', 'scheduled', 'cancelled').
Status Label Dimension
A human-readable label representing the current status of a campaign.
Subject Dimension
The subject line of an email campaign message.
Submitted Form ({ID}) (count) Metric
The total count of forms submitted by profiles, based on a specific metric ID.
Submitted Form ({ID}) (sum_value) Metric
The sum of values associated with form submission events, if the form includes a numerical value.
Submitted Form ({ID}) (unique) Metric
The number of unique profiles who submitted forms, based on a specific metric ID.
Subscribed to Back in Stock ({ID}) Dimension
A specific instance of the 'Subscribed to Back in Stock' metric, identified by its unique metric ID.
Subscribed to Back in Stock ({ID}) (Unique) Dimension
The number of unique profiles who performed a 'Subscribed to Back in Stock' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Subscribed to Email Marketing ({ID}) (count) Metric
The total count of profiles who subscribed to email marketing, based on a specific metric ID.
Subscribed to Email Marketing ({ID}) (sum_value) Metric
The total number of times profiles subscribed to email marketing, aggregated as a sum. This metric tracks instances of explicit email consent via API or other methods.
Subscribed to Email Marketing ({ID}) (unique) Metric
This field represents a unique count of individuals who have opted in to receive email marketing communications.
Subscribed to List ({ID}) Dimension
A specific instance of the 'Subscribed to List' metric, identified by its unique metric ID.
Subscribed to List ({ID}) (count) Metric
The total number of subscriptions to a specific marketing list.
Subscribed to List ({ID}) (sum_value) Metric
The sum of numerical values associated with the 'Subscribed to List' event. This event is recorded when a profile is successfully added to a specific marketing list in Klaviyo, often through sign-up forms, API calls, or imports, indicating their subscription to that list.
Subscribed to List ({ID}) (unique) Metric
The number of unique profiles that subscribed to a specific marketing list.
Subscribed to SMS Marketing ({ID}) Metric
A specific instance of the metric tracking when a profile subscribes to SMS marketing.
Subscribed to SMS Marketing ({ID}) (Unique) Metric
The number of unique profiles who performed a 'Subscribed to SMS Marketing' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Template Id Dimension
The unique identifier for the email or SMS template used in a campaign message.
Unsubscribed ({ID}) Metric
A specific instance of the 'Unsubscribed' (now 'Clicked email to unsubscribe') metric, identified by its unique metric ID.
Unsubscribed ({ID}) (Unique) Metric
The number of unique profiles who performed an 'Unsubscribed' (now 'Clicked email to unsubscribe') event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Unsubscribed from Email Marketing ({ID}) (count) Metric
The total number of times profiles unsubscribed from email marketing. This is a recommended metric for tracking email opt-outs.
Unsubscribed from Email Marketing ({ID}) (unique) Metric
This field represents the unique count of profiles who have unsubscribed from email marketing within a specified period. It provides insights into customer churn from email campaigns.
Unsubscribed from List ({ID}) Dimension
A specific instance of the 'Unsubscribed from List' metric, identified by its unique metric ID.
Unsubscribed from List ({ID}) (Unique) Dimension
The number of unique profiles who performed an 'Unsubscribed from List' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Unsubscribed from SMS Marketing ({ID}) Metric
A specific instance of the metric tracking when a profile unsubscribes from SMS marketing.
Unsubscribed from SMS Marketing ({ID}) (Unique) Metric
The number of unique profiles who performed an 'Unsubscribed from SMS Marketing' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
Unsubscribed from SMS Marketing ({ID}) (count) Metric
The total number of times profiles unsubscribed from SMS marketing. This metric tracks explicit SMS opt-outs.
Updated Dimension
The timestamp indicating when an object, such as a profile, metric, or campaign, was last updated in Klaviyo.
Updated Email Preferences ({ID}) Dimension
A specific instance of the 'Updated Email Preferences' metric, identified by its unique metric ID.
Updated Email Preferences ({ID}) (Unique) Dimension
The number of unique profiles who performed an 'Updated Email Preferences' event for a specific metric ID. This is a measurement type available when querying metric aggregates.
User Registration ({ID}) Metric
The total count of events where a new user successfully registered an account on the website or platform.
User Registration ({ID}) (Unique) Metric
The number of unique profiles who registered a new user account.
User Registration - {PLACEHOLDER} ({ID}) Dimension
The total count of 'User Registration' events for a specific metric ID.
User Registration - {PLACEHOLDER} ({ID}) (Unique) Dimension
The unique count of 'User Registration' events for a specific metric ID.
Viewed ({ID}) Dimension
An event indicating that a specific item or content, identified by {ID}, was viewed by a customer.
Viewed ({ID}) (Unique) Dimension
The number of unique profiles who performed a general 'view' event, such as viewing a product or a page.
Viewed Product ({ID}) Metric
A specific instance of the 'Viewed Product' metric, identified by its unique metric ID.
Viewed Product ({ID}) (count) Metric
The total number of times products were viewed by customers.
Viewed Product ({ID}) (sum_value) Metric
The sum of numerical values associated with 'Viewed Product' events. This event is recorded when an identifiable person views a product page on your website, commonly used in e-commerce to track customer interest in specific products.
Viewed Product ({ID}) (unique) Metric
The number of unique profiles that viewed a product.
unsubscribe_page_submit ({ID}) (count) Metric
The total count of submissions to an unsubscribe page. This event indicates when a profile attempts to opt-out via a dedicated unsubscribe form.
unsubscribe_page_submit ({ID}) (unique) Metric
The total number of unique profiles that submitted an unsubscribe page. This event tracks unique instances of profiles attempting to opt-out via a dedicated unsubscribe form.