DocsPricingCompareChangelogGitHub1,174
Start free

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

Time range selection

Choose from predefined time periods:

  • Today and Yesterday: real-time insights
  • Last 7 days and Last 14 days: weekly trends
  • Last 30 days, This month, and Last month: 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: Your selected period is automatically compared 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

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 and 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 is derived from the visitor's IP address at ingestion and stored at city level. The IP address itself is not stored, and 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. Pageviews and sessions are tracked automatically; there is no separate SDK option to enable them. See SDK configuration for the optional controls.

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

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
json
{
  "event": "purchase_completed",
  "properties": {
    "product_id": "prod_123",
    "revenue": 29.99,
    "currency": "USD",
    "category": "software"
  }
}
Engagement events
json
{
  "event": "feature_used",
  "properties": {
    "feature": "export_data",
    "plan": "pro",
    "usage_count": 5
  }
}

Advanced filtering and segmentation

Slice and dice your data for specific insights:

Available filters

  • Date range selection: Custom time periods
  • 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

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 trackWebVitals={true} in your SDK configuration. This allows the SDK to collect Core Web Vitals from the visitor'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.

INP (Interaction to Next Paint)

Good: ≤ 200 milliseconds Measures responsiveness across user interactions during the page visit.

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 INP (responsiveness):

  • 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 and debugging

Monitor and resolve issues affecting your users:

Enabling error data collection

Error tracking requires the Hobby plan or higher. 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:

  • Unhandled JavaScript errors: Runtime exceptions with stack, page, and session context
  • Unhandled promise rejections: Async failures with the same context

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

  1. Identify: Spot errors in the dashboard
  2. Analyze: Review stack traces and context
  3. Prioritize: Focus on high-frequency errors
  4. Fix: Implement solutions
  5. Verify: Monitor error reduction

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 and integration

Get your data where you need it:

Export options

Data export

Download your data as JSON or CSV via Website Settings > Data Export.

API access

Programmatic access to your analytics data via REST API.

Investigations in Slack

Send actionable investigations to the Slack channels configured for your organization after each daily or weekly run. Replies are included clarifications using the same investigation's saved evidence. Start a new question or fresh analysis explicitly in the dashboard.

Uptime monitor alerts can be delivered to a webhook destination, but there is no outbound webhook streaming for analytics data.

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

Related

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 and privacy settings

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

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

How is this guide?

Edit on GitHub