As the streaming media industry becomes more mature, video analytics have become a key element to building an online video solution. To provide advanced video analytics with our player we support out-of-the-box integration with Bitmovin Analytics. Our integration has been tested for Bitmovin Analytics v2 (Analytics Web Collector 2). The following features are supported:
setSrc
API method)bitmovinAnalyticsConfig: Object
Pass Bitmovin
Analytics config metadata
to the player to enable Bitmovin Analytics support. A key
property for the
bitmovinAnalyticsConfig
object is required for Bitmovin Analytics support to be enabled
in our player. See below for a complete example. The videoId
, title
and
cdnProvider
properties are also recommended. Default: {}
.
<!-- Include Bitmovin Analytics v2 library --> <script src="https://cdn.bitmovin.com/analytics/web/2/bitmovinanalytics.min.js"></script> <!-- Include Radiant Media Player library --> <script src="https://cdn.radiantmediatechs.com/rmp/9.15.19/js/rmp.min.js"></script> <div id="rmp"></div> <script> const src = { hls: 'https://your-hls-url.m3u8' }; // Define Bitmovin Analytics settings const analyticsConfig = { key: 'your-bitmovin-key', videoId: 'your-video-id', debug: false, title: 'your-video-title' }; const settings = { licenseKey: 'your-radiant-media-player-key', src: src, width: 640, height: 360, contentMetadata: { poster: [ 'https://your-poster-url.jpg' ] }, // Pass Bitmovin Analytics settings bitmovinAnalyticsConfig: analyticsConfig }; const rmp = new RadiantMP('rmp'); rmp.init(settings); </script>
<!-- Include Bitmovin Analytics v2 library --> <script src="https://cdn.bitmovin.com/analytics/web/2/bitmovinanalytics.min.js"></script> <!-- Include Radiant Media Player library --> <script src="https://cdn.radiantmediatechs.com/rmp/9.15.19/js/rmp.min.js"></script> <div id="rmp"></div> <script> const src = { dash: 'https://your-hls-url.mpd' }; // Define Bitmovin Analytics settings const analyticsConfig = { key: 'your-bitmovin-key', videoId: 'your-video-id', debug: false, title: 'your-video-title' }; const settings = { licenseKey: 'your-radiant-media-player-key', src: src, width: 640, height: 360, contentMetadata: { poster: [ 'https://your-poster-url.jpg' ] }, // Pass Bitmovin Analytics settings bitmovinAnalyticsConfig: analyticsConfig }; const rmp = new RadiantMP('rmp'); rmp.init(settings); </script>
For playlist and related the player will automatically source change data to
Bitmovin Analytics based on each playlist item title and id (if no id is provided one will be generated by the
player). Therefore for
playlist and related you only need pass a key
property to the
bitmovinAnalyticsConfig
setting.
For custom
integration using the setSrc
API
here is an example of
source change handling. Note the use of the getBitmovinAnalytics
and
setBitmovinAnalytics
API methods.
const src = { hls: 'https://your-hls-url.m3u8' }; const analyticsConfig = { key: 'your-bitmovin-key', videoId: 'your-video-id', title: 'your-video-title' }; const settings = { licenseKey: 'your-radiant-media-player-key', src: src, width: 640, height: 360, autoplay: true, // Pass Bitmovin Analytics settings bitmovinAnalyticsConfig: analyticsConfig }; const rmp = new RadiantMP('rmp'); // Example for changing source with a delay setTimeout(() => { rmp.setSrc({ hls: 'https://your-new-hls-url.m3u8' }); }, 10000); const container = document.getElementById('rmp'); rmp.on('srcchanging', () => { // Example for checking the current bitmovinAnalyticsConfig setting let analytics = rmp.getBitmovinAnalytics(); console.log(analytics); // Set new bitmovinAnalyticsConfig just before the source change moves forward - e.g. srcchanging API event rmp.setBitmovinAnalytics({ key: 'your-bitmovin-key', // Note you need to pass your Bitmovin key each time you call setBitmovinAnalytics API method videoId: 'your-new-video-id', title: 'your-new-video-title' }); // If needs be we can check the new bitmovinAnalyticsConfig object analytics = rmp.getBitmovinAnalytics(); console.log(analytics); }); rmp.init(settings);
©2015-2024 Radiant Media Player. All Rights Reserved.