[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

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.

Add the following lines to the Podfile of your project while replacing Version Number Version Number with the desired version of the SDK. All available versions are listed in the cocoapod repository.

Run pod repo update to add the newly added source and run pod install to install it.

Collector for Bitmovin Player v3

For Bitmovin Player SDK v3, you have to use the latest version of the 2.x.x BitmovinAnalyticsCollector

Collector for Bitmovin Player v2

For Bitmovin Player SDK v2, you have to use the latest version of the 1.x.x BitmovinAnalyticsCollector

Collector for AVFoundation Player

For AVFoundation Player, you have to use the latest version of the 1.x.x BitmovinAnalyticsCollector

Deprecated - Collector integration before 1.20.0

If you want to integrate BitmovinAnalyticsCollector versions before 1.20.0, you have to specify the desired tag version directly

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

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