Media Analysis (Premium Feature)

Gain powerful insights into how your audience watches your video and listens to your audio content using the Media Analytics feature. This feature adds many new reports and widgets to MVMCloud Analytics to help you understand how your users interact with your media and maximize your output.

It lets you know how often a media was played, how long it was played, whether it was displayed in full screen, how often a video has been paused or resumed, provides real-time information, and more. In many cases, tracking starts automatically when visitors watch videos and listen to audio on your website.

Embedding the Media Analytics JavaScript tracker

If you have already embedded the MVMCloud Analytics JavaScript tracking code on your site, the Media Analytics feature will begin tracking automatically use video and audio. The video player tracking code is added directly to your MVMCloud Analytics JavaScript tracker file.

Crawling HTML5 videos

HTML5 video tracking works automatically. However, you may not be tracking accurate titles for the your video. We recommend setting a data-mvm-title attribute on your <video> elements:

<video data-mvm-title="Audio title">...</video>

Tracking HTML5 audios

HTML5 audio tracking works automatically. However, you may not be tracking accurate titles for the your audio. We recommend setting a data-mvm-title attribute on your <audio> elements:

<audio data-mvm-title="Audio title">...</audio>

Tracking JW Player videos

JW Player tracking works automatically. However, you may not be tracking accurate titles for your video. We recommend specifying a title in your video's setup method:

jwplayer("myDiv").setup({
     "filet": "...",
     "title": "Video title"
});

Tracking Flowplayer videos

Flowplayer tracking works automatically. However, you may not be tracking accurate titles for your video. We recommend specifying a title in your video's flowplayer method:

flowplayer("#player", {
     clip: {
         sources: [
             {type: "video/mp4", src: "https://example.org/actualUrl.mp4"}
         ],
         title: "Video title"
     }
});

If you embed Flowplayer using the video element, read the instructions for setting titles using HTML5 above. You can set a title using the data-mvm-title or title attribute.

Please note that we currently only support HTML5 videos for Flowplayer, flash videos are not supported. If you are using the flash because of HLS streams, consider using the hlsjs plugin so that HTML5 is used instead of flash.

Tracking Vimeo videos

Vimeo video tracking works automatically if the video is embedded as an <iframe> file.

Tracking SoundCloud Audio

SoundCloud audio tracking works automatically if the audio is embedded as an <iframe> file.

YouTube video tracking

The Media Analytics feature uses the YouTube iFrame API. For your YouTube videos to be crawled, you need to enable this YouTube API by adding a URL parameter ?enablejsapi=1 to all source URLs of your videos. For example:

<iframe src="https://www.youtube.com/embed/yA2NUur0770?enablejsapi=1"></iframe>

If the enablejsapi=1 parameter is not specified in your YouTube URLs, the Media Analytics tracker will likely not receive video events from the YouTube player.

Uploading additional YouTube files

The MVMCloud Analytics tracker loads a file https://www.youtube.com/iframe_api to receive events from the YouTube player. This is necessary to track YouTube video usage. If you have already manually uploaded or do not want this file to be uploaded, you can disable YouTube video tracking calling the following JS method:

_paq.push(['MvmMediaAnalytics::removePlayer', 'youtube']);

Note that this file will only be loaded when there is actually a YouTube video on a website page.

My site is also using the YouTube Iframe JS API, is there anything I can do?

If your site uses the same Iframe API as YouTube and makes use of the onYouTubeIframeAPIReady callback, you need to tell the media tracker once the YouTube player API is available by calling the MvmMediaAnalytics::scanForMedia method:

window.onYouTubeIframeAPIReady = function () {
     // [...] your code goes here
     _paq.push(['MvmMediaAnalytics::scanForMedia']);
};

To avoid breaking your site's code, the media tracker will not override the onYouTubeIframeAPIReady method.