Conscia Track API: Tracking Events

The Conscia Track API offers robust and flexible event tracking capabilities, designed to capture a wide array of user interactions that can be used for granular analysis and metrics calculations in your experiments.

Types of Events

Conscia's Track API is built to record numerous types of events, ranging from simple to complex, allowing you to gain a comprehensive understanding of user behaviors and experiences. Here are some examples:

Page Views: Track every time a user lands on a specific page.
Button Clicks: Record whenever a user clicks on a particular button.
Form Submissions: Capture each instance when a user submits a form.
Purchase Completions: Monitor every completed purchase transaction.

Interaction Data:

Scroll Depth: Measure how far users scroll on your webpage.
Time Spent: Monitor the duration a user spends on specific pages or sections.
Item Interactions: Track interactions with specific items, like clicks on a product, adding items to a cart, etc.

Qualitative Data:

User Satisfaction Scores: Capture user satisfaction data, such as Net Promoter Score (NPS).
Survey Responses: Record responses to on-site surveys.
Feedback Submission: Track every time a user submits feedback through your platform.

Usage in Experiments

The events tracked through Conscia's Track API are critical inputs for your experiments. They serve as the raw data that feeds into your A/B tests, multivariate tests, or other types of experiments. These events are used in calculations of metrics tied to each experiment, providing quantifiable and actionable insights that help you optimize user experience and make strategic decisions based on real user data.

For instance, if you run an A/B test where variant A has a different button design than the control, tracking button clicks will allow you to understand which design led to more conversions. Or, if you are testing a new page layout, tracking scroll depth and time spent can help you understand how user engagement changed with the new design.

By leveraging the Conscia Track API, you gain a comprehensive understanding of user behaviors and the impact of your experiments, leading to data-informed decisions that optimize user experiences and drive business growth.

Please refer to the API reference documentation for technical details on implementing event tracking using the Conscia Track API.

Semantic Event Reference

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
Ecommerce
Email
Live Chat
B2B Saas

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

Property	Type	Description
experimentId	String	The experiment’s ID.
experimentName	String	The experiment’s human-readable name.
variationId	String	The variations’s ID.
variationName	String	The variation’s human-readable name.

Ecommerce

Customer Journey Category	Event Name
Browsing	Products 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

Product List Viewed

Properties

Product List Filtered

Properties

Promotion Viewed

Properties

Promotion Clicked

Properties

Product Clicked

Properties

Product Viewed

Properties

Product Added

Properties

Product Removed

Properties

Cart Viewed

Properties

Checkout Started

Properties

Checkout Step Viewed

Properties

Checkout Step Completed

Properties

Payment Info Entered

Properties

Order Completed

Properties

Order Updated

Properties

Order Refunded

Properties

Order Cancelled

Properties

Coupon Entered

Properties

Coupon Applied

Properties

Coupon Denied

Properties

Coupon Removed

Properties

Product Added to Wishlist

Properties

Product Removed from Wishlist

Properties

Wishlist Product Added to Cart

Properties

Product Shared

Properties

Cart Shared

Properties

Product Reviewed

Properties

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

Email Delivered

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

Properties

Email Link Clicked

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

Properties

Email Marked as Spam

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

Properties

Email Opened

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

Properties

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

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

Live Chat Conversation Ended

Properties

Live Chat Message Sent

Properties

Live Chat Message Received

Properties

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

Conscia Track API: Tracking Events

Types of Events​

User Actions:​

Interaction Data:​

Qualitative Data:​

Usage in Experiments​

Semantic Event Reference​

A/B Testing​

Experiment Viewed​

Properties​

Ecommerce​

Products Searched​

Properties​

Product List Viewed​

Properties​

Product List Filtered​

Properties​

Promotion Viewed​

Properties​

Promotion Clicked​

Properties​

Product Clicked​

Properties​

Product Viewed​

Properties​

Product Added​

Properties​

Product Removed​

Properties​

Cart Viewed​

Properties​

Checkout Started​

Properties​

Checkout Step Viewed​

Properties​

Checkout Step Completed​

Properties​

Payment Info Entered​

Properties​

Order Completed​

Properties​

Order Updated​

Properties​

Order Refunded​

Properties​

Order Cancelled​

Properties​

Coupon Entered​

Properties​

Coupon Applied​

Properties​

Coupon Denied​

Properties​

Coupon Removed​

Properties​

Product Added to Wishlist​

Properties​

Product Removed from Wishlist​

Properties​

Wishlist Product Added to Cart​

Properties​

Product Shared​

Properties​

Cart Shared​

Properties​

Product Reviewed​

Properties​

Email​

Email Bounced​

Properties​

Email Delivered​

Properties​

Email Link Clicked​

Properties​

Email Marked as Spam​

Properties​

Email Opened​

Properties​

Unsubscribed​

Properties​

Types of Events

User Actions:

Interaction Data:

Qualitative Data:

Usage in Experiments

Semantic Event Reference

A/B Testing

Experiment Viewed

Properties

Ecommerce

Products Searched

Properties

Product List Viewed

Properties

Product List Filtered

Properties

Promotion Viewed

Properties

Promotion Clicked

Properties

Product Clicked

Properties

Product Viewed

Properties

Product Added

Properties

Product Removed

Properties

Cart Viewed

Properties

Checkout Started

Properties

Checkout Step Viewed

Properties

Checkout Step Completed

Properties

Payment Info Entered

Properties

Order Completed

Properties

Order Updated

Properties

Order Refunded

Properties

Order Cancelled

Properties

Coupon Entered

Properties

Coupon Applied

Properties

Coupon Denied

Properties

Coupon Removed

Properties

Product Added to Wishlist

Properties

Product Removed from Wishlist

Properties

Wishlist Product Added to Cart

Properties

Product Shared

Properties

Cart Shared

Properties

Product Reviewed

Properties

Email

Email Bounced

Properties

Email Delivered

Properties

Email Link Clicked

Properties

Email Marked as Spam

Properties

Email Opened

Properties

Unsubscribed

Properties

Live Chat