Files
stack/packages/mosaic/framework/skills/analytics-tracking/references/event-library.md
T
fargo 1a822493ba format: apply repo prettier (3.8.1) to the folded skills tree
963 markdown files reformatted with the repository's pinned prettier so
pnpm format:check covers the folded tree like every other repo file.

The formatter's embedded-language pass also normalized code fences
(TS semicolons, closed HTML tags in examples, lowercased CSS hex colors,
one renumbered list that skipped an index). Alphanumeric token deltas vs
the fold commit were audited file-by-file; all are formatter-equivalent
markup normalizations plus the four sanitized skills.
2026-08-19 14:37:17 -05:00

11 KiB

Event Library Reference

Comprehensive list of events to track by business type and context.

Marketing Site Events

Navigation & Engagement

Event Name Description Properties
page_view Page loaded (enhanced) page_title, page_location, content_group
scroll_depth User scrolled to threshold depth (25, 50, 75, 100)
outbound_link_clicked Click to external site link_url, link_text
internal_link_clicked Click within site link_url, link_text, location
video_played Video started video_id, video_title, duration
video_completed Video finished video_id, video_title, duration

CTA & Form Interactions

Event Name Description Properties
cta_clicked Call to action clicked button_text, cta_location, page
form_started User began form form_name, form_location
form_field_completed Field filled form_name, field_name
form_submitted Form successfully sent form_name, form_location
form_error Form validation failed form_name, error_type
resource_downloaded Asset downloaded resource_name, resource_type

Conversion Events

Event Name Description Properties
signup_started Initiated signup source, page
signup_completed Finished signup method, plan, source
demo_requested Demo form submitted company_size, industry
contact_submitted Contact form sent inquiry_type
newsletter_subscribed Email list signup source, list_name
trial_started Free trial began plan, source

Product/App Events

Onboarding

Event Name Description Properties
signup_completed Account created method, referral_source
onboarding_started Began onboarding -
onboarding_step_completed Step finished step_number, step_name
onboarding_completed All steps done steps_completed, time_to_complete
onboarding_skipped User skipped onboarding step_skipped_at
first_key_action_completed Aha moment reached action_type

Core Usage

Event Name Description Properties
session_started App session began session_number
feature_used Feature interaction feature_name, feature_category
action_completed Core action done action_type, count
content_created User created content content_type
content_edited User modified content content_type
content_deleted User removed content content_type
search_performed In-app search query, results_count
settings_changed Settings modified setting_name, new_value
invite_sent User invited others invite_type, count

Errors & Support

Event Name Description Properties
error_occurred Error experienced error_type, error_message, page
help_opened Help accessed help_type, page
support_contacted Support request made contact_method, issue_type
feedback_submitted User feedback given feedback_type, rating

Monetization Events

Pricing & Checkout

Event Name Description Properties
pricing_viewed Pricing page seen source
plan_selected Plan chosen plan_name, billing_cycle
checkout_started Began checkout plan, value
payment_info_entered Payment submitted payment_method
purchase_completed Purchase successful plan, value, currency, transaction_id
purchase_failed Purchase failed error_reason, plan

Subscription Management

Event Name Description Properties
trial_started Trial began plan, trial_length
trial_ended Trial expired plan, converted (bool)
subscription_upgraded Plan upgraded from_plan, to_plan, value
subscription_downgraded Plan downgraded from_plan, to_plan
subscription_cancelled Cancelled plan, reason, tenure
subscription_renewed Renewed plan, value
billing_updated Payment method changed -

E-commerce Events

Browsing

Event Name Description Properties
product_viewed Product page viewed product_id, product_name, category, price
product_list_viewed Category/list viewed list_name, products[]
product_searched Search performed query, results_count
product_filtered Filters applied filter_type, filter_value
product_sorted Sort applied sort_by, sort_order

Cart

Event Name Description Properties
product_added_to_cart Item added product_id, product_name, price, quantity
product_removed_from_cart Item removed product_id, product_name, price, quantity
cart_viewed Cart page viewed cart_value, items_count

Checkout

Event Name Description Properties
checkout_started Checkout began cart_value, items_count
checkout_step_completed Step finished step_number, step_name
shipping_info_entered Address entered shipping_method
payment_info_entered Payment entered payment_method
coupon_applied Coupon used coupon_code, discount_value
purchase_completed Order placed transaction_id, value, currency, items[]

Post-Purchase

Event Name Description Properties
order_confirmed Confirmation viewed transaction_id
refund_requested Refund initiated transaction_id, reason
refund_completed Refund processed transaction_id, value
review_submitted Product reviewed product_id, rating

B2B / SaaS Specific Events

Team & Collaboration

Event Name Description Properties
team_created New team/org made team_size, plan
team_member_invited Invite sent role, invite_method
team_member_joined Member accepted role
team_member_removed Member removed role
role_changed Permissions updated user_id, old_role, new_role

Integration Events

Event Name Description Properties
integration_viewed Integration page seen integration_name
integration_started Setup began integration_name
integration_connected Successfully connected integration_name
integration_disconnected Removed integration integration_name, reason

Account Events

Event Name Description Properties
account_created New account source, plan
account_upgraded Plan upgrade from_plan, to_plan
account_churned Account closed reason, tenure, mrr_lost
account_reactivated Returned customer previous_tenure, new_plan

Event Properties (Parameters)

Standard Properties to Include

User Context:

user_id: "12345"
user_type: "free" | "trial" | "paid"
account_id: "acct_123"
plan_type: "starter" | "pro" | "enterprise"

Session Context:

session_id: "sess_abc"
session_number: 5
page: "/pricing"
referrer: "https://google.com"

Campaign Context:

source: "google"
medium: "cpc"
campaign: "spring_sale"
content: "hero_cta"

Product Context (E-commerce):

product_id: "SKU123"
product_name: "Product Name"
category: "Category"
price: 99.99
quantity: 1
currency: "USD"

Timing:

timestamp: "2024-01-15T10:30:00Z"
time_on_page: 45
session_duration: 300

Funnel Event Sequences

Signup Funnel

  1. signup_started
  2. signup_step_completed (email)
  3. signup_step_completed (password)
  4. signup_completed
  5. onboarding_started

Purchase Funnel

  1. pricing_viewed
  2. plan_selected
  3. checkout_started
  4. payment_info_entered
  5. purchase_completed

E-commerce Funnel

  1. product_viewed
  2. product_added_to_cart
  3. cart_viewed
  4. checkout_started
  5. shipping_info_entered
  6. payment_info_entered
  7. purchase_completed