Application collectors
IVS Media Player
v2.17.0 • For the Javascript Collector
The IVS 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 IVS Player plugin into your web application with the following snippet: Insert this JS line into your HTML Replace the CONFIG_ID value with collector configuration ID. This inserts Datazoom's data collection SDK into the page. To activate data collection for an IVS 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, invoke the We have made it convenient to manage your IVS Collector integration by providing NPM (Node Package Manager) support. Please see installation details here. IVS Player SDK Manual: https://ivideosmart.zendesk.com/hc/en-us/articles/360041163474-User-Manual-for-iVideoSmart-IVS-Player-SDK-for-HTML5 Plugin Integration
1<script src='https://platform.datazoom.io/beacon/v1/config?configuration_id=CONFIG_ID'></script>Activate Data Collection for an IVS Player
1datazoom_context = datazoom.createContext(player);1<html>23<head>4 <script src="https://player.ivideosmart.com/ivsplayer/v4/dist/js/loader.js"></script>5 <script src='https://platform.datazoom.io/beacon/v1/config?configuration_id=CONFIG_ID'></script>6</head>78<body>9 <div id="ivsplayer01-container">10 <ivs-player 11 id="ivsplayer01" 12 data-ivs-key="<customer api key>" 13 data-ivs-spid="<service provider id>" 14 data-ivs-vid="<video id>">15 </ivs-player>16 </div>17 <script>18 var ivs_player;19 var datazoom_context;20 document.addEventListener('ivs.player.rendered', function (event) {21 ivs_player = event.detail.instance;22 datazoom_context = datazoom.createContext(ivs_player);23 });24 </script>25</body>2627</html>Stop Data Collection
destroy() method of the Datazoom context object as in the following example:1if (datazoom_context) {2 datazoom_context.destroy();3 datazoom_context = null;4}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 IVS 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
Player
User
Fluxdata
Metrics measuring changing parameters over time
-
Bandwidth
-
Buffer Duration (Content Session)
-
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 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 Recency (Content Session)
-
Playback Duration (Content Session)
-
Player State
-
Player Viewable
-
Player Viewable Percent
-
Playhead Position
-
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)