In addition to using our Analytics dashboard, connect a playout to your Piwik Pro account to fully integrate your video analytics with your overall web traffic analysis.
Filling the Piwik Pro options automatically disables the Matomo integration options and vice versa.
1.0 | Connect to Piwik Pro
To connect a Piwik Pro 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.
The Piwik Pro settings may not be available by default. Please contact your account manager or support@bluebillywig.com to access these settings.
- Enable Piwik Pro logging by supplying both a Piwik Pro account address (Piwik (base) URL) and a Piwik site ID.
To ensure a proper integration, make sure your Piwik Pro account address does not contain a “/” character at the end of the URL. For example: use “https://bluebillywig.piwik.pro” instead of “https://bluebillywig.piwik.pro/”.
2.0 | Event Logging
The following events and content interactions are logged in Piwik Pro using query parameters as documented by Piwik Pro (learn more):
2.1 | Event Categories
Piwik Pro query parameter: e_c (string)
- Video: e_c = Video
- Audio: e_c = Audio
2.2 | Event Actions
Piwik Pro query parameter: e_a (string)
- Init (player load): e_a = Init
- Play: e_a = Play
- Finish: e_a = Finish
2.3 | Event Name
Piwik Pro 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:
Piwik Pro query parameter: c_i (string)
- Resume: c_i = Resume
- Seek: c_i = Seek
- Pause: c_i = Pause
Content interactions are accompanied by:
- Content name
Piwik Pro query parameter: c_n (string)- Example (decoded): c_n: Blue Billywig Player
- Example (encoded): c_n = Blue%20Billywig%20Player
- Content piece
Piwik Pro 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
Piwik Pro query parameter: c_t (string) — the deep link URL of the media clip.
2.5 | Custom Variables
Piwik Pro 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"]
}