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
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
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
Email Link Clicked
This event should be fired when the recipient clicks on a link in the email’s body.
Properties
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