[object Object] Icon

Encoding
Learn how to create, start, manage and modify Encodings

[object Object] Icon

Player
Learn how to create, start, manage and modify Players

[object Object] Icon

Analytics
Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

Web SDK

Bitmovin Analytics enables you to get useful insights into the video usage in your apps. It offers a simple integration with the Bitmovin Player, which is a prerequisite for the following guide.

For more information on how to setup a player, go to the Player getting started guide .

Step 1: Embed Bitmovin Analytics CollectorLink Icon

Embed Bitmovin Analytics Collector

Standard

In standard Bitmovin Player package Bitmovin Analytics already comes pre-packaged with the Player, you just have to enable it via the Player configuration this is only available from player version 8.

Modular

If you are using the Modular Bitmovin Player packages, you need to manually add the Bitmovin Analytics Collector to your website

Step 2: Setting up a ConfigurationLink Icon

Create Analytics Configuration

To activate analytics, add the analytics configuration to the player configuration, with the analytics property and then instantiate the player.

Standard
Modular

For all configuration options, please see the Analytics Configuration Overview

When you are loading a new video, you can pass its metadata with the source config. Analytics will then automatically pick up the new metadata and use it for the following events.

CDN Provider

If you are using multiple CDNs or plan to test with different CDNs in the future it's very helpful to set the cdnProvider parameter to be able to compare performance between the CDNs. You can specify any string, but we have built in some constan ts that are available on bitmovin.analytics.CdnProviders:

  • BITMOVIN
  • AKAMAI
  • FASTLY
  • MAXCDN
  • CLOUDFRONT
  • CHINACACHE
  • BITGRAVITY

Custom Data

It is possible to supply custom data to Bitmovin Analytics. We support 5 fields for custom data as well as experimentName which can be used to A/B Test your setup.

  • customData1
  • customData2
  • customData3
  • customData4
  • customData5

Step 3: Setup Your Analytics LicenseLink Icon

Whitelist Domains

In order to use the Analytics on your website(s), you have to white-list the domain(s) of your website(s) for which you want to use it. This is a security mechanism and protects your license from being used elsewhere.

It can be done in our dashboard under Analytics -> Licenses

The domain localhost is whitelisted by default to ease the development process, so you don't have to deal with license denials while working on your integration locally.

ScreenshotDashboardLicensesNoinlineSvg

Step 4: Final ReviewLink Icon

After the setup is done there is nothing more to do. Events are recorded automatically and you can head over to the analytics dashboard to see statistics.

ExamplesLink Icon

You can download fully functional code examples from our Github account.

Github

Give us feedback