[Feature]: Media Intelligence & Analytics Engine for WSD (Deep Item, User, and Playback Insights) - QB v4 #27
Description
💡 Feature Description
Introduce a Media Intelligence & Analytics Engine within What's Streaming Dashboard (WSD).
This feature provides deep, item-level analytics and historical intelligence for all media content across supported servers. The system will track how media is consumed, who watched it, when it was watched, and how playback occurred — creating a complete operational and engagement view of the media library.
This feature is inspired by existing media analytics tools, but expands significantly by integrating WSD’s broader ecosystem including Geo insights, notifications, multi‑server awareness, and admin diagnostics.
📈 Motivation and Context
Administrators currently lack a centralized way to understand:
- Which media is actually being watched
- Who is watching specific content
- When engagement occurs
- How playback performance behaves over time
- Which content causes performance or transcoding issues
A dedicated analytics engine enables smarter library management, better troubleshooting, and improved user experience decisions.
🛠️ Suggested Implementation (if known)
📀 Media Item Intelligence
Each media item should expose:
- Total play count
- Unique viewers
- First played date
- Last played date
- Total watch time (hours/minutes)
- Average watch duration
- Completion percentage
- Most recent viewer
- Rewatch frequency
👥 Viewer Analytics
Per media item:
- List of users who watched
- Watch counts per user
- Completion vs abandonment tracking
- Resume behavior statistics
- Viewing timeline history
⏱️ Playback & Performance Metrics
- Playback method distribution:
- Direct Play
- Direct Stream
- Transcode
- Resolution history (4K / 1080p / etc.)
- Average bitrate consumed
- Device types used
- Remote vs Local playback ratio
📱 Device & Network Insights
- Most common playback devices
- Network origin trends
- Bandwidth usage estimates
- Geo distribution of viewers (ties into Geo Playback History)
📊 Library Intelligence
Across libraries:
- Most watched titles
- Least watched titles
- Trending media
- Recently abandoned content
- Watch time by genre
- Watch time by library
- Peak viewing periods
🧠 Advanced Analytics (WSD Enhancements)
- Media Health Score based on:
- Completion rate
- Transcode frequency
- Playback stability
- Rewatch engagement
- Content lifecycle tracking:
- Added → First Watch → Peak Popularity → Decline
- Behavioral insights:
- Viewing pattern correlations
- Genre engagement trends
🧱 Data Model Concept
WSD maintains a local analytics datastore:
playback_events
---------------
user_id
media_id
server_id
timestamp_start
timestamp_stop
device
play_method
bitrate
ip_address
Analytics views are generated from aggregated playback events rather than repeated API polling.
🖼️ Visuals or References (optional)
Example Media Intelligence View:
Title: Dune Part Two
Total Plays: 48
Unique Users: 17
Total Watch Time: 126h
Top Devices: Shield TV, Web, iOS
Playback: 62% Direct Play | 38% Transcode
Last Watched: Yesterday by UserX
🔗 Related Issues or Discussions
- Watch Statistics Module
- Geo Playback History
- Multi‑Server Dashboard Support
- Signal Notification Integration
🧩 Additional Notes
- Designed to scale across multiple servers.
- Should support export (CSV/JSON) for reporting.
- Admin‑only visibility recommended for sensitive analytics.
- Future integrations may allow automated recommendations or alerts based on engagement trends.