Klaviyo: Most-used fields

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.

API name

Adverity UI name

Description

Use in Adverity

({ID}) (count)

({ID}) (count)

The total count of a specific event or action, identified by its unique metric ID. This data is aggregated from Klaviyo events.

metric

({ID}) (sum_value)

({ID}) (sum_value)

The sum of a specific value associated with an event or action, identified by its unique metric ID. This data is aggregated from Klaviyo events.

metric

$expired_subscription ({ID})

$expired_subscription ({ID})

A system-generated field for a specific instance of the metric tracking when a subscription (e.g., to a list or service) has expired.

dimension

Abandoned Cart ({ID})

Abandoned Cart ({ID})

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.

metric

Abandoned Cart ({ID}) (Unique)

Abandoned Cart ({ID}) (Unique)

The number of unique profiles who initiated a checkout or added items to their cart but did not complete the purchase.

metric

Active on Site (clicks)

Active on Site (clicks)

metric

Active on Site (conversions)

Active on Site (conversions)

metric

Active on Site (opens)

Active on Site (opens)

metric

Active on Site ({ID})

Active on Site ({ID})

A specific instance of the ‘Active on Site’ metric, identified by its unique metric ID.

metric

Active on Site ({ID}) (Unique)

Active on Site ({ID}) (Unique)

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.

metric

Active on Site ({ID}) (count)

Active on Site ({ID}) (count)

The total count of ‘Active on Site’ events, recorded when an identifiable person visits your website, identified by a specific metric ID.

metric

Added to Cart (clicks)

Added to Cart (clicks)

The total number of clicks associated with messages or campaigns related to profiles adding items to their cart. This indicates engagement with abandoned cart recovery efforts.

metric

Added to Cart ({ID})

Added to Cart ({ID})

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.

dimension

Added to Cart ({ID}) (Unique)

Added to Cart ({ID}) (Unique)

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.

dimension

Added to Cart ({ID}) (count)

Added to Cart ({ID}) (count)

The total count of ‘Added to Cart’ events, recorded when a customer adds a product to their online shopping cart, identified by a specific metric ID.

metric

Attributed channel

Attributed channel

A dimension used to group or filter events that are attributed to a specific marketing channel (e.g., email, SMS).

dimension

Attributed flow

Attributed flow

A dimension used to group or filter events that are attributed to a specific marketing automation flow.

dimension

Attributed message

Attributed message

A dimension used to group or filter events that are attributed to a specific message within a campaign or flow.

dimension

Bounced Email ({ID})

Bounced Email ({ID})

A specific instance of the ‘Bounced Email’ metric, identified by its unique metric ID.

metric

Bounced Email ({ID}) (count)

Bounced Email ({ID}) (count)

The total number of ‘Bounced Email’ events for a specific metric ID. This is a measurement type available when querying metric aggregates.

metric

Bounced Email ({ID}) (sum_value)

Bounced Email ({ID}) (sum_value)

The sum of values associated with ‘Bounced Email’ events for a specific metric ID, as an aggregated metric.

metric

Bounced Email ({ID}) (unique)

Bounced Email ({ID}) (unique)

This metric counts the unique instances where an email sent from Klaviyo was not successfully delivered to the recipient’s inbox. This can be due to a permanent reason (hard bounce) such as an invalid email address, or a temporary reason (soft bounce) like a full inbox or a temporary server issue.

metric

Bounced Push ({ID})

Bounced Push ({ID})

The total count of push notifications that were sent but not successfully delivered to the recipient’s device.

dimension

Bounced Push ({ID}) (Unique)

Bounced Push ({ID}) (Unique)

The number of unique profiles to whom a push notification was sent but failed to deliver.

dimension

Campaign Id

Campaign Id

The unique identifier for a marketing campaign in Klaviyo.

dimension

Campaign Name

Campaign Name

The name assigned to a marketing campaign in Klaviyo. This identifies the specific campaign associated with various performance metrics or events.

dimension

Campaign Type

Campaign Type

The classification or category of a marketing campaign, such as ‘email’ or ‘sms’.

dimension

Campaign channel

Campaign channel

The communication channel (e.g., email, SMS) through which a campaign was sent.

dimension

Cancelled Order ({ID}) (Count)

Cancelled Order ({ID}) (Count)

The total number of ‘Cancelled Order’ events for a specific metric ID. This is a measurement type available when querying metric aggregates.

dimension

Cancelled Order ({ID}) (Unique)

Cancelled Order ({ID}) (Unique)

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.

dimension

Cancelled Order ({ID}) (Value)

Cancelled Order ({ID}) (Value)

The total monetary value associated with ‘Cancelled Order’ events for a specific metric ID. This is a sum_value measurement type for metric aggregates.

dimension

Cancelled Subscription ({ID})

Cancelled Subscription ({ID})

The total count of events where a customer cancelled an active subscription.

dimension

Cancelled Subscription ({ID}) (Unique)

Cancelled Subscription ({ID}) (Unique)

The number of unique profiles who cancelled a subscription.

dimension

Cart Items ({ID})

Cart Items ({ID})

The total count of events related to items in a customer’s shopping cart, often used in conjunction with abandoned cart flows.

metric

Cart Items ({ID}) (Unique)

Cart Items ({ID}) (Unique)

The number of unique profiles associated with events related to items in a shopping cart.

metric

Cart Items - {PLACEHOLDER} ({ID})

Cart Items - {PLACEHOLDER} ({ID})

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.

dimension

Cart Items - {PLACEHOLDER} ({ID}) (Unique)

Cart Items - {PLACEHOLDER} ({ID}) (Unique)

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.

dimension

Channel

Channel

The marketing channel (e.g., email, SMS) through which a message or event occurred.

dimension

Checkout Started ({ID})

Checkout Started ({ID})

A specific instance of the ‘Checkout Started’ metric, identified by its unique metric ID.

metric

Checkout Started ({ID}) (Unique)

Checkout Started ({ID}) (Unique)

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.

metric

Clicked Email ({ID})

Clicked Email ({ID})

A specific instance of the ‘Clicked Email’ metric, identified by its unique metric ID.

metric

Clicked Email ({ID}) (count)

Clicked Email ({ID}) (count)

The total number of ‘Clicked Email’ events for a specific metric ID. This is a measurement type available when querying metric aggregates.

metric

Clicked Email ({ID}) (sum_value)

Clicked Email ({ID}) (sum_value)

The sum of values associated with ‘Clicked Email’ events for a specific metric ID, as an aggregated metric.

metric

Clicked Email ({ID}) (unique)

Clicked Email ({ID}) (unique)

This field represents a unique count of times a recipient clicked a link within an email sent from a campaign or flow. It indicates engagement with the email content.

metric

Clicked Email ({ID}) ({ID})

Clicked Email ({ID}) ({ID})

The total count of times a recipient clicked on a link within an email, indicating engagement with the email content.

dimension

Clicked Email ({ID}) ({ID}) (Unique)

Clicked Email ({ID}) ({ID}) (Unique)

The number of unique profiles who clicked on a link within an email, indicating individual engagement.

dimension

Clicked SMS ({ID})

Clicked SMS ({ID})

A specific instance of the metric tracking when a recipient clicks a link within an SMS message.

dimension

Clicked SMS ({ID}) (Unique)

Clicked SMS ({ID}) (Unique)

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.

dimension

Clicked SMS ({ID}) (count)

Clicked SMS ({ID}) (count)

The total count of clicks on links within SMS messages, based on a specific metric ID.

metric

Clicked email to unsubscribe ({ID}) (count)

Clicked email to unsubscribe ({ID}) (count)

The total count of clicks on an unsubscribe link within an email, based on a specific metric ID.

metric

Clicked email to unsubscribe ({ID}) (unique)

Clicked email to unsubscribe ({ID}) (unique)

The number of unique profiles who clicked an unsubscribe link within an email, based on a specific metric ID.

metric

Created

Created

The timestamp indicating when an object, such as a profile, metric, or campaign, was created in Klaviyo.

dimension

Created At

Created At

The timestamp indicating when a particular Klaviyo object (e.g., profile, metric, campaign, list) was created.

dimension

Date

Date

A date used for filtering or grouping data in reports, representing the time an event occurred.

dimension

Dropped Email ({ID})

Dropped Email ({ID})

A specific instance of the ‘Dropped Email’ metric, identified by its unique metric ID.

dimension

Dropped Email ({ID}) (Unique)

Dropped Email ({ID}) (Unique)

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.

dimension

Dropped Email ({ID}) (count)

Dropped Email ({ID}) (count)

The total count of ‘Dropped Email’ events, which occur when an email is not sent due to a discrepancy in suppression status between Klaviyo and an email service provider, identified by a specific metric ID.

metric

Email domain

Email domain

A dimension for grouping or filtering data by the email domain of recipients.

dimension

Excluded Lists

Excluded Lists

A list of profiles who are intentionally excluded from receiving campaign messages or flow emails.

dimension

Failed to Deliver SMS ({ID})

Failed to Deliver SMS ({ID})

An event indicating that an SMS message, identified by {ID}, failed to be delivered to the recipient.

dimension

Failed to Deliver SMS ({ID}) (Unique)

Failed to Deliver SMS ({ID}) (Unique)

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.

dimension

Failed to Deliver SMS ({ID}) (count)

Failed to Deliver SMS ({ID}) (count)

The total count of SMS messages that failed to deliver to recipients, based on a specific metric ID.

metric

Failed to deliver Automated Response SMS ({ID})

Failed to deliver Automated Response SMS ({ID})

The total count of automated response SMS messages that were sent but not successfully delivered to the recipient.

dimension

Failed to deliver Automated Response SMS ({ID}) (Unique)

Failed to deliver Automated Response SMS ({ID}) (Unique)

The number of unique automated response SMS messages that were sent but not successfully delivered to the recipient.

dimension

Failed to deliver Automated Response SMS ({ID}) (count)

Failed to deliver Automated Response SMS ({ID}) (count)

The total count of automated response SMS messages that failed to deliver to recipients, based on a specific metric ID.

metric

Filled Out Form ({ID})

Filled Out Form ({ID})

The total count of events where a customer submitted a form on the website.

metric

Filled Out Form ({ID}) (Unique)

Filled Out Form ({ID}) (Unique)

The number of unique profiles who submitted a form on the website.

metric

Filled Out Lead Ad ({ID})

Filled Out Lead Ad ({ID})

A specific instance of the ‘Filled Out Lead Ad’ metric, identified by its unique metric ID.

dimension

Filled Out Lead Ad ({ID}) (Unique)

Filled Out Lead Ad ({ID}) (Unique)

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.

dimension

Flow

Flow

Refers to a marketing automation flow, identifiable by its name or ID.

dimension

Form submitted by profile ({ID}) (count)

Form submitted by profile ({ID}) (count)

The total count of forms submitted by profiles, based on a specific metric ID.

metric

Form submitted by profile ({ID}) (unique)

Form submitted by profile ({ID}) (unique)

The number of unique profiles who submitted forms, based on a specific metric ID.

metric

From Email

From Email

The email address from which a campaign or flow email is sent.

dimension

From Label

From Label

The name or label displayed as the sender of an email or SMS message in a campaign.

dimension

From Name

From Name

The name of the sender of a campaign or flow email, as displayed to recipients.

dimension

Fulfilled Order ({ID}) (Count)

Fulfilled Order ({ID}) (Count)

The total number of ‘Fulfilled Order’ events for a specific metric ID. This is a measurement type available when querying metric aggregates.

metric

Fulfilled Order ({ID}) (Unique)

Fulfilled Order ({ID}) (Unique)

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.

metric

Fulfilled Order ({ID}) (Value)

Fulfilled Order ({ID}) (Value)

The total monetary value associated with ‘Fulfilled Order’ events for a specific metric ID. This is a sum_value measurement type for metric aggregates.

metric

Fulfilled Order - {PLACEHOLDER} ({ID})

Fulfilled Order - {PLACEHOLDER} ({ID})

The total count of ‘Fulfilled Order’ events for a specific metric ID.

dimension

Fulfilled Order - {PLACEHOLDER} ({ID}) (Unique)

Fulfilled Order - {PLACEHOLDER} ({ID}) (Unique)

The unique count of ‘Fulfilled Order’ events for a specific metric ID.

dimension

Label

Label

A descriptive name or identifier assigned to various Klaviyo objects such as campaigns, lists, or segments.

dimension

List0 Created

List0 Created

The timestamp indicating when a specific list was created in Klaviyo.

dimension

List0 Id

List0 Id

The unique identifier for a specific list in Klaviyo.

dimension

List0 Person Count

List0 Person Count

The number of profiles currently in a specific list.

metric

List0 Type

List0 Type

The classification of a list, indicating whether it is a standard list or a segment within Klaviyo.

dimension

List0 Updated

List0 Updated

The timestamp indicating when a specific list was last updated in Klaviyo.

dimension

Lists Amount

Lists Amount

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.

metric

Manually Suppressed from Email Marketing ({ID})

Manually Suppressed from Email Marketing ({ID})

A specific instance of the metric tracking when a profile is manually suppressed from receiving email marketing messages.

dimension

Manually Suppressed from Email Marketing ({ID}) (Unique)

Manually Suppressed from Email Marketing ({ID}) (Unique)

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.

dimension

Marked Email as Spam ({ID})

Marked Email as Spam ({ID})

A specific instance of the ‘Marked Email as Spam’ metric, identified by its unique metric ID.

metric

Marked Email as Spam ({ID}) (Unique)

Marked Email as Spam ({ID}) (Unique)

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.

metric

Marked Email as Spam ({ID}) (count)

Marked Email as Spam ({ID}) (count)

The total count of times an email was marked as spam by a recipient, based on a specific metric ID.

metric

Merged Profile ({ID})

Merged Profile ({ID})

A specific instance of the ‘Merged Profile’ metric, identified by its unique metric ID.

dimension

Merged Profile ({ID}) (Unique)

Merged Profile ({ID}) (Unique)

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.

dimension

Message

Message

The actual content of an email or SMS message sent as part of a campaign or flow.

dimension

Message Type

Message Type

The type of message sent within a campaign, such as ‘email’ or ‘sms’.

dimension

Num Recipients

Num Recipients

The total number of intended recipients for a campaign or flow message.

metric

Opened Email ({ID})

Opened Email ({ID})

A specific instance of the ‘Opened Email’ metric, identified by its unique metric ID.

metric

Opened Email ({ID}) (count)

Opened Email ({ID}) (count)

The total number of ‘Opened Email’ events for a specific metric ID. This is a measurement type available when querying metric aggregates.

metric

Opened Email ({ID}) (sum_value)

Opened Email ({ID}) (sum_value)

The sum of values associated with ‘Opened Email’ events for a specific metric ID, as an aggregated metric.

metric

Opened Email ({ID}) (unique)

Opened Email ({ID}) (unique)

This field represents a unique count of times a recipient opened an email sent from a campaign or flow, indicating that the email was viewed.

metric

Opened Push ({ID})

Opened Push ({ID})

The total count of times a recipient tapped on a push notification and opened the associated app.

dimension

Opened Push ({ID}) (Unique)

Opened Push ({ID}) (Unique)

The number of unique profiles who tapped on a push notification and opened the associated app.

dimension

Opened Text ({ID}) (unique)

Opened Text ({ID}) (unique)

The number of unique profiles who opened a text message, as an aggregated metric for a specific metric ID.

metric

Order Placed ({ID}) (count)

Order Placed ({ID}) (count)

The total count of placed orders, based on a specific metric ID.

metric

Order Placed ({ID}) (unique)

Order Placed ({ID}) (unique)

The number of unique profiles who placed orders, based on a specific metric ID.

metric

Ordered Product ({ID}) (Count)

Ordered Product ({ID}) (Count)

The total number of ‘Ordered Product’ events for a specific metric ID. This is a measurement type available when querying metric aggregates.

metric

Ordered Product ({ID}) (Unique)

Ordered Product ({ID}) (Unique)

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.

metric

Ordered Product ({ID}) (Value)

Ordered Product ({ID}) (Value)

The total monetary value associated with ‘Ordered Product’ events for a specific metric ID. This is a sum_value measurement type for metric aggregates.

metric

Ordered Product ({ID}) (sum_value)

Ordered Product ({ID}) (sum_value)

The total monetary value of products ordered, representing the sum of values for ‘Ordered Product’ events, identified by a specific metric ID.

metric

Placed Order ({ID}) (Unique)

Placed Order ({ID}) (Unique)

This field represents the count of unique “Placed Order” events. A “Placed Order” event is recorded when a customer completes a purchase.

metric

Placed Order ({ID}) (Value)

Placed Order ({ID}) (Value)

The total monetary value associated with ‘Placed Order’ events for a specific metric ID. This is a sum_value measurement type for metric aggregates.

metric

Placed Order ({ID}) (count)

Placed Order ({ID}) (count)

The total count of ‘Placed Order’ events, representing instances when customers complete a purchase, identified by a specific metric ID.

metric

Placed Order ({ID}) (sum_value)

Placed Order ({ID}) (sum_value)

The total monetary value (e.g., revenue) from placed orders, based on a specific metric ID.

metric

Placed Order - {PLACEHOLDER} ({ID})

Placed Order - {PLACEHOLDER} ({ID})

The total count of ‘Placed Order’ events for a specific metric ID.

dimension

Placed Order - {PLACEHOLDER} ({ID}) (Unique)

Placed Order - {PLACEHOLDER} ({ID}) (Unique)

The unique count of ‘Placed Order’ events for a specific metric ID.

dimension

Received Automated Response SMS ({ID})

Received Automated Response SMS ({ID})

A specific instance of the metric tracking when a profile receives an automated response SMS.

dimension

Received Automated Response SMS ({ID}) (Unique)

Received Automated Response SMS ({ID}) (Unique)

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.

dimension

Received Email ({ID})

Received Email ({ID})

A specific instance of the ‘Received Email’ metric, identified by its unique metric ID.

metric

Received Email ({ID}) (count)

Received Email ({ID}) (count)

The total number of ‘Received Email’ events for a specific metric ID. This is a measurement type available when querying metric aggregates.

metric

Received Email ({ID}) (sum_value)

Received Email ({ID}) (sum_value)

The sum of values associated with ‘Received Email’ events for a specific metric ID, as an aggregated metric.

metric

Received Email ({ID}) (unique)

Received Email ({ID}) (unique)

This field represents a unique count of emails that were successfully delivered to the recipient’s inbox. It indicates successful email delivery.

metric

Received Push ({ID})

Received Push ({ID})

The total count of push notifications that Klaviyo recorded as successfully received by the recipient’s device.

dimension

Received Push ({ID}) (Unique)

Received Push ({ID}) (Unique)

The number of unique profiles who received a push notification.

dimension

Received SMS ({ID})

Received SMS ({ID})

A specific instance of the metric tracking when an SMS message is successfully delivered to a recipient’s device.

dimension

Received SMS ({ID}) (Unique)

Received SMS ({ID}) (Unique)

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.

dimension

Received SMS ({ID}) (count)

Received SMS ({ID}) (count)

The total count of SMS messages received by profiles, based on a specific metric ID.

metric

Rejected Payment ({ID})

Rejected Payment ({ID})

The total count of events where a customer’s payment for an order or subscription was declined or failed.

metric

Rejected Payment ({ID}) (Unique)

Rejected Payment ({ID}) (Unique)

The number of unique profiles who experienced a rejected or failed payment.

metric

Segmented

Segmented

Indicates whether a campaign was sent to a specific segment of profiles.

dimension

Send Time

Send Time

The specific time at which a campaign or message was sent or scheduled to be sent.

dimension

Sent At

Sent At

The timestamp indicating the exact moment a campaign or message was sent.

dimension

Sent SMS ({ID})

Sent SMS ({ID})

A specific instance of the metric tracking when an SMS message is sent to a recipient.

metric

Sent SMS ({ID}) (count)

Sent SMS ({ID}) (count)

The total number of ‘Sent SMS’ events for a specific metric ID. This is a measurement type available when querying metric aggregates.

metric

Sent SMS ({ID}) (sum_value)

Sent SMS ({ID}) (sum_value)

The sum of values associated with ‘Sent SMS’ events for a specific metric ID, as an aggregated metric.

metric

Sent SMS ({ID}) (unique)

Sent SMS ({ID}) (unique)

This field represents a unique count of SMS messages that were successfully sent by Klaviyo to the recipient’s carrier for delivery.

metric

Started Checkout ({ID})

Started Checkout ({ID})

A specific instance of the ‘Started Checkout’ metric, identified by its unique metric ID.

dimension

Started Checkout ({ID}) (Unique)

Started Checkout ({ID}) (Unique)

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.

dimension

Started Subscription ({ID})

Started Subscription ({ID})

The total count of events where a customer initiated a new subscription.

dimension

Started Subscription ({ID}) (Unique)

Started Subscription ({ID}) (Unique)

The number of unique profiles who initiated a new subscription.

dimension

Status

Status

The current status of a campaign (e.g., ‘draft’, ‘sent’, ‘scheduled’, ‘cancelled’).

dimension

Status Label

Status Label

A human-readable label representing the current status of a campaign.

dimension

Subject

Subject

The subject line of an email campaign message.

dimension

Submitted Form ({ID}) (count)

Submitted Form ({ID}) (count)

The total count of forms submitted by profiles, based on a specific metric ID.

metric

Submitted Form ({ID}) (unique)

Submitted Form ({ID}) (unique)

The number of unique profiles who submitted forms, based on a specific metric ID.

metric

Subscribed to Back in Stock ({ID})

Subscribed to Back in Stock ({ID})

A specific instance of the ‘Subscribed to Back in Stock’ metric, identified by its unique metric ID.

dimension

Subscribed to Back in Stock ({ID}) (Unique)

Subscribed to Back in Stock ({ID}) (Unique)

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.

dimension

Subscribed to Email Marketing ({ID}) (count)

Subscribed to Email Marketing ({ID}) (count)

The total count of profiles who subscribed to email marketing, based on a specific metric ID.

metric

Subscribed to Email Marketing ({ID}) (unique)

Subscribed to Email Marketing ({ID}) (unique)

This field represents a unique count of individuals who have opted in to receive email marketing communications.

metric

Subscribed to List (clicks)

Subscribed to List (clicks)

The total number of clicks associated with messages related to profiles subscribing to a list. This indicates engagement with the subscription confirmation or related communications.

metric

Subscribed to List (conversions)

Subscribed to List (conversions)

The number of times a conversion event occurred after engagement with messages related to profiles subscribing to a list.

metric

Subscribed to List (opens)

Subscribed to List (opens)

The total number of times messages related to profiles subscribing to a list were opened.

metric

Subscribed to List (opens_unique)

Subscribed to List (opens_unique)

The number of unique individuals who opened messages related to profiles subscribing to a list.

metric

Subscribed to List ({ID})

Subscribed to List ({ID})

A specific instance of the ‘Subscribed to List’ metric, identified by its unique metric ID.

dimension

Subscribed to List ({ID}) (Unique)

Subscribed to List ({ID}) (Unique)

The number of unique profiles who performed a ‘Subscribed to List’ event for a specific metric ID. This is a measurement type available when querying metric aggregates.

dimension

Subscribed to SMS Marketing ({ID})

Subscribed to SMS Marketing ({ID})

A specific instance of the metric tracking when a profile subscribes to SMS marketing.

metric

Subscribed to SMS Marketing ({ID}) (Unique)

Subscribed to SMS Marketing ({ID}) (Unique)

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.

metric

Template Id

Template Id

The unique identifier for the email or SMS template used in a campaign message.

dimension

Unsubscribed ({ID})

Unsubscribed ({ID})

A specific instance of the ‘Unsubscribed’ (now ‘Clicked email to unsubscribe’) metric, identified by its unique metric ID.

metric

Unsubscribed ({ID}) (Unique)

Unsubscribed ({ID}) (Unique)

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.

metric

Unsubscribed from Email Marketing ({ID}) (count)

Unsubscribed from Email Marketing ({ID}) (count)

The total number of times profiles unsubscribed from email marketing, based on a specific metric ID.

metric

Unsubscribed from Email Marketing ({ID}) (unique)

Unsubscribed from Email Marketing ({ID}) (unique)

The number of unique profiles who unsubscribed from email marketing, based on a specific metric ID.

metric

Unsubscribed from List (clicks)

Unsubscribed from List (clicks)

The total number of clicks associated with messages related to profiles unsubscribing from a list. This indicates engagement with the unsubscription process or related communications.

metric

Unsubscribed from List (conversions)

Unsubscribed from List (conversions)

The number of times a conversion event occurred after engagement with messages related to profiles unsubscribing from a list.

metric

Unsubscribed from List (opens)

Unsubscribed from List (opens)

The total number of times messages related to profiles unsubscribing from a list were opened.

metric

Unsubscribed from List (opens_unique)

Unsubscribed from List (opens_unique)

The number of unique individuals who opened messages related to profiles unsubscribing from a list.

metric

Unsubscribed from List ({ID})

Unsubscribed from List ({ID})

A specific instance of the ‘Unsubscribed from List’ metric, identified by its unique metric ID.

dimension

Unsubscribed from List ({ID}) (Unique)

Unsubscribed from List ({ID}) (Unique)

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.

dimension

Unsubscribed from List ({ID}) (count)

Unsubscribed from List ({ID}) (count)

The total count of profiles who unsubscribed from a specific marketing list, based on a specific metric ID.

metric

Unsubscribed from SMS Marketing ({ID})

Unsubscribed from SMS Marketing ({ID})

A specific instance of the metric tracking when a profile unsubscribes from SMS marketing.

metric

Unsubscribed from SMS Marketing ({ID}) (Unique)

Unsubscribed from SMS Marketing ({ID}) (Unique)

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.

metric

Unsubscribed from SMS Marketing ({ID}) (count)

Unsubscribed from SMS Marketing ({ID}) (count)

The total count of profiles who unsubscribed from SMS marketing, based on a specific metric ID.

metric

Updated

Updated

The timestamp indicating when an object, such as a profile, metric, or campaign, was last updated in Klaviyo.

dimension

Updated Email Preferences ({ID})

Updated Email Preferences ({ID})

A specific instance of the ‘Updated Email Preferences’ metric, identified by its unique metric ID.

dimension

Updated Email Preferences ({ID}) (Unique)

Updated Email Preferences ({ID}) (Unique)

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.

dimension

Updated at

Updated at

The timestamp indicating when a particular Klaviyo object (e.g., profile, metric, campaign, list) was last updated.

dimension

User Registration ({ID})

User Registration ({ID})

The total count of events where a new user successfully registered an account on the website or platform.

metric

User Registration ({ID}) (Unique)

User Registration ({ID}) (Unique)

The number of unique profiles who registered a new user account.

metric

User Registration - {PLACEHOLDER} ({ID})

User Registration - {PLACEHOLDER} ({ID})

The total count of ‘User Registration’ events for a specific metric ID.

dimension

User Registration - {PLACEHOLDER} ({ID}) (Unique)

User Registration - {PLACEHOLDER} ({ID}) (Unique)

The unique count of ‘User Registration’ events for a specific metric ID.

dimension

Viewed ({ID})

Viewed ({ID})

An event indicating that a specific item or content, identified by {ID}, was viewed by a customer.

dimension

Viewed ({ID}) (Unique)

Viewed ({ID}) (Unique)

The number of unique profiles who performed a general ‘view’ event, such as viewing a product or a page.

dimension

Viewed Product ({ID})

Viewed Product ({ID})

A specific instance of the ‘Viewed Product’ metric, identified by its unique metric ID.

metric

Viewed Product ({ID}) (Unique)

Viewed Product ({ID}) (Unique)

The number of unique profiles who performed a ‘Viewed Product’ event for a specific metric ID. This is a measurement type available when querying metric aggregates.

metric

average_order_value

average_order_value

The average monetary value of orders placed by customers. This is a key e-commerce performance indicator, calculated as total revenue divided by the total number of orders.

metric

bounced

bounced

The total number of emails that could not be successfully delivered to recipients. This includes both hard bounces (permanent delivery failures) and soft bounces (temporary delivery failures).

metric

campaign_id

campaign_id

A unique identifier for a specific marketing campaign in Klaviyo.

dimension

campaign_message_id

campaign_message_id

A unique identifier for a specific message within a marketing campaign in Klaviyo.

dimension

clicks

clicks

The total number of times links within an email or SMS message were clicked, including multiple clicks by the same individual.

metric

clicks_unique

clicks_unique

The number of distinct individuals who clicked a link within an email or SMS message. This measures unique engagement with content.

metric

conversion_uniques

conversion_uniques

The number of unique profiles that completed a conversion event after engaging with a message or campaign.

metric

conversion_value

conversion_value

The total monetary value generated from conversion events, typically representing revenue attributed to campaigns or flows.

metric

conversions

conversions

The total number of times a desired action (conversion) was completed, typically after engagement with a message or campaign.

metric

day

day

A time increment used for aggregating or filtering data to view daily performance or trends.

dimension

delivered

delivered

The total number of email or SMS messages that were successfully delivered to recipients.

metric

endDate

endDate

The end date of a specified time range, used for filtering or querying data within a particular period.

dimension

failed

failed

The number of messages that failed to be delivered to recipients due to various reasons, including system errors or client-side issues.

metric

opens

opens

The total number of times an email or SMS message was opened, including multiple opens by the same individual.

metric

opens_unique

opens_unique

The number of distinct individuals who opened an email or SMS message. This measures unique engagement with the message content.

metric

recipients

recipients

The total number of unique individuals intended to receive a message from a campaign or flow.

metric

revenue_per_recipient

revenue_per_recipient

The average revenue generated per recipient for a given campaign or automated flow, calculated by dividing total revenue by the number of recipients.

metric

send_channel

send_channel

The communication channel used to send a message, such as email, SMS, or push notification.

dimension

spam_complaints

spam_complaints

The total number of times recipients reported an email message as spam. A high rate negatively impacts sender reputation and email deliverability.

metric

startDate

startDate

The start date of a specified time range, used for filtering or querying data within a particular period.

dimension

text_message_spend

text_message_spend

The total cost incurred for sending text messages as part of campaigns or flows.

metric

time

time

The timestamp or specific time associated with an event or data point, used for filtering or grouping data by time.

dimension

unsubscribe_page_submit ({ID}) (count)

unsubscribe_page_submit ({ID}) (count)

The total count of submissions on an unsubscribe page, based on a specific metric ID.

metric

unsubscribe_page_submit ({ID}) (unique)

unsubscribe_page_submit ({ID}) (unique)

The number of unique submissions on an unsubscribe page, based on a specific metric ID.

metric

unsubscribe_uniques

unsubscribe_uniques

The total number of unique individuals who unsubscribed from email or SMS marketing.

metric

unsubscribes

unsubscribes

The total number of times individuals unsubscribed from email or SMS marketing.

metric