> ## Documentation Index
> Fetch the complete documentation index at: https://docs.musique.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics & Reports

> Monitor user activity, network quality, and system performance with comprehensive analytics

## Overview

Musique provides powerful analytics tools to help you understand user engagement, monitor system health, and make data-driven decisions about your audio strategy. Access detailed metrics, interactive visualizations, and exportable reports.

## User Analytics Dashboard

### Active Users Tracking

Monitor real-time and historical user activity across your network.

<CardGroup cols={2}>
  <Card title="Real-Time Status" icon="circle-dot">
    See current online/offline user count at a glance.
  </Card>

  <Card title="Daily Active Users" icon="calendar-day">
    Track DAU (Daily Active Users) over the last 30 days.
  </Card>

  <Card title="Hourly Activity" icon="clock">
    View active users by hour to identify peak usage times.
  </Card>

  <Card title="Activity Trends" icon="chart-line">
    Analyze usage patterns and trends over time.
  </Card>
</CardGroup>

### Usage Metrics

<AccordionGroup>
  <Accordion title="Average Hours Online">
    Track how long users are active:

    * **Per Day** - Daily average hours
    * **Per Week** - Weekly usage patterns
    * **Per Month** - Monthly engagement metrics
    * **Per Quarter** - Quarterly trends
    * **Yesterday's Hours** - Quick view of previous day
  </Accordion>

  <Accordion title="Per-User Tracking">
    Individual user activity metrics:

    * User-specific activity patterns
    * Login frequency and duration
    * Location-based usage
    * Historical user data
  </Accordion>

  <Accordion title="Usage Charts">
    Visual representation of usage patterns:

    * Interactive bar charts
    * Time-series graphs
    * Comparison views
    * Period-over-period analysis
  </Accordion>
</AccordionGroup>

## Inactive Users

Identify users who need attention or re-engagement.

### Inactivity Detection

<Steps>
  <Step title="Automatic Detection">
    System automatically identifies users inactive for 3+ days.
  </Step>

  <Step title="User List">
    View complete list of all inactive users with details.
  </Step>

  <Step title="Inactivity Duration">
    See exactly how long each user has been inactive.
  </Step>

  <Step title="Take Action">
    Use this data for re-engagement campaigns or support outreach.
  </Step>
</Steps>

<Warning>
  Regular monitoring of inactive users can help identify technical issues or training needs.
</Warning>

## Network Quality Overview

Monitor connection quality across your network to ensure optimal performance.

### Quality Distribution

Users are automatically grouped by connection quality:

* **Great** - Excellent connection (fast download, low ping)
* **Moderate** - Acceptable connection with minor issues
* **Poor** - Connection issues requiring attention
* **Unknown** - No recent test data available

### Quality Metrics

<CardGroup cols={2}>
  <Card title="7-Day Average" icon="calendar-week">
    Average network quality over the last week for trend analysis.
  </Card>

  <Card title="Download Speed" icon="download">
    Measure internet download speeds in Mbps across locations.
  </Card>

  <Card title="Ping/Latency" icon="signal">
    Track round-trip time for identifying connection delays.
  </Card>

  <Card title="Geographic Insights" icon="map">
    Network quality breakdown by location or region.
  </Card>
</CardGroup>

## Interactive Analytics

### Interactive Charts

Explore your data with dynamic, interactive visualizations:

**Chart Types:**

* **Bar Charts** - Compare metrics across categories
* **Pie Charts** - See proportional distributions
* **Line Charts** - Track trends over time
* **Area Charts** - Visualize cumulative data

**Interactive Features:**

* Hover for detailed information
* Click to drill down into data
* Zoom and pan for detailed view
* Dynamic filtering and sorting

### Network Map

<Tip>
  Use the geographic map to quickly identify regions with connectivity issues.
</Tip>

**Map Features:**

* Interactive location markers
* Color-coded quality indicators
* Click-through for detailed information
* Zoom and pan controls
* Real-time status updates

## Custom Date Ranges

Analyze data for any time period with flexible date selection.

<AccordionGroup>
  <Accordion title="Preset Ranges">
    Quick access to common periods:

    * Last 7 days
    * Last 30 days
    * Last 90 days
    * Last 12 months
    * Year to date
  </Accordion>

  <Accordion title="Custom Selection">
    * Choose any start and end date
    * User-friendly date picker
    * Calendar interface
    * Validation for valid date ranges
  </Accordion>

  <Accordion title="Comparison Periods">
    * Compare different time periods
    * Period-over-period analysis
    * Year-over-year comparisons
    * Week-over-week tracking
  </Accordion>
</AccordionGroup>

## Data Export

Export analytics data for further analysis or reporting.

### Export Formats

<CardGroup cols={2}>
  <Card title="Excel (XLSX)" icon="file-excel">
    Download data in Excel format for spreadsheet analysis and pivot tables.
  </Card>

  <Card title="CSV" icon="file-csv">
    Export as CSV for compatibility with other analytics tools.
  </Card>
</CardGroup>

### Export Options

* **Filtered Exports** - Export only selected data
* **Date Range Exports** - Export data for specific periods
* **User Lists** - Export user data with various filtering options
* **Scheduled Reports** - Automated report generation (where available)

## Additional Reports

### Ads Performance

Track advertisement playback and effectiveness:

* **Ad Tracking** - Monitor when and where ads played
* **Performance Metrics** - Measure ad effectiveness
* **Execution Logs** - Detailed playback records
* **Success Rates** - Monitor delivery success across locations

### Health Status

Monitor overall system performance:

* **System Health** - Track system availability and performance
* **Status Indicators** - Visual health displays
* **Uptime Tracking** - Monitor system reliability
* **Error Monitoring** - Identify and track system errors

### Music Library Analytics

Understand music usage patterns:

* **Library Insights** - Usage patterns and trends
* **Popular Tracks** - Most-played songs
* **Library Growth** - Track expansion over time
* **Genre Distribution** - Music category breakdown

## User Types & Reporting

Different reports available based on user type:

<Tabs>
  <Tab title="Franchised">
    * Consolidated network reporting
    * Multi-location analytics
    * Franchise-wide metrics
    * Comparative analysis
  </Tab>

  <Tab title="Non-Franchised">
    * Location-specific reporting
    * Individual site metrics
    * Focused analytics
    * Single-location insights
  </Tab>
</Tabs>

## Best Practices

<CardGroup cols={2}>
  <Card title="Regular Monitoring" icon="eye">
    Check analytics regularly to identify trends and issues early.
  </Card>

  <Card title="Set Benchmarks" icon="bullseye">
    Establish baseline metrics to measure improvement over time.
  </Card>

  <Card title="Act on Insights" icon="bolt">
    Use data to drive decisions about scheduling, content, and support.
  </Card>

  <Card title="Export for Records" icon="floppy-disk">
    Regularly export data for record-keeping and compliance.
  </Card>
</CardGroup>

## Understanding Metrics

<Note>
  Associated users impact the Indicators Panel data. Users linked through association settings will have their metrics consolidated.
</Note>

### Key Performance Indicators

* **DAU (Daily Active Users)** - Unique users active each day
* **Average Session Duration** - How long users stay connected
* **Network Quality Score** - Combined metric of speed and latency
* **Inactive User Rate** - Percentage of users not recently active
* **System Uptime** - Percentage of time system is operational

## Next Steps

<CardGroup cols={2}>
  <Card title="Network Quality" icon="wifi">
    Test your network speed to understand your connection quality metrics.
  </Card>

  <Card title="Schedule Optimization" icon="calendar-check" href="/learn/scheduling">
    Use analytics insights to optimize your scheduling strategy.
  </Card>
</CardGroup>