Skip to content

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.

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.

  • 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.
  1. Go to MediaShield > Heatmaps.
  2. Under Playback Engagement, choose a video from the list.
  3. 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.”

  • 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.

Retention means how many viewers are still watching as the video goes on. The Playback Engagement chart is that view.

  1. Pick the video and find where the bars first drop sharply.
  2. Note the time on the axis. That is where viewers leave.
  3. Open the video, listen to that minute, and shorten, re-record or split the lesson there.
  4. 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.

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.

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.

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

This is an admin screen. Viewers see nothing.

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.

If the chart stays empty, see Troubleshooting.