Application collectors
Kaltura Media Player
v2.20.0 • For the Javascript Collector
The Kaltura 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
Datazoom provides plugins for data collection through our Beacon Services. Integrate the Kaltura Player 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 Kaltura 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 Kaltura Collector integration by providing NPM (Node Package Manager) support. Please see installation details here. Kaltura Player API Doc: https://developer.kaltura.com/player/web/api-web 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 a Kaltura Player
1datazoom_context = datazoom.createContext(kalturaPlayer);1<!DOCTYPE html>2<html lang="en">34<head>5 <script src="https://cdnapisec.kaltura.com/p/XXXXXX/sp/XXXXXX/embedIframeJs/uiconf_id/XXXXXX/partner_id/XXXXXX"></script>6 7 <!-- THE DATAZOOM BEACON SCRIPT -->8 <script src='https://platform.datazoom.io/beacon/v1/config?configuration_id=CONFIG_ID'></script>9</head>10 11<body>12 13<div class="vid-container">14 <div id="player" style="width : 100% ;height : 400px">15 </div>16</div>17 18<script>19 var kdp;20 kWidget.embed({21 "targetId": "player",22 "wid": "XXXXXX",23 "uiconf_id": XXXXX,24 "flashvars": {},25 "cache_st": XXXXXXXX,26 "entry_id": "XXXXXX"27 });2829 try {30 var kalturaPlayer = KalturaPlayer.setup(config);31 kalturaPlayer.loadMedia({entryId: '0_wifqaipd'});32 datazoom_context = datazoom.createContext(kalturaPlayer);33 } catch (e) {34 console.error(e.message)35 }3637</script>38 39</body>40 41</html>Stop Data Collection
destroy() method of the Datazoom context object as in the following example:1 document.getElementById("destroy").onclick = function() {2 if (kalturaPlayer) {3 kalturaPlayer.destroy();4 kalturaPlayer = null;5 }6 if (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 Kaltura Media Player can be extended with the following ad framework extensions.
Supported Data Points
Events
Discrete occurrences driven by user interactions or system actions
Metadata
Attributes
Video
User
Player
Fluxdata
Metrics measuring changing parameters over time
-
Bandwidth
-
Content Milestone Recency (Content Session)
-
Content Pause Duration (Content Session)
-
Content Playback Duration (Content Session)
-
Content Stall Duration (Content Session)
-
Content Stall Start Recency (Content Session)
-
Heartbeat Recency (Content Session)
-
Pause Duration (Content Session)
-
Player State
-
Playhead Position
-
Rendition Video Bitrate
-
Seek Start Recency (Content Session)
- Stall Start Recency (Content Session)