Dashboard Guide
Complete guide to using your Databuddy analytics dashboard
📊 Dashboard Guide
Your Databuddy dashboard provides comprehensive analytics insights with real-time data, detailed reports, and powerful filtering capabilities.
Access: Visit app.databuddy.cc to view your analytics dashboard
🏠 Overview Tab
The overview tab gives you a high-level view of your website's performance with key metrics and trends.
📈 Key Metrics
Core Analytics
- Pageviews - Total page views across your site
- Visitors - Unique visitors (deduplicated by anonymous ID)
- Sessions - User sessions with 30-minute timeout
- Bounce Rate - Percentage of single-page sessions
- Session Duration - Average time spent per session
- Pages per Session - Average pages viewed per session
Performance Metrics
- Load Time - Average page load time
- TTFB - Time to First Byte
- Core Web Vitals - LCP, FCP, CLS when available
- Performance Score - Overall site performance rating
⏰ Time Range Selection
Choose from predefined time periods:
- Last 24 hours - Real-time insights
- Last 7 days - Weekly trends
- Last 30 days - Monthly overview
- Last 90 days - Quarterly analysis
Select any date range for specific analysis:
- Pick start and end dates
- Compare different periods
- Analyze specific campaigns or events
- Export data for custom ranges
Comparison Mode: Use the comparison toggle to compare your selected period with the previous period of the same length.
📊 Data Granularity
View your metrics at different granularities based on your time range:
📈 Charts and Visualizations
Interactive Metrics Chart:
- 📈 Line charts showing trends over time
- 🔍 Toggle different metrics on/off
- 🖱️ Interactive hover for detailed values
- 📱 Responsive design for mobile viewing
Performance Indicators:
- ✅ Green indicators for positive changes
- ⚠️ Red indicators for areas needing attention
- 📊 Percentage changes compared to previous period
- 🎯 Automatic calculation based on selected time range
📄 Top Pages
Discover your most popular content and page performance:
📊 Page Analytics
Page Metrics
- Page path and title - URL and page title
- Total pageviews - Number of views
- Unique visitors - Distinct users
- Average time on page - Engagement duration
- Bounce rate - Single-page session rate
Interactive Features
- Click to visit - Click page paths to open them
- Sort by metrics - Order by any column
- Pagination - Handle large datasets efficiently
- Search & filter - Find specific pages quickly
💡 Page Insights
Performance Tip: Pages with high bounce rates but long time-on-page often indicate quality content that doesn't require further navigation.
Use this data to:
- 🎯 Identify your most valuable content
- 🔍 Find pages that need optimization
- 📈 Track content performance over time
- 🚀 Optimize user journeys
🔗 Traffic Sources
Understand where your visitors come from and optimize your marketing efforts:
📊 Referrer Categories
📈 Traffic Analysis
For each source, you'll see:
- 👥 Visitor counts - Number of users from each source
- 📊 Percentage breakdown - Share of total traffic
- 🏷️ Source classification - Automatic categorization with icons
- 📈 Trend analysis - Growth or decline over time
🌍 Geographic Analytics
Discover your global audience and optimize for different regions:
🗺️ Geographic Breakdown
Country-Level Analytics:
- 🏳️ Country names with flag icons
- 👥 Visitor counts and percentages
- 📊 Interactive sortable data table
- 🌍 Geographic distribution insights
Use Cases:
- Identify primary markets
- Plan localization efforts
- Understand global reach
- Optimize content for regions
Detailed Location Data:
- 🏛️ State/province information
- 🏙️ City-level analytics (when available)
- 🕐 Time zone considerations
- 📍 Geographic clustering insights
Benefits:
- Local market analysis
- Regional campaign targeting
- Time zone optimization
- Location-based content strategy
Privacy Note: Location data is derived from IP addresses and anonymized. No precise location tracking is performed.
💻 Technology Stack Analysis
Understand your audience's technical environment:
📱 Device Analytics
Device Types
Categories:
- 🖥️ Desktop - Traditional computers
- 📱 Mobile - Smartphones and mobile devices
- 📟 Tablet - Tablets and large mobile devices
Metrics:
- Visitor distribution
- Device-specific performance
- User behavior patterns
Browser Information
Data Included:
- 🌐 Browser names and versions
- 📊 Market share among your visitors
- ⚡ Browser-specific performance data
- 🔧 Compatibility insights
🖥️ Operating System Insights
Platform Distribution:
- 🍎 macOS - Apple computers
- 🪟 Windows - Microsoft Windows
- 🐧 Linux - Linux distributions
- 📱 iOS - Apple mobile devices
- 🤖 Android - Android devices
Strategic Benefits:
- 🎯 Optimize for popular platforms
- 🐛 Debug platform-specific issues
- 📊 Understand technical demographics
- 🔧 Plan feature compatibility
Cross-Platform Considerations: Ensure your website works well across all popular platforms used by your audience.
🎯 Custom Events Analytics
Track and analyze your business-specific events with detailed property breakdowns:
📊 Enhanced Event Interface
Tree-Structure Analytics:
- 📊 Event Level - Overall event metrics and performance
- 📂 Property Categories - Organized property groupings with counts
- 🔍 Property Values - Individual values with percentage distributions
- 📈 Visual Hierarchy - Color-coded dots and professional typography
Event Display Features:
- 🎯 Event badges - Blue dots for main events
- 📊 Count displays - Total events and unique users
- 📈 Share percentages - Relative event frequency
- 🗓️ Occurrence tracking - First and last event timestamps
Automatic Property Analysis:
- 🏷️ Property extraction - All custom properties automatically categorized
- 📊 Value distribution - Percentage breakdown of property values
- 🔢 Count aggregation - Total occurrences per property value
- 📈 Category sorting - Properties sorted by frequency
Property Category Features:
- 📂 Category headers - Property names with aggregate counts
- 📊 Value lists - Individual property values with metrics
- 🎯 Usage indicators - Visual badges showing value counts
- 📈 Percentage pills - Clean percentage displays
Example Property Structure:
Event: purchase_completed (156 events, 89 users)
├── 📂 product_category (156 values)
│ ├── software: 98 (63%)
│ ├── hardware: 45 (29%)
│ └── services: 13 (8%)
├── 📂 payment_method (156 values)
│ ├── credit_card: 124 (79%)
│ ├── paypal: 22 (14%)
│ └── bank_transfer: 10 (6%)
User Experience Enhancements:
- 🔍 Individual toggles - Expand/collapse each property category independently
- 📊 Scrollable content - Handle large property lists with smooth scrolling
- 🎯 Visual feedback - Hover effects and transition animations
- 📱 Mobile responsive - Optimized for all device sizes
Navigation Features:
- ▶️ Expand arrows - Rotating chevrons indicate expansion state
- 📋 Value count badges - Show number of unique values per property
- 📊 Scroll indicators - Visual cues when content is scrollable
- 🎨 Professional styling - Subtle gradients and clean borders
Performance Optimizations:
- 🚀 Lazy rendering - Only render visible content
- 📊 Efficient scrolling - Max height limits with overflow handling
- 🎯 State management - Persistent expand/collapse states
- 📱 Touch optimization - Mobile-friendly interaction areas
🔍 Event Examples
E-commerce Events
{
"event": "purchase_completed",
"properties": {
"product_id": "prod_123",
"revenue": 29.99,
"currency": "USD",
"category": "software"
}
}
Engagement Events
{
"event": "feature_used",
"properties": {
"feature": "export_data",
"plan": "pro",
"usage_count": 5
}
}
⚡ Real-time Analytics
Coming Soon: Real-time analytics with WebSocket streaming will be available in the next major update.
🔮 Planned Features
Live Metrics Dashboard:
- 👥 Active visitors - Users currently on your site
- 📄 Current pageviews - Real-time page popularity
- 🔄 Live updates - Data refreshed automatically
- 📊 Real-time charts - Live data visualization
WebSocket Integration:
- 🚀 Instant updates - No page refresh needed
- ⚙️ Configurable intervals - Customize update frequency
- 🟢 Live indicators - Visual real-time status
- 📱 Mobile optimized - Real-time on all devices
🔍 Advanced Filtering & Segmentation
Slice and dice your data for specific insights:
🎛️ Available Filters
🎯 Segmentation Strategies
User Behavior Segments
- High-engagement users - Multiple page visits
- Quick browsers - Short session durations
- Deep readers - Long time on page
- Mobile-first users - Primarily mobile traffic
Technical Segments
- Performance impact - Fast vs slow connections
- Browser compatibility - Modern vs legacy browsers
- Device capabilities - Screen size and features
- Platform preferences - Operating system usage
📈 Performance Monitoring
Monitor your website's technical health and user experience:
⚡ Core Web Vitals
Essential Performance Metrics:
LCP - Largest Contentful Paint
Good: ≤ 2.5 seconds
Measures loading performance. Time until the largest content element is rendered.
FID - First Input Delay
Good: ≤ 100 milliseconds
Measures interactivity. Time from first user interaction to browser response.
CLS - Cumulative Layout Shift
Good: ≤ 0.1
Measures visual stability. Sum of all unexpected layout shift scores.
FCP - First Contentful Paint
Good: ≤ 1.8 seconds
Time until first content element is rendered on screen.
Optimization Strategies:
For LCP (Loading):
- 🖼️ Optimize images and videos
- 🚀 Use a fast CDN
- 📦 Minimize resource load times
- 🔄 Implement lazy loading
For FID (Interactivity):
- 📦 Reduce JavaScript bundle size
- ⚡ Optimize long-running tasks
- 🔄 Use web workers for heavy computation
- 📱 Improve mobile responsiveness
For CLS (Visual Stability):
- 📐 Set dimensions for images/videos
- 🎨 Avoid inserting content above existing content
- 📱 Use transform animations over layout changes
- 🔧 Preload web fonts
📊 Performance Analytics
Detailed Performance Data:
- 📈 Load time distribution - Histogram of page load times
- 📄 Performance by page - Page-specific metrics
- 📅 Performance trends - Changes over time
- 📱 Mobile vs desktop - Device-specific performance
Performance Tip: Use the performance data to identify slow pages and prioritize optimization efforts where they'll have the biggest impact.
🚨 Error Tracking & Debugging
Monitor and resolve issues affecting your users:
🐛 JavaScript Error Analytics
🔧 Error Resolution Workflow
- Identify - Spot errors in the dashboard
- Analyze - Review stack traces and context
- Prioritize - Focus on high-frequency errors
- Fix - Implement solutions
- Verify - Monitor error reduction
Error Impact: JavaScript errors can significantly impact user experience. Regular monitoring helps maintain site reliability.
📱 Mobile Dashboard Experience
Access your analytics on any device:
📱 Mobile Features
Optimized Mobile Interface:
- 📊 Touch-friendly charts and graphs
- 📱 Responsive table layouts
- 🔍 Mobile-optimized filtering
- ⚡ Fast loading on mobile networks
Mobile-Specific Insights:
- 📱 Mobile vs desktop performance comparison
- 🎯 Mobile user behavior patterns
- 📊 Mobile-specific error tracking
- 🚀 Mobile Core Web Vitals monitoring
📊 Data Export & Integration
Get your data where you need it:
📁 Export Options
CSV Export
Download raw data for analysis in spreadsheets or other tools.
API Access
Programmatic access to your analytics data via REST API.
Scheduled Reports
Automated email reports with key metrics and insights.
Webhooks
Real-time data streaming to your applications.
🎯 Getting the Most from Your Dashboard
💡 Best Practices
Regular Monitoring: Check your dashboard weekly to spot trends and issues early.
Daily Tasks:
- ✅ Check overall visitor trends
- 🔍 Monitor error reports
- 📈 Review performance metrics
- 🎯 Track custom events
Weekly Analysis:
- 📊 Compare week-over-week growth
- 🌍 Analyze geographic trends
- 📱 Review device usage patterns
- 🔗 Evaluate traffic sources
Monthly Reviews:
- 📈 Assess monthly growth trends
- 🎯 Review goal achievement
- 📄 Analyze top-performing content
- 🚀 Plan optimization strategies
🆘 Dashboard Troubleshooting
❓ Common Issues
🔗 Related Resources
SDK Reference
Complete SDK configuration and tracking options
Custom Events
Implement custom event tracking for business insights
Performance Tracking
Optimize your website's performance metrics
Privacy Settings
Configure privacy and GDPR compliance options
Need Help? Join our Discord community or contact support for dashboard assistance.