In addition to using our Analytics dashboard, connect a playouts to your Piwik Pro account to fully integrate your video analytics with your overall web traffic analyses.
1.0 | Connect to Piwik Pro
To connect a Piwik Pro account to a Playout:
- Select a Playout;
- Navigate to the Miscellaneous tab and scroll down to Developer Options
. - Enable Piwik Pro logging by supplying both an Piwik Pro account address (Piwik (base) URL) as well a Piwik site ID.
.
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=Init
2.3 | Event Name
Piwik Pro query parameter: e_n (string)
- For mediaclips: clip id – clip title
Example (decoded): e_n: 5828638 – Workshop (Bilingual)
Example (encoded): e_n=5828638%20-%20Workshop%20(Bilingual) - For interactive projects: project id – project title
Example (decoded): e_n: 5518110 – Interactieve video demo – experience interactive video
Example (encoded): e_n=5518110%20-%20Interactieve%20video%20demo%20-%20experience%20interactive%20video
2.4 | Content Interactions
Piwik Pro query parameter: c_i (string)
- Resume: c_i=Init
- 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 paramter: 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
2.5 | Custom Variables
Piwik Pro query parameter: cvar (string) <JSON>
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"] }