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:

Best for: Last 24-48 hours

Detailed hour-by-hour breakdown
Perfect for monitoring recent changes
Real-time performance tracking

Best for: Weekly/monthly views

Day-by-day analysis
Identify weekly patterns
Track daily performance trends

Best for: Quarterly views

Week-over-week comparisons
Seasonal trend analysis
Long-term pattern recognition

Best for: Yearly views

Month-by-month growth tracking
Annual performance reviews
Strategic planning insights

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

Source: Users typing your URL directly or from bookmarks

Characteristics:

No referrer information
Often returning visitors
High-intent traffic
Brand awareness indicator

Optimization: Focus on brand building and memorable URLs

Sources: Google, Bing, DuckDuckGo, and other search engines

Data Shown:

Search engine names
Organic traffic volume
Search performance trends

Optimization: SEO improvements and content strategy

Sources: Facebook, Twitter, LinkedIn, Instagram, etc.

Insights:

Social platform performance
Content sharing effectiveness
Social engagement tracking

Optimization: Social media strategy and content tailoring

Sources: Other websites linking to you

Benefits:

Referral traffic analysis
Partnership effectiveness
Backlink impact measurement

Optimization: Relationship building and link acquisition

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.

Powering the Map View

The geographic data displayed on maps and in regional breakdowns is typically derived from the user's IP address at the beginning of a session. This functionality is an integral part of session tracking. Ensure trackSessions= {true} (which is enabled by default) in your SDK configuration to collect this data.

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:

Populating This Section

The analytics, breakdowns, and examples shown here are populated by the custom events you actively send from your application using the db.track('your_event_name', {your_properties}) method. The more relevant and well-structured custom events you track, the more insightful this section will become. For detailed guidance on how to implement custom event tracking, please refer to the Tracker Helpers guide.

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
  }
}

Advanced Filtering & Segmentation

Slice and dice your data for specific insights:

Available Filters

Date range selection - Custom time periods
Time of day filtering - Specific hours
Day of week analysis - Weekday vs weekend patterns
Month/quarter comparisons - Seasonal trends

Device type filtering - Mobile, desktop, tablet
Geographic filtering - Country, region, city
Traffic source filtering - Direct, search, social, referral
Visitor type - New vs returning (when available)

Page path filtering - Specific pages or sections
Event filtering - Specific custom events
Property filtering - Event property values
Performance filtering - Fast vs slow pages

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:

Enabling Performance Data

The performance metrics, including Core Web Vitals, are populated when you enable trackPerformance={true} (enabled by default) and trackWebVitals= {true} (disabled by default, but recommended) in your SDK configuration. Enabling these options allows the SDK to collect detailed timing and performance data from the user's browser.

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:

Enabling Error Data Collection

To populate the error tracking sections of the dashboard, ensure you have trackErrors={true} enabled in your SDK configuration. This will automatically capture unhandled JavaScript errors and promise rejections. For more detailed context on specific handled errors, you can manually send error events using db.track('error', {/* custom properties */}) as described in the Tracker Helpers guide.

JavaScript Error Analytics

Comprehensive Error Information:

Error messages - Descriptive error text
Error locations - File, line, and column numbers
Stack traces - Detailed execution path
Error frequency - How often errors occur
Affected users - Number of users experiencing errors

Error Types:

JavaScript errors - Runtime exceptions
Network errors - Failed API calls
Browser compatibility - Feature support issues
Resource errors - Missing images, stylesheets

Resolution Features:

Error grouping - Similar errors grouped together
Error trends - Error frequency over time
Error by location - Geographic error distribution
Error by device - Device-specific error patterns

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

Possible Causes:

SDK not properly installed
Tracking disabled in development
Domain not verified
Ad blockers preventing data collection

Solutions:

Verify SDK installation
Check browser network tab for requests
Ensure domain verification is complete
Test with ad blockers disabled

Expected Behavior:

Data typically updates within 1-2 minutes
Some metrics may take up to 5 minutes
Refresh the page to see latest data

If data is still delayed:

Check your internet connection
Verify dashboard status page
Contact support if issues persist

Feature Availability:

Some features require specific tracking to be enabled
Custom events need manual implementation
Performance metrics require opt-in tracking

Enable Missing Features:

Review your SDK configuration
Enable additional tracking options
Implement custom event tracking

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

Security & Privacy Settings

Configure access control, allowed origins, IP restrictions, etc.

Need Help? Join our Discord community or contact support for dashboard assistance.