videojs-analytics

Google and Piwik Analytics plugin for video.js

Getting Started

Download videojs and videojs-analytics

In your web page:

<video id="video" src="movie.mp4" controls></video>
<script src="video.js"></script>
<script src="dist/videojs.ga.min.js"></script>
<script>
videojs('video', {}, function() {
  this.ga(); // "load the plugin, by defaults tracks everything!!"
});
</script>

Please note that the Google Analytics and/or Piwik script must be loaded before the ga plugin

Options

You can provide options to the plugin either by passing them in the javascript or in the html.

player.ga({
  'eventsToTrack': ['fullscreen', 'resize'],
  'debug': true
});

<video id="video" src="movie.mp4" controls data-setup='{"ga": {"eventsToTrack": ["error"]}}'></video>

The plugin will take in priority options provided in the javascript, followed by the ones provided in html and finally the defaults.

The following options are supported:

####eventCategory

This is the category sent to GA. If you don't know what it is please check GA's doc default: 'Video'

####eventLabel

This is the label sent to GA. If you don't know what it is please check GA's doc default: basename of the video path so if the path is http://s3.amazonaws.com/pouet.mp4 the label would be pouet

####eventsToTrack

The events you want to track. Most of this events are videojs events. Some of them might reflects my needs. I'm open to add some more if you care to provide a good use case or a pull request. default: every events [ 'loaded', 'percentsPlayed', 'start', 'end', 'seek', 'play', 'pause', 'resize', 'volumeChange', 'error', 'fullscreen']

Most of the events are selft explanatory, here's the ones that may need more details:

• percentsPlayed: will send an event every X percents. X being defined by the option percentsPlayedInterval.

####percentsPlayedInterval

This options goes with the percentsPlayed event. Every percentsPlayedInterval percents an event will be sent to GA. default: 10

####debug

If set to false, console logs will be ommited default: false

ga.js, analytics.js and piwik.js

This plugin supports the ga.js and the newer analytics.js Google Analytics libraries. It also supports piwik.js. It autodetects the library you use and if both GoogleAnalytics and Piwik is used by your site, it will log to both systems.

TODO

• track the engine used (html5/flash) along with the source (ogg, mp4, ...)
• track the time to download the video
• refactor source-code, docs and tests to replace references to "GA" with a more general term that makes sense for GoogleAnalytics and for Piwik.