Heatmaps and Device Breakdown
MediaShield overviewFree + ProGet MediaShield →
PRO - requires MediaShield Pro. The basic dashboard, Viewers list and Milestones page are in Free.
The Heatmaps screen shows where viewers watch, rewatch and give up inside one video, and which devices and browsers they use. Use it to find the minute where a lesson loses people.
Why use it
Section titled “Why use it”You see the exact minute where viewers leave or rewatch, so you know which lesson to shorten, re-record or split. It replaces guessing with a picture of real viewing.
Before you start
Section titled “Before you start”- Viewers must be watching in the MediaShield player, with the protection level on Standard or Strict. Basic and None do not record a watch session, so they produce no heatmap data.
- Give the heatmap about an hour. It is built by a background job.
Open the heatmap
Section titled “Open the heatmap”- Go to MediaShield > Heatmaps.
- Under Playback Engagement, choose a video from the list.
- Read the bar chart. Each bar covers 10 seconds of the video.
If a video has no data you see “No playback data for this video yet.”
How to read it
Section titled “How to read it”- Tall bars are parts many viewers spent time in.
- A steep fall is where viewers stop watching. That is the part to shorten or fix.
- A bump after a fall is a section viewers jump back to.
Use it as a retention view
Section titled “Use it as a retention view”Retention means how many viewers are still watching as the video goes on. The Playback Engagement chart is that view.
- Pick the video and find where the bars first drop sharply.
- Note the time on the axis. That is where viewers leave.
- Open the video, listen to that minute, and shorten, re-record or split the lesson there.
- Check the chart again after a week of new viewing. Bars only grow, so compare the shape, not the height.
Things that surprise people:
- It lags. The job that builds the chart runs hourly, so the newest viewing is not in it yet.
- It samples, it does not log every click. The player reports its position about every 30 seconds, so the chart shows time spent, to a 10-second resolution. It is not a record of every seek and pause.
- Bars only grow. Counts add up over the life of the video. An older video naturally has taller bars than a new one.
- Raw events are pruned. The detailed rows behind the chart are deleted after 90 days (a developer can change this). The chart you already built keeps its totals.
Device and browser breakdown
Section titled “Device and browser breakdown”Below the chart, the Device Breakdown table lists device type and browser for the last 30 days. For each row you see the number of sessions, unique users and average completion. Use it to decide whether mobile layouts deserve attention.
The 30-day window is fixed on screen.
Playlist funnel
Section titled “Playlist funnel”Drop-off between the videos of a playlist can be read from the REST API only (/analytics/playlist-funnel/{playlist_id}). There is no screen for it. See REST API.
Other analytics screens
Section titled “Other analytics screens”| Screen | What it answers | Guide |
|---|---|---|
| Realtime | Who is watching right now | Realtime Viewers |
| Alerts | Which accounts look unusual | Suspicious Activity and VPN Detection |
| Export | I need the numbers in a spreadsheet or PDF | Export Data |
| Weekly digest | A summary in my inbox | Weekly Digest Email |
What viewers see
Section titled “What viewers see”This is an admin screen. Viewers see nothing.
Settings and options for this feature
Section titled “Settings and options for this feature”There are no options. Everything here is automatic. The job that builds the chart is ms_heatmap_aggregation (hourly). See Settings, Options and Scheduled Jobs.
Next steps
Section titled “Next steps”- Set up milestone actions for the viewers who finish.
- Export the numbers.
If the chart stays empty, see Troubleshooting.

