Kaltura player plugin

Introduction

Bradmax analytics supports plugin for Kaltura player, which collects playback information and sends it to bradmax platform. Reports about video usage from collected data is presented in bradmax client panel (https://bradmax.com/client/panel/).

Integration of bradmax analytics statistics with Kaltura players is quick and easy process. It needs only plugin file and some additional configuration for player. See example below.

Plugin file

Raw JavaScript file: https://bradmax.com/static/bradmax-analytics-for-players/latest/bradmax.analytics.js

Zipped JavaScript file: https://bradmax.com/static/bradmax-analytics-for-players/latest/bradmax.analytics.zip

Example

Initial steps:

  1. Download bradmax.analytics.js plugin file (see above)
  2. Check clientToken in bradmax client panel (https://bradmax.com/client/panel/ > Analytics > Info > clientToken).
  3. Prepare HTML file
  • Create HTML file with content from below example.
  • Set right path to downloaded bradmax.analytics.js plugin file (below path https://example.com/bradmax.analytics.js is used).
  • Replace client token below (“SJnO!AzdDggLdOyAIdBg5DIjjeIOMAFd9gADV”) by your one.
<!DOCTYPE html>
<html>
<head>
    <title>KalturaPlayer / Bradmax analytics / test</title>
    <script src="http://cdnapi.kaltura.com/p/2400541/sp/240054100/embedIframeJs/uiconf_id/42568391/partner_id/2400541"></script>
</head>
<body>
    <div id="kaltura_player_1526304953" style="width: 560px; height: 395px;">
    </div>
    <script>
        kWidget.embed({
            "targetId": "kaltura_player_1526304953",
            "wid": "_2400541",
            "uiconf_id": 42568391,
            "flashvars": {
                "streamerType": "auto",
                "bradmaxAnalytics": {
                    "plugin": true,
                    "iframeHTML5Js": "https://example.com/bradmax.analytics.js",
                    "clientToken": "SJnO!AzdDggLdOyAIdBg5DIjjeIOMAFd9gADV"
                },
            },
            "cache_st": 1526304953,
            "entry_id": "1_5bujdr9l"
        });
    </script>
</body>
</html>

Example above use embed code for Kaltura player and configures bradmax analytics plugin for it in field "bradmaxAnalytics". All additional details about video are taken automatically from player via Kaltura API.

Tracking engagement rate example

It is only needed to add parameter

trackEngagementRate: true

into configuration object.

"bradmaxAnalytics": {
    "plugin": true,
    "iframeHTML5Js": "https://example.com/bradmax.analytics.js",
    "clientToken": "SJnO!AzdDggLdOyAIdBg5DIjjeIOMAFd9gADV",
    "trackEngagementRate": true
},

Tracking realtime statistics example

It is only needed to add parameter

trackRealtimeStats: true

into configuration object.

"bradmaxAnalytics": {
    "plugin": true,
    "iframeHTML5Js": "https://example.com/bradmax.analytics.js",
    "clientToken": "SJnO!AzdDggLdOyAIdBg5DIjjeIOMAFd9gADV",
    "trackRealtimeStats": true
},