Skip to Content
GuidesReports

Analytics Platform Documentation

This powerful analytics platform automatically tracks user behavior on your website, giving you actionable insights to improve user experience and boost conversions. All data base on sample data from our demo site.


What Does This Platform Track?

Our analytics system monitors 5 key areas of user behavior:

  1. Click Analytics - Every user interaction with buttons, links, and elements
  2. Error Monitoring - Technical issues affecting your users
  3. Page Performance - Views, duration, and engagement metrics
  4. Scroll Tracking - How users consume your content
  5. Custom Events - Business-specific actions you want to measure
  • see this Dashbord -> Log & Issued for real data examples.

1. Click Analytics - Track User Interactions

What You’ll See

Every time a user clicks on your website, we capture:

  • Which page they clicked on
  • What element they clicked (button, link, image)
  • How many times they clicked
  • Click-through rates and patterns

Real Example from Our Platform

Here’s actual data from a user tracking 2 pages on our demo site :

Example: Form Page Performance

Page: /form Total Clicks: 17 Total Views: 14 Click Rate: 121.4% Unique Users: 1

What This Tells You:

  • Users clicked 17 times across 14 page views
  • 121.4% click rate means users clicked multiple times per visit
  • Highly interactive page - users are engaging with your content!

Element Breakdown:

Button clicks: 4 (23.5%) Link clicks: 13 (76.5%)

Insights You Get:

  • Users are actively engaging with your form
  • 76.5% of clicks are on links - users might be seeking help/info
  • Opportunity: Increase button clicks by improving CTAs

Example: Home Page Performance

Page: Home (/) Total Clicks: 3 Total Views: 15 Click Rate: 20.0% Unique Users: 1

What This Tells You:

  • Lower engagement compared to form page
  • Only 1 out of 5 views resulted in clicks
  • Users are browsing but not taking action

Element Breakdown:

Link clicks: 3 (100%) Button clicks: 0 (0%)

Insights You Get:

  • No button clicks - weak call-to-action
  • Recommendation: Add prominent CTA buttons
  • Opportunity: Improve from 20% to 50%+ click rate

How This Helps Your Business

Before Analytics:

  • “Are users clicking our buttons?” - Unknown
  • “Which pages are engaging?” - Guessing
  • “What elements do users interact with?” - No idea

After Analytics:

  • See exactly which elements get clicked
  • Identify high-performing vs low-performing pages
  • Make data-driven design decisions
  • Optimize for better user engagement

2. Error Monitoring - Catch Problems Before Users Leave

What You’ll See

We automatically detect and report:

  • Technical errors on your pages
  • Which elements are failing
  • How many users are affected
  • When errors occurred

Real Example from Our Platform

Example: Image Loading Error on Home Page

Page: Home (/) Total Errors: 9 errors Affected Users: 1 user Error Type: system_error Problem Element: <img src="https://d.umijs.org/logo.svg">

Timeline of Errors:

28 Jan 2026, 9:38 AM - Image failed to load 24 Jan 2026, 11:11 AM - Image failed to load 24 Jan 2026, 11:10 AM - Image failed to load 24 Jan 2026, 11:01 AM - Image failed to load 24 Jan 2026, 10:56 AM - Image failed to load

What This Tells You:

  • Critical issue: Logo image not loading
  • Error repeating multiple times
  • Needs immediate fix

Actionable Solution:

// Problem: External CDN failing <img src="https://d.umijs.org/logo.svg" /> // Solution: Host locally <img src="/logo.svg" alt="Company Logo" />

Example: Error Page Has Error (Meta Problem!)

Page: /error Total Errors: 1 error Affected Users: 1 user

What This Tells You:

  • Your error page itself is broken
  • High priority fix - users expect error pages to work
  • Error pages should be simple and self-contained

How This Helps Your Business

Without Error Monitoring:

  • Users encounter errors silently
  • You don’t know what’s broken
  • Users leave frustrated
  • Revenue lost

With Error Monitoring:

  • Instant alerts when errors occur
  • See exactly what’s failing
  • Fix issues before they impact many users
  • Maintain professional user experience

3. Page Performance Analytics

What You’ll See

Comprehensive metrics for every page:

  • Page views and unique visitors
  • Time spent on page
  • Engagement scores
  • Cross-page comparisons

Real Example from Our Platform

Complete Page Overview

PageViewsClicksErrorsVisitorsAvg DurationScroll DepthClick RateEngagement
Home1539118.8s90.0%20.0%63
/form14170116.6s121.4%76
/error401112.0s0.0%34

Key Insights:

Home Page:

  • Most viewed (15 views)
  • Lowest click rate (20%)
  • Most errors (9 errors)
  • High scroll depth (90%) - users read content
  • Action: Fix errors, improve CTAs

/form Page:

  • Highest engagement (76 score)
  • Best click rate (121.4%)
  • No errors
  • Action: This page works well - replicate patterns

/error Page:

  • Lowest engagement (34 score)
  • 0% click rate (expected)
  • Has 1 error (not expected!)
  • Action: Fix the error page error

Page Duration Analysis

Page: Home Views: 6 Average Duration: 18.8 seconds Minimum: 6.0 seconds Maximum: 33.0 seconds Total Time: 1 minute 53 seconds

What This Tells You:

  • Users spend ~19 seconds on homepage
  • Some quick visits (6s) and some engaged visits (33s)
  • Good variation shows different user intents
Page: /form Views: 5 Average Duration: 16.6 seconds Minimum: 9.0 seconds Maximum: 33.0 seconds Total Time: 1 minute 23 seconds

What This Tells You:

  • Users spend ~17 seconds interacting with form
  • Consistent engagement across visits
  • Reasonable time for form completion

How This Helps Your Business

Key Questions Answered:

  • Which pages perform best?
  • Where do users spend most time?
  • Which pages need improvement?
  • What’s your content engagement level?

Business Decisions You Can Make:

  • Prioritize fixing high-traffic pages
  • Optimize low-performing pages
  • Focus resources on high-engagement content
  • Improve user journeys based on data

4. Scroll Depth Tracking - See How Users Read Your Content

What You’ll See

Understand how users consume your content:

  • Average scroll depth (how far they scroll)
  • Finish rate (how many reach the bottom)
  • Pixel measurements
  • Engagement patterns

Real Example from Our Platform

Home Page Scroll Analysis

Page: Home Unique Users: 1 Total Scroll Events: 5 Average Scroll Depth: 90.0% Maximum Depth: 100.0% Average Pixels Scrolled: 1,625 pixels Finish Rate: 80.0%

What This Tells You:

  • Excellent engagement! Users scroll 90% on average
  • 80% of users reach the bottom of the page
  • Page is ~1,625 pixels tall
  • Users are reading your content, not bouncing

Interpretation Guide:

0-25% scroll depth = Poor - Users barely scroll 25-50% scroll depth = Moderate - Some engagement 50-75% scroll depth = Good - Users interested 75-100% scroll depth = Excellent - Highly engaged

How This Helps Your Business

Content Optimization:

  • Know if users actually read your content
  • Identify where users stop scrolling
  • Place important CTAs where users actually reach
  • Optimize content length based on engagement

Business Insights:

Low scroll depth (<50%)? → Content too long or not engaging → Shorten content or improve headlines High scroll depth (>75%)? → Content is engaging ✓ → Users want to read more → Consider adding more content

5. Custom Events - Track Your Business Goals

What You’ll See

Track specific actions that matter to your business:

  • Form submissions
  • Sign ups
  • Purchases
  • Feature usage
  • Any custom action you define

Real Example from Our Platform

Custom Events Dashboard

Unique Events: 2 different event types Total Triggers: 3 times events fired Total Users: 2 users who performed actions Success Rate: 100% (all events succeeded)

Event 1: Form Submissions

Event Name: form_submitted Category: form_submission Total Triggers: 2 Success Rate: 100% Last Occurred: 24 Jan 2026, 11:00 AM

What This Tracks:

  • When users submit your contact/signup form
  • Success vs failure rate
  • Form conversion metrics

Business Metrics:

Form Views: 14 Form Submissions: 2 Conversion Rate: 14.3% Industry Average: 20-40% Your Performance: 14.3% Gap to Close: +6-26%

Actionable Insights:

  • Form technically works (100% success)
  • Low conversion (only 14.3%)
  • Opportunity: Improve from 14% to 25%+

How to Improve:

  1. Reduce number of form fields
  2. Add trust signals (security badges)
  3. Improve error messages
  4. Add progress indicators
  5. Make “Submit” button more prominent

Event 2: Email Field Interaction

Event Name: email_input_clicked Category: interaction Object ID: email_input_field Total Triggers: 1 Success Rate: 100% Last Occurred: 24 Jan 2026, 11:02 AM

What This Tracks:

  • When users click on the email input field
  • Field-level interaction analytics
  • User journey through form

Timeline:

11:00 AM - Form submitted 11:02 AM - Email field clicked (2 min later)

Possible Scenarios:

  • User came back to verify email
  • Form didn’t clear after submission
  • User re-entering information

How to Implement Custom Events

In Your Code:

// Track form submission form.addEventListener("submit", (e) => { analytics.track("form_submitted", { category: "form_submission", status: "success", formType: "contact", }); }); // Track button clicks button.addEventListener("click", () => { analytics.track("signup_clicked", { category: "conversion", buttonLocation: "header", }); }); // Track purchases function completePurchase(orderId, amount) { analytics.track("purchase_completed", { category: "ecommerce", status: "success", orderId: orderId, amount: amount, }); }

Common Custom Events to Track

E-commerce:

  • add_to_cart - Product added to cart
  • checkout_started - User begins checkout
  • purchase_completed - Order placed
  • payment_failed - Payment issues

User Actions:

  • user_registered - New account created
  • user_logged_in - Login event
  • profile_updated - Profile changes
  • subscription_started - New subscriber

Engagement:

  • video_played - Video engagement
  • pdf_downloaded - Resource downloads
  • article_shared - Social sharing
  • comment_posted - User comments

Forms:

  • form_started - User begins form
  • form_abandoned - User leaves without submitting
  • form_submitted - Form completed
  • form_validation_error - Submission errors

Real-World Use Cases

Use Case 1: E-commerce Store

What You Track:

Click Analytics: - "Add to Cart" button clicks - Product page views - Checkout button clicks Custom Events: - add_to_cart - checkout_started - purchase_completed - payment_failed Page Performance: - Product page engagement - Cart abandonment rate - Checkout completion time

Business Impact:

  • Identify which products get most engagement
  • Track actual conversion rates
  • Reduce cart abandonment
  • Fix payment failures quickly

Use Case 2: SaaS Platform

What You Track:

Click Analytics: - "Start Free Trial" clicks - Feature usage clicks - Settings interactions Custom Events: - trial_started - feature_activated - subscription_upgraded - user_invited_teammate Page Performance: - Dashboard engagement - Feature page visits - Help page views

Business Impact:

  • Track user activation
  • Measure feature adoption
  • Optimize upgrade funnel
  • Identify power users

Use Case 3: Content/Blog Site

What You Track:

Scroll Tracking: - Article read depth - Finish rates - Time on page Click Analytics: - Social share buttons - Related article clicks - Newsletter signups Custom Events: - article_read_100% - newsletter_subscribed - pdf_downloaded - video_watched

Business Impact:

  • Know which content resonates
  • Grow email list
  • Increase page views per session
  • Optimize ad placements

Sample Dashboard View

Here’s what you’ll see when you log in:

╔══════════════════════════════════════════════════╗ ║ ANALYTICS DASHBOARD - LAST 7 DAYS ║ ╚══════════════════════════════════════════════════╝ OVERVIEW METRICS ┌─────────────────────────────────────────────────┐ │ Total Page Views 33 │ │ Total Clicks 20 │ │ Average Click Rate 70.7% Excellent │ │ Total Errors 10 Needs Attention│ │ Average Scroll Depth 90% Outstanding │ └─────────────────────────────────────────────────┘ TOP PERFORMING PAGES ┌─────────────────────────────────────────────────┐ │ 1. /form 76 engagement │ │ 2. Home 63 engagement │ │ 3. /error 34 engagement │ └─────────────────────────────────────────────────┘ ISSUES REQUIRING ATTENTION ┌─────────────────────────────────────────────────┐ │ Home: 9 image loading errors │ │ /error: Error page has 1 error │ │ Home: Low click rate (20%) - Add CTAs │ └─────────────────────────────────────────────────┘ RECENT CUSTOM EVENTS ┌─────────────────────────────────────────────────┐ │ form_submitted 2 triggers ✓ 100% success│ │ email_input_clicked 1 trigger ✓ 100% success│ └─────────────────────────────────────────────────┘

What Success Looks Like

Week 1: Before Analytics

- "Are users engaging with our site?" - No idea - "Which pages have problems?" - Unknown - "Is our form working?" - Guessing - "What should we improve?" - No data

Week 4: After Analytics

- "Click rate improved from 20% to 45%" - "Fixed 9 image errors - no more broken pages" - "Form conversion up from 14% to 28%" - "Data-driven decisions, measurable results"

Key Benefits Summary

1. Know Your Users

  • See exactly how users interact with your site
  • Understand what they click, read, and engage with
  • Make informed design decisions

2. Catch Problems Early

  • Get instant alerts when errors occur
  • Fix issues before they impact many users
  • Maintain professional experience

3. Optimize Conversions

  • Track your conversion funnels
  • Identify and fix bottlenecks
  • Improve conversion rates with data

4. Save Time & Money

  • Stop guessing, start knowing
  • Focus efforts on what actually matters
  • Measure ROI of changes

5. Data-Driven Growth

  • Make decisions based on real data
  • Test and validate improvements
  • Continuously optimize performance

Learn More

Documentation Sections

Video Tutorials

  • Getting Started (5 min)
  • Setting Up Custom Events (10 min)
  • Dashboard Deep Dive (15 min)

Support


Frequently Asked Questions

Q: How long until I see data? A: Immediately! Data appears in real-time once SDK is installed.

Q: What’s the difference between automatic and custom tracking? A: Automatic tracks clicks, views, scrolls automatically. Custom events track specific business actions you define (signups, purchases, etc.).

Q: Can I track mobile apps? A: Yes! We support web, iOS, and Android.

Q: Is there a free tier? A: Yes! Free tier includes up to 10,000 events/month.

Q: How is privacy handled? A: We’re GDPR compliant, don’t track PII, and anonymize user data.


Ready to understand your users better?

Start tracking today and make data-driven decisions that grow your business!

Last updated on