Docs
Viewer Statistics

Viewer Statistics

Real-time analytics and insights for your synchronized display

PulseMesh provides comprehensive analytics to help you understand your audience, optimize your display, and track performance over time. The enhanced analytics dashboard offers real-time monitoring, historical data, and actionable insights.

Dashboard Overview

The analytics dashboard provides a complete view of your display's performance:

Real-Time Metrics

Monitor your display as it happens:

  • Current Viewers - Live count of connected users
  • Session Duration - Average time viewers stay connected
  • Connection Rate - Successful connections per minute
  • Geographic Distribution - Map view of viewer locations
  • Device Types - Mobile app vs web player breakdown

Today's Summary

Quick snapshot of current day performance:

  • Total unique viewers
  • Total sessions started
  • Peak concurrent viewers
  • Average session length
  • Connection success rate

Historical Analytics

Track performance over time with interactive charts:

  • Daily, weekly, and monthly views
  • Year-over-year comparisons
  • Seasonal trends
  • Peak time analysis
  • Growth tracking

Key Metrics Explained

Sessions

A session represents one viewer connection to your display:

  • Total Sessions - All connections including repeat viewers
  • Unique Viewers - Individual devices (deduplicated)
  • Repeat Visitors - Viewers who return multiple times
  • Session Duration - Time from connect to disconnect
  • Completion Rate - Percentage who stay for full show

Concurrent Viewers

Understanding simultaneous connections:

  • Current Concurrent - Real-time connected count
  • Peak Concurrent - Highest simultaneous viewers
  • Average Concurrent - Typical viewer load
  • Capacity Utilization - Percentage of plan limit used
  • Queue Time - Wait time when at capacity

Geographic Analytics

See where your viewers come from:

  • Heat Map - Visual density of viewer locations
  • Distance Distribution - How far viewers travel
  • Top Locations - Most common viewer origins
  • Coverage Efficiency - Geo-radius utilization
  • Out-of-Area Attempts - Failed connections outside radius

Device & Platform

Understand how viewers connect:

  • Mobile App - iOS and Android app usage
  • Web Player - Browser-based connections
  • Operating Systems - iOS vs Android vs Desktop
  • App Versions - Distribution of app versions
  • Connection Methods - QR code vs display code vs search

Analytics Views

Real-Time View

Perfect for monitoring during shows:

  • Live viewer count with sparkline
  • Connection feed showing joins/leaves
  • Current song and sync status
  • Alert for approaching limits
  • 5-minute rolling averages

Daily View

Detailed breakdown of single day:

  • Hourly chart of viewers
  • Peak times highlighted
  • Song play statistics
  • Connection success/failure ratio
  • Weather correlation (if available)

Weekly View

Pattern recognition and planning:

  • Day-by-day comparison
  • Best performing days
  • Weekly trends
  • Average by day of week
  • Week-over-week growth

Monthly View

Long-term performance tracking:

  • Monthly totals and averages
  • Seasonal patterns
  • Year-over-year comparison
  • Milestone tracking
  • Forecasting data

Custom Date Range

Analyze specific periods:

  • Select any date range
  • Compare multiple periods
  • Export custom reports
  • Event-specific analysis
  • Holiday season tracking

Advanced Analytics Features

Viewer Journey

Track the complete viewer experience:

  1. Discovery - How viewers found your display
  2. Connection - Time to successful sync
  3. Engagement - Songs played and duration
  4. Return Rate - Likelihood to visit again
  5. Referrals - Viewers who share your display

Song Analytics

See which songs resonate:

  • Play count per song
  • Average listen duration
  • Skip rate by song
  • Most popular sequences
  • Time-of-day preferences

Performance Metrics

Technical health indicators:

  • Connection success rate
  • Average sync delay
  • Network latency
  • Error rates
  • API response times

Demographic Insights

Understand your audience (anonymized):

  • General geographic distribution
  • Device preferences
  • Peak visit times
  • Session patterns
  • Return visitor behavior

Export and Reporting

Data Export Options

Download your analytics data:

  • CSV Format - For spreadsheet analysis
  • JSON Format - For programmatic use
  • PDF Reports - For presentation
  • PNG Charts - For documentation

Automated Reports

Schedule regular reports:

  • Daily summary emails
  • Weekly performance reports
  • Monthly analytics digest
  • Season-end summaries
  • Custom alert thresholds

Report Contents

Standard reports include:

  • Executive summary
  • Key metrics and KPIs
  • Trend analysis
  • Recommendations
  • Comparative data

Using Analytics to Improve

Optimize Show Times

Use data to schedule effectively:

  • Identify peak visitor hours
  • Adjust show frequency
  • Plan special performances
  • Coordinate with traffic patterns

Enhance Viewer Experience

Improve based on behavior:

  • Reduce connection friction
  • Optimize song selection
  • Adjust display radius
  • Improve signage placement

Plan Capacity

Prepare for growth:

  • Monitor limit utilization
  • Predict busy periods
  • Plan subscription upgrades
  • Allocate resources

Marketing Insights

Improve promotion:

  • Understand audience reach
  • Track campaign effectiveness
  • Identify referral sources
  • Measure social sharing

Privacy and Compliance

Data Collection

What we track:

  • Anonymous device identifiers
  • General location (not precise)
  • Connection timestamps
  • Session duration
  • Technical metrics

What We Don't Track

Privacy protection:

  • No personal information
  • No precise location tracking
  • No audio recording
  • No camera access
  • No contact harvesting

Data Retention

  • Real-time data: 24 hours
  • Daily aggregates: 2 years
  • Raw sessions: 90 days
  • Exported data: User controlled

Troubleshooting Analytics

Missing Data

If analytics aren't showing:

  • Verify display is active
  • Check internet connection
  • Allow 5-minute processing delay
  • Ensure browser isn't blocking scripts
  • Clear cache and reload

Incorrect Counts

For discrepancies in numbers:

  • Check timezone settings
  • Verify date range selection
  • Account for processing delays
  • Consider unique vs total metrics
  • Review filter settings

Export Issues

If exports fail:

  • Check file size limits
  • Verify date range is valid
  • Ensure stable connection
  • Try smaller date ranges
  • Use different format

Best Practices

Regular Monitoring

  • Check daily during season
  • Review weekly trends
  • Compare year-over-year
  • Set up alerts
  • Document insights

Data-Driven Decisions

  • Test changes systematically
  • Measure impact
  • A/B test when possible
  • Document what works
  • Share learnings

Goal Setting

  • Set realistic targets
  • Track progress
  • Celebrate milestones
  • Adjust based on data
  • Plan for growth

API Access

For Commercial plan subscribers:

  • Programmatic data access
  • Real-time metrics endpoint
  • Historical data queries
  • Webhook notifications
  • Custom integrations

See API Documentation for details.