In addition to using our Analytics dashboard to analyse video performance, it’s possible to connect a playout to your Google Analytics account. Follow the instructions below to log the most important video ‘events’ to Google Analytics.
1.0 | Connect to Google Analytics
To connect a Google Analytics account to a Playout:
- Select a Playout;
- Navigate to the Miscellaneous tab and scroll down to Developer Options
- Enable Google Analytics logging by supplying an ID for Google Analytics logging (format: ‘UA-xxxxxxxx-x’ ).
The logged events can be found in Google Analytics in two locations:
- Realtime > Events
- Behaviour > Events:
2.0 | Event Logging
For each event the following details are logged in Google Analytics:
2.1 | Event Categories
- Video
- Audio
2.2 | Event Actions
- Init (player load)
- Session_Start
- Session_Init
- Project_Start
- Play
- Finish
- Replay
- Progress_[percentage]
2.3 | Event Labels
- mediaclip id + ” – ” + mediaclip title (for media clips)
- project id + ” – ” + project title (for interactive projects)
2.4 | Custom Dimensions
For each event five custom dimensions are logged:
- “dimension1”:<clip_id>,
- “dimension2”:<clip_title>,
- “dimension3”:<clip_length_ms>,
- “dimension4”:<clip_sourcetype>,
- “dimension5”:<clip_createddate>
3.0 | Quartile Progress Logging
By default our player logs viewer progress for each 10 percent.
Example:
A viewer watches a 1 minute video and closes the browser video at the 0:45 second mark. The player logs a progress event at 10%, 20%, 30%, 40%, 50%, 60% and 70%.
It’s also possible to enable quartile progress logging in which case the player logs viewer progress for each 25%.
Example:
A viewer watches a 1 minute video and closes the browser video at the 0:45 second mark. The player logs a progress event at 25%, 50% and 75%.
Quartile progress logging requires a slightly different way of embedding content. When embedding a media clip, project or playlist, add the following query string to the ‘src’ attribute:
?logProgressAsQuartiles=true
Consider the following embed code example:
<script type="text/javascript" src="https://yourcompanyname.bbvms.com/p/default/c/1234567.js" async="true"></script>
By adding ‘?logProgressAsQuartiles=true’ to the ‘src’ attribute, progress events are logged for every 25%:
<script type="text/javascript" src="https://yourcompanyname.bbvms.com/p/default/c/1234567.js?logProgressAsQuartiles=true" async="true"></script>
The example above uses a media clip embed code, but the same applies to embedding a playlist or project.