[object Object] Icon

Learn how to create, start, manage and modify Encodings

[object Object] Icon

Learn how to create, start, manage and modify Players

[object Object] Icon

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

Android / ExoPlayer SDK

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

In order to follow along this guide, you need at least a basic ExoPlayer setup.
If you don't have that yet, please go to the ExoPlayer documentation and follow the instructions there.

Step 1: Add the SDK to Your ProjectLink Icon

Add a Link to the Player SDK to the Project

Add a link to our release repository to your application's build.gradle file. In addition to that, the google maven repository must be added.

Add the Dependency to the Project

Add the Bitmovin Analytics Android SDK as a dependency to your project as shown below, while replacing {Version Number} with the desired SDK version number. The available SDK versions are listed in our maven repository.

Step 2: Setup ProjectLink Icon

Edit Manifest

The Bitmovin Analytics license key and the necessary permissions have to be added to the manifest file.
The following line should be added inside the application element.

The player requires the INTERNET permission. The following line should be added inside the manifest element.

Step 3: Setup the Analytics CollectorLink Icon

Instantiate Analytics

First, create the BitmovinAnalytics object and attach an Bitmovin Native SDK instance to it:

When switching to a new video we recommend that you follow the sequence of events below.

You can add optional configuration parameters as well:

Step 4: Setup Your Analytics LicenseLink Icon

Allowlist Package Name

In order to use Analytics on your website(s), you have to allowlist the package name of your app for which you want to use it. This is a security mechanism that protects your license from being used elsewhere.

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


Step 5: 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.

Give us feedback