Skip to main content

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:

User Actions:

  • 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

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.

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