Android / AndroidTV SDK

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.

Copyallprojects { repositories { jcenter() google() maven { url 'https://artifacts.bitmovin.com/artifactory/public-releases' } } }

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.

Copydependencies { implementation 'com.bitmovin.analytics:collector-bitmovin-player:{Version Number}' }

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.

Copy<meta-data android:name="BITMOVIN_ANALYTICS_LICENSE_KEY" android:value="<ANALYTICS_LICENSE_KEY>" />

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

Copy<uses-permission android:name="android.permission.INTERNET" />

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

Copy// Create a BitmovinAnalyticsConfig using your Bitmovin analytics license key and (optionally) your Bitmovin Player Key BitmovinAnalyticsConfig bitmovinAnalyticsConfig = new BitmovinAnalyticsConfig("<BITMOVIN_ANALYTICS_KEY>", "<BITMOVIN_PLAYER_KEY>"); // Create Analytics Collector for BitmovinPlayer BitmovinPlayerCollector analyticsCollector = new BitmovinPlayerCollector(bitmovinAnalyticsConfig, getApplicationContext()); // Attach your player instance analyticsCollector.attachPlayer(player); // Detach your player when you are done. For example, call this method when you call the release() method analyticsCollector.detachPlayer();

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

Copy//Detach your player when the first video is completed analyticsCollector.detachPlayer(); //Update your config with new optional parameters related to the new video playback bitmovinAnalyticsConfig.setVideoId("newVideoId"); bitmovinAnalyticsConfig.setCustomData1("newCustomData"); //Reattach your player instance analyticsCollector.attachPlayer(newPlayer);

You can add optional configuration parameters as well:

CopybitmovinAnalyticsConfig.setVideoId("videoId1234"); bitmovinAnalyticsConfig.setCustomUserId("customUserId1"); bitmovinAnalyticsConfig.setCdnProvider(CDNProvider.BITMOVIN); bitmovinAnalyticsConfig.setExperimentName("experiment-1"); bitmovinAnalyticsConfig.setCustomData1("customData1"); bitmovinAnalyticsConfig.setCustomData2("customData2"); bitmovinAnalyticsConfig.setCustomData3("customData3"); bitmovinAnalyticsConfig.setCustomData4("customData4"); bitmovinAnalyticsConfig.setCustomData5("customData5");

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