[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

iOS / tvOS 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: Add the SDK to Your ProjectLink Icon

Add the SDK to the Project Using CocoaPods

BitmovinAnalyticsCollector is available through CocoaPods. We depend on cocoapods version >= 1.4.

To install it, simply add the following line to your Podfile, while replacing {Version Number} with the desired tag version number. The available tag versions are listed in bitmovin/bitmovin-analytics-collector-ios and bitmovin/bitmovin-player-ios-sdk-cocoapod github repositories.

After that, install the pod using pod install.

Add the Analytics SDK to the Project directly

As an alternative to CocoaPods, you can download the latest SDK bundle release from GitHub.

Then, when using Xcode, go to the General settings page by clicking on your projectin the left sidebar, and add the SDK bundle (BitmovinAnalytics.framework) under Linked Frameworks and Libraries.

Step 2: Setup the Analytics CollectorLink Icon

Instantiate Analytics

First, you need to create the config.

Then, you can add optional configuration parameters:

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


Give us feedback