Google Analytics

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:

1. Realtime > Events
2. 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.