In addition to using our Analytics dashboard, connect a playout to your Google Analytics 4 account to fully integrate your video analytics with your overall web traffic analyses.
1.0 | Connect to Google Analytics 4
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 4 logging by supplying a Google Tag Id (format: ‘G-xxxxxxxx-x’ ) (read more on finding your Google Tag Id).
The logged events can be found in Google Analytics 4 in two locations:
- Realtime > Events
- Behaviour > Events:
2.0 | Event Logging
For each event the following details are logged in Google Analytics 4:
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.