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 .
Embed Bitmovin Analytics Collector
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
Create Analytics Configuration
To activate analytics, add the analytics configuration to the player configuration, with the analytics property and then instantiate the player.
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.
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
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.
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
localhost is allowlisted by default to ease the development process, so you don't have to deal with license denials while working on your integration locally.
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.
You can find many more fully functional code examples in our Github Repository.