Skip to main content

Semantic Events

Semantic Events define a standard list of events and their properties (using the track method) that should be used to describe various activities across verticals and applications.

Types of Semantic Events

A/B Testing

Event Name
Experiment Viewed
Variant Rewarded

Experiment Viewed

The DX Engine will autmatically send this event when a A/B Testing Component Rule is triggered. When this happens, the Experiment ID is the Component Rule Code.

Properties

PropertyTypeDescription
experimentIdStringThe experiment’s ID.
experimentNameStringThe experiment’s human-readable name.
variationIdStringThe variations’s ID.
variationNameStringThe variation’s human-readable name.

Variant Rewarded

The DX Engine uses this Event for calculating Multi-armed bandit decisioning. This event should be sent in order to reward a Variant. For example, if a variant what shown in a visitor's session, that variant may be rewarded with a value of 5 for an add-to-basket or a value of 10 for a purchase. The DX Engine will periodically use these events to update the Multi-arm Bandit algorithm used for the corresponding experiments.

Properties

PropertyTypeDescription
experimentIdStringThe experiment’s ID.
variationIdStringThe variations’s ID.
rewardNumberThe rewarded amount.

Ecommerce

Customer Journey CategoryEvent Name
BrowsingProducts Searched
Browsing[Product List Viewed]
Browsing[Product List Filtered]
Promotions[Promotion Viewed]
Promotion[Promotion Clicked]
Core Ordering[Product Clicked]
Core Ordering[Product Viewed]
Core Ordering[Product Added]
Core Ordering[Product Removed]
Core Ordering[Cart Viewed]
Core Ordering[Checkout Started]
Core Ordering[Checkout Step Viewed]
Core Ordering[Checkout Step Completed]
Core Ordering[Payment Info Entered]
Core Ordering[Order Completed]
Core Ordering[Order Updated]
Core Ordering[Order Refunded]
Core Ordering[Order Cancelled]
Coupons[Coupon Entered]
Coupons[Coupon Applied]
Coupons[Coupon Denied]
Coupons[Coupon Removed]
Wishlisting[Product Added to Wishlist]
Wishlisting[Product Removed from Wishlist]
Wishlisting[Wishlist Product Added to Cart]
Sharing[Product Shared]
Sharing[Cart Shared]
Reviewing[Product Reviewed]

Products Searched

Properties

Documentation Coming Soon

Product List Viewed

Properties

Documentation Coming Soon

Product List Filtered

Properties

Documentation Coming Soon

Promotion Viewed

Properties

Documentation Coming Soon

Promotion Clicked

Properties

Documentation Coming Soon

Product Clicked

Properties

Documentation Coming Soon

Product Viewed

Properties

Documentation Coming Soon

Product Added

Properties

Documentation Coming Soon

Product Removed

Properties

Documentation Coming Soon

Cart Viewed

Properties

Documentation Coming Soon

Checkout Started

Properties

Documentation Coming Soon

Checkout Step Viewed

Properties

Documentation Coming Soon

Checkout Step Completed

Properties

Documentation Coming Soon

Payment Info Entered

Properties

Documentation Coming Soon

Order Completed

Properties

Documentation Coming Soon

Order Updated

Properties

Documentation Coming Soon

Order Refunded

Properties

Documentation Coming Soon

Order Cancelled

Properties

Documentation Coming Soon

Coupon Entered

Properties

Documentation Coming Soon

Coupon Applied

Properties

Documentation Coming Soon

Coupon Denied

Properties

Documentation Coming Soon

Coupon Removed

Properties

Documentation Coming Soon

Product Added to Wishlist

Properties

Documentation Coming Soon

Product Removed from Wishlist

Properties

Documentation Coming Soon

Wishlist Product Added to Cart

Properties

Documentation Coming Soon

Product Shared

Properties

Documentation Coming Soon

Cart Shared

Properties

Documentation Coming Soon

Product Reviewed

Properties

Documentation Coming Soon

Email

Event Name
Email Bounced
Email Delivered
Email Link Clicked
Email Marked as Spam
Email Opened
Unsubscribed

Email Bounced

This event should be sent when an email tool receives notice from an email server that an email is undeliverable.

Properties

Documentation Coming Soon

Email Delivered

This event should be fired when the receiving mail server confirms receipt of an email.

Properties

Documentation Coming Soon

This event should be fired when the recipient clicks on a link in the email’s body.

Documentation Coming Soon

Email Marked as Spam

This event should be fired when a recipient marks an email as spam.

Properties

Documentation Coming Soon

Email Opened

This event should be fired when the recipient opens the email.

Properties

Documentation Coming Soon

Unsubscribed

This event should be fired when the recipient unsubscribes from the email. The unsubscription can either happen for a particular list, or globally from all marketing emails, depending on the tool. Typically you cannot unsubscribe from a transactional email such as a password reset.

Properties

Documentation Coming Soon

Live Chat

Every Live Chat tool is built around the concept of “conversations” between an agent at the company and a customer who has a question.

Each conversation starts when a customer sends their first message. Within the conversation the customer receives and sends messages. In some situations the conversation also has a clearly recognizable end when the customer or agent explicitly indicates the conversation has ended.

Event Name
Live Chat Conversation Started
Live Chat Conversation Ended
Live Chat Message Sent
Live Chat Message Received

Live Chat Conversation Started

Properties

Documentation Coming Soon

Live Chat Conversation Ended

Properties

Documentation Coming Soon

Live Chat Message Sent

Properties

Documentation Coming Soon

Live Chat Message Received

Properties

Documentation Coming Soon

B2B SaaS

Event Name
Account Created
Account Deleted
Signed Up
Signed In
Signed Out
Invite Sent
Account Added User
Account Removed User
Trial Started
Trial Ended

Account Created

Properties

Documentation Coming Soon

Account Deleted

Properties

Documentation Coming Soon

Signed Up

Properties

Documentation Coming Soon

Signed In

Properties

Documentation Coming Soon

Signed Out

Properties

Documentation Coming Soon

Invite Sent

Properties

Documentation Coming Soon

Account Added User

Properties

Documentation Coming Soon

Account Removed User

Properties

Documentation Coming Soon

Trial Started

Properties

Documentation Coming Soon

Trial Ended

Properties

Documentation Coming Soon