Opencast Player - Matomo Tracking Plugin

This plugin allows using Matomo to track usage data. To setup Matomo please follow the instructions on the Matomo website:

The plugin respects the Do-Not-Track settings of a browser. Please consider the legal requirements of your country when you set up Matomo.

This plugin uses a Matomo JavaScript library that is loaded from the remote Matomo server!

Tested Matomo version: 3.0.2+ ; Matomo Analytics Cloud

The configurations for the Matomo player plugin are done for each tenant. The configuration keys are located in etc/ui-config/<organization>/theodul/config.yml.

To activate the plugin set the Matomo server URL:

server: https://matomo.example.com/matomo

Configuration

server:

The Matomo server from which the Piwik JS library will be loaded and where the data will be reported.

site_id: 1

The Matomo site ID has to be numeric value. If not set this will be 1. It is recommended to use different site IDs for each tenant that is configured in Opencast.

heartbeat: 30

The heartbeat setting to track how long a user stayed on the player page. Set to 0 or comment this line to disable the heartbeat.

notification: true

The plugin shows a notification about the tracking to the user. This can be disabled with this option. (Default: true) Before you disable the notification, make sure that you do not violate any local regulations.

track_events: ["play", "pause", "seek", "ended"]

This setting lets you track several player events. Add the events that you want to track to the list. Comment this property to prevent event tracking.

Events that can be tracked:

Tracked Data

Additional to the event data that can be turned on for each event (see above), this Opencast specific data is tracked if tracking is allowed:

Heartbeat data does not show how long a video has been played but how long a viewer remained on the page, while the page was in the foreground.