Matomo Analytics

In addition to using our Analytics dashboard, connect your playouts to your Matomo account (formerly known as Piwik) to fully integrate your video analytics with your overall web traffic analysis.

1.0 | Connect to Matomo

To connect a Matomo account to a playout:

• Click to expand Media library in the left menu panel.
• Click Playouts.
• Select a playout.
• Navigate to the Miscellaneous tab and scroll down to Developer Options.

• Enable Matomo logging by supplying both a Matomo Tracking HTTP API endpoint (Matomo (base) URL) and a Matomo site ID.

2.0 | Event Logging

The following events and content interactions are logged in Matomo using query parameters as documented by Matomo (learn more):

2.1 | Event Categories

Matomo query parameter: e_c (string)

• Video: e_c = Video
• Audio: e_c = Audio

2.2 | Event Actions

Matomo query parameter: e_a (string)

• Init (player load): e_a = Init
• Play: e_a = Play
• Finish: e_a = Finish

2.3 | Event Name

Matomo query parameter: e_n (string)

The event name is formatted as: clip id – clip title

• Example (decoded): e_n: 5828638 – Workshop (Bilingual)
• Example (encoded): e_n = 5828638%20-%20Workshop%20(Bilingual)

2.4 | Content Interactions

A content impression is tracked alongside the Play event. Content interactions are tracked for the following:

Matomo query parameter: c_i (string)

• Resume: c_i = Resume
• Seek: c_i = Seek
• Pause: c_i = Pause

Content interactions are accompanied by:

• Content name
  Matomo query parameter: c_n (string)
  • Example (decoded): c_n: Blue Billywig Player
  • Example (encoded): c_n = Blue%20Billywig%20Player
• Content piece
  Matomo query parameter: c_p (string)
  • Example (decoded): c_p: https://yourcompanyname.bbvms.com/json/mediaclip/1234567
  • Example (encoded): c_p = https%3A%2F%2Fyourcompanyname.bbvms.com%2Fjson%2Fmediaclip%2F1234567
• Content target
  Matomo query parameter: c_t (string) — the deep link URL of the media clip.

2.5 | Custom Variables

Matomo query parameter: cvar (string, JSON)

All custom variables are set with page scope. The bb_duration value is in milliseconds.

Example:

cvar: {
  "1": ["bb_id", "1234567"],
  "2": ["bb_title", "Workshop (Bilingual)"],
  "3": ["bb_duration", "33033"],
  "4": ["bb_sourcetype", "on_demand"],
  "5": ["bb_createddate", "2024-03-01T15:52:08Z"]
}