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:
- Click Analytics - Every user interaction with buttons, links, and elements
- Error Monitoring - Technical issues affecting your users
- Page Performance - Views, duration, and engagement metrics
- Scroll Tracking - How users consume your content
- 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: 1What 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: 1What 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 loadWhat 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 userWhat 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
| Page | Views | Clicks | Errors | Visitors | Avg Duration | Scroll Depth | Click Rate | Engagement |
|---|---|---|---|---|---|---|---|---|
| Home | 15 | 3 | 9 | 1 | 18.8s | 90.0% | 20.0% | 63 |
| /form | 14 | 17 | 0 | 1 | 16.6s | — | 121.4% | 76 |
| /error | 4 | 0 | 1 | 1 | 12.0s | — | 0.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 secondsWhat 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 secondsWhat 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 engagedHow 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 content5. 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 AMWhat 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:
- Reduce number of form fields
- Add trust signals (security badges)
- Improve error messages
- Add progress indicators
- 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 AMWhat 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 cartcheckout_started- User begins checkoutpurchase_completed- Order placedpayment_failed- Payment issues
User Actions:
user_registered- New account createduser_logged_in- Login eventprofile_updated- Profile changessubscription_started- New subscriber
Engagement:
video_played- Video engagementpdf_downloaded- Resource downloadsarticle_shared- Social sharingcomment_posted- User comments
Forms:
form_started- User begins formform_abandoned- User leaves without submittingform_submitted- Form completedform_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 timeBusiness 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 viewsBusiness 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_watchedBusiness 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 dataWeek 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
- Email: support@youranalytics.com
- Chat: Available in dashboard
- Knowledge Base: /docs/help
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!