Application collectors
Brightcove Media Player
v2.22.0 • For the Javascript Collector
The Brightcove Media Player Extension is a configuration option for the Javascript Collector by Datazoom that makes the following additional data points automatically collectable in real time.
Integration Instructions
These instructions are specific to the In-Page embed code method outlined here: https://player.support.brightcove.com/publish/choosing-correct-embed-code.html
Datazoom provides plugins for data collection through our Beacon Services. Integrate the Brightcove plugin into your web application with the following snippet: Insert this JS line into your HTML Replace the This inserts Datazoom's data collection SDK into the page. To activate data collection for a Brightcove player instance, create a Datazoom context which references the player instance with the following snippet: For example: If the data collection must be stopped for any reason, for example after the destruction of the corresponding player instance, invoke the We have made it convenient to manage your Brightcove Collector integration by providing NPM (Node Package Manager) support. Please see installation details here. Brightcove Player API Doc : https://player.support.brightcove.com/brightcove-player/current-release/index.html Brightcove In-Page embed Doc: https://player.support.brightcove.com/publish/choosing-correct-embed-code.html Plugin Integration
1<script src='https://platform.datazoom.io/beacon/v1/config?configuration_id=CONFIG_ID'></script>CONFIG_ID value with the collector configuration ID.Activate Data Collection for Brightcove
1datazoom_context = datazoom.createContext(brightcove_player);1<!doctype html>2<html>34<head>5 <meta charset="UTF-8">6 <!-- THE DATAZOOM BEACON SCRIPT -->7 <script src='https://platform.datazoom.io/beacon/v1/config?configuration_id=CONFIG_ID'></script>8 <style>9 /* Make player fill outer div */10 .video-js {11 height: 100%;12 width: 100%;13 }1415 /* Build outer div size of player */16 .outer {17 width: 610px;18 height: 344px;19 border: 1px solid blue;20 position: relative;21 }22 </style>23</head>2425<body>2627 <div id="playerContainer" class="outer">28 <video-js id="myPlayerID" data-video-id="6116779877001" data-account="1507807800001" data-player="rf1BTdKk6M"29 data-embed="default" data-application-id class="video-js" controls playsinline></video-js>30 </div>31 32 <!-- THE BRIGHTCOVE CDN -->33 <script src="https://players.brightcove.net/1507807800001/rf1BTdKk6M_default/index.min.js"></script>3435 <script type="text/javascript">36 // Create a MediaPlayer and initialize it.37 var brightcove_player = videojs.getPlayer('myPlayerID');38 39 // Activates data collection40 var datazoom_context = datazoom.createContext(brightcove_player);41 </script>4243</body>4445</html>Stop Data Collection
destroy() method of the Datazoom context object as in the following example:1if (brightcove_player) {2 brightcove_player.dispose();3 brightcove_player = null;4}56if (datazoom_context) {7 datazoom_context.destroy();8 datazoom_context = null;9}NPM (Node Package Manager)
References:
Ad Frameworks Extensions
If your Javascript application has a media player with an ad framework, Datazoom’s Javascript Collector with a Brightcove Media Player can be extended with the following ad framework extensions.
Supported Data Points
Events
Discrete occurrences driven by user interactions or system actions
-
Audio Track Changed
-
Buffer End
-
Buffer Start
-
Cast End
-
Cast Start
-
Cast Transfer
-
Error
-
Exit Fullscreen
-
Fullscreen
-
Heartbeat
-
Media Loaded
-
Media Request
-
Milestone
-
Mute
-
Pause
-
Playback Complete
-
Playback Start
-
Player Ready
-
Playing
-
Qualified View
-
Rendition Change
-
Resize
-
Resume
-
Seek End
-
Seek Start
-
Stall End
-
Stall Start
-
Stop
-
Subtitle Change
-
Unmute
- Volume Change
Metadata
Player
Attributes
User
Fluxdata
Metrics measuring changing parameters over time
-
Audio Track
-
Bandwidth
-
Buffer Duration (Content Session)
-
Buffer Length
-
Buffer Start Recency (Content Session)
-
Content Buffer Duration (Content Session)
-
Content Buffer Start Recency (Content Session)
-
Content Error Count (App Session)
-
Content Media Request Count (App Session)
-
Content Media Request Recency (Content Session)
-
Content Milestone Recency (Content Session)
-
Content Pause Duration (Content Session)
-
Content Playback Duration (Content Session)
-
Content Playback Start Count (App Session)
-
Content Playback Start Recency (Content Session)
-
Content Session Start Timestamp
-
Content Stall Count (Content Session)
-
Content Stall Duration (Content Session)
-
Content Stall Start Recency (Content Session)
-
Error Count (App Session)
-
Heartbeat Recency (Content Session)
-
Pause Duration (Content Session)
-
Pause Recency (Content Session)
-
Playback Duration (Content Session)
-
Playback Rate
-
Player State
-
Player Viewable
-
Player Viewable Percent
-
Playhead Position
-
Playhead Position - Program Date Time
-
Promo Playback Duration (Content Session)
-
Rendition Change Recency (Content Session)
-
Rendition Height
-
Rendition Name
-
Rendition Video Bitrate
-
Rendition Width
-
Seek Start Recency (Content Session)
-
Stall Count (Content Session)
-
Stall Duration (Content Session)
-
Stall Start Recency (Content Session)
-
Subtitle Track
- Volume