![[object Object] Icon](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgMzIgMzIiPjxkZWZzPjxsaW5lYXJHcmFkaWVudCBpZD0iYSIgeDE9IjE2IiB5MT0iLTUwOTIuMjUiIHgyPSIxNiIgeTI9Ii01MTIzLjk4IiBncmFkaWVudFRyYW5zZm9ybT0ibWF0cml4KDEsIDAsIDAsIC0xLCAwLCAtNTA5Mi4xMikiIGdyYWRpZW50VW5pdHM9InVzZXJTcGFjZU9uVXNlIj48c3RvcCBvZmZzZXQ9IjAiIHN0b3AtY29sb3I9IiMxYWIzZmYiLz48c3RvcCBvZmZzZXQ9IjEiIHN0b3AtY29sb3I9IiMwZTgyZmYiLz48L2xpbmVhckdyYWRpZW50PjwvZGVmcz48dGl0bGU+SWNvbnM8L3RpdGxlPjxwYXRoIGQ9Ik0xLjUsMTAuNDh2MTFhNC44MSw0LjgxLDAsMCwwLDIuNDMsNC4xN2w5LjY1LDUuNTJhNC44MSw0LjgxLDAsMCwwLDQuODQsMGw5LjY1LTUuNTJhNC44LDQuOCwwLDAsMCwyLjQzLTQuMTd2LTExYTQuODEsNC44MSwwLDAsMC0yLjQzLTQuMTdMMTguNDIuNzlhNC44MSw0LjgxLDAsMCwwLTQuODQsMEwzLjkzLDYuMzFBNC43OCw0Ljc4LDAsMCwwLDEuNSwxMC40OFoiIHN0eWxlPSJmaWxsOnVybCgjYSkiLz48cGF0aCBkPSJNMjQuODMsMTZsLS43MS0xLjIxYS42My42MywwLDAsMC0uNTItLjMxSDIyLjJhLjU4LjU4LDAsMCwwLS41Mi4zMWwtLjQ5Ljg1SDE4LjlhLjEzLjEzLDAsMCwwLDAsMEwxOCwxNC4wNmExLjQxLDEuNDEsMCwwLDAtMS4yMi0uNzFIMTVMMTMuNjgsMTEuMmwuNTQtLjkzYS42LjYsMCwwLDAsMC0uNjFsLS43MS0xLjIxQS42MS42MSwwLDAsMCwxMyw4LjE0aC0xLjRhLjU4LjU4LDAsMCwwLS41Mi4zMWwtLjcxLDEuMjFhLjYuNiwwLDAsMCwwLC42MWwuNzEsMS4yMWEuNjMuNjMsMCwwLDAsLjUyLjMxaC44OWwxLjM0LDIuMjZoMEwxMywxNS41NUExLjQxLDEuNDEsMCwwLDAsMTMsMTdsLjg2LDEuNDkuMDcuMTItMS4yOSwyLjE1aC0xYS42LjYsMCwwLDAtLjUyLjMxbC0uNzEsMS4yMmEuNTkuNTksMCwwLDAsMCwuNmwuNzEsMS4yMmEuNjMuNjMsMCwwLDAsLjUyLjMxSDEzYS42LjYsMCwwLDAsLjUyLS4zMWwuNzEtMS4yMmEuNTkuNTksMCwwLDAsMC0uNmwtLjQ4LS44MywxLjM0LTIuMjVoMS43MWExLjQsMS40LDAsMCwwLDEuMjItLjdsLjg2LTEuNXMwLDAsMCwwaDIuMjlsLjQ5Ljg1YS42NS42NSwwLDAsMCwuNTIuMzFoMS40YS42LjYsMCwwLDAsLjUyLS4zMWwuNzEtMS4yMkEuNjIuNjIsMCwwLDAsMjQuODMsMTZabS03LjEuMzYtLjg2LDEuNDlzMCwwLS4wOCwwSDE1czAsMCwwLDBsLS44Ni0xLjQ5YS4wOC4wOCwwLDAsMSwwLS4wOUwxNSwxNC43NHMwLDAsMCwwYTAsMCwwLDAsMSwwLDBoMS43NGEuMTUuMTUsMCwwLDEsLjA4LjA1bC44NiwxLjQ5QS4xNC4xNCwwLDAsMSwxNy43MywxNi4zMloiIHN0eWxlPSJmaWxsOiNmZmYiLz48cGF0aCBkPSJNMTEuNDgsMTUuNzRhLjY2LjY2LDAsMCwxLC42Ny42NS42NS42NSwwLDAsMS0uNjcuNjZIMTAuMTVhLjY2LjY2LDAsMSwxLDAtMS4zMVoiIHN0eWxlPSJmaWxsOiNmZmYiLz48cGF0aCBkPSJNMTcuOTEsMTkuNjNhLjY3LjY3LDAsMCwxLC45MS4yNEwxOS41LDIxYS42NC42NCwwLDAsMS0uMjQuODkuNzIuNzIsMCwwLDEtLjM0LjA5LjY4LjY4LDAsMCwxLS41OC0uMzRsLS42Ny0xLjE0QS42My42MywwLDAsMSwxNy45MSwxOS42M1oiIHN0eWxlPSJmaWxsOiNmZmYiLz48cGF0aCBkPSJNMTguMjUsMTMuMjVhLjgxLjgxLDAsMCwxLS4zNC0uMDguNjMuNjMsMCwwLDEtLjIzLS45bC42Ny0xLjE1YS42OC42OCwwLDAsMSwuOTEtLjIzLjY1LjY1LDAsMCwxLC4yNC44OWwtLjY3LDEuMTRBLjY1LjY1LDAsMCwxLDE4LjI1LDEzLjI1WiIgc3R5bGU9ImZpbGw6I2ZmZiIvPjwvc3ZnPg==)
![[object Object] Icon](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgMzIgMzIiPjxkZWZzPjxsaW5lYXJHcmFkaWVudCBpZD0iYSIgeDE9IjE2IiB5MT0iLTUyNjguNjQiIHgyPSIxNiIgeTI9Ii01MzAwLjM2IiBncmFkaWVudFRyYW5zZm9ybT0ibWF0cml4KDEsIDAsIDAsIC0xLCAwLCAtNTI2OC41KSIgZ3JhZGllbnRVbml0cz0idXNlclNwYWNlT25Vc2UiPjxzdG9wIG9mZnNldD0iMCIgc3RvcC1jb2xvcj0iIzFhYjNmZiIvPjxzdG9wIG9mZnNldD0iMSIgc3RvcC1jb2xvcj0iIzBlODJmZiIvPjwvbGluZWFyR3JhZGllbnQ+PC9kZWZzPjx0aXRsZT5JY29uczwvdGl0bGU+PHBhdGggZD0iTTEuNSwxMC40OHYxMWE0LjgxLDQuODEsMCwwLDAsMi40Myw0LjE3bDkuNjUsNS41MmE0LjgxLDQuODEsMCwwLDAsNC44NCwwbDkuNjUtNS41MmE0LjgsNC44LDAsMCwwLDIuNDMtNC4xN3YtMTFhNC44MSw0LjgxLDAsMCwwLTIuNDMtNC4xN0wxOC40Mi43OWE0LjgxLDQuODEsMCwwLDAtNC44NCwwTDMuOTMsNi4zMUE0Ljc4LDQuNzgsMCwwLDAsMS41LDEwLjQ4WiIgc3R5bGU9ImZpbGw6dXJsKCNhKSIvPjxwYXRoIGQ9Ik0xMy42LDIxLjI5YTEuNzksMS43OSwwLDAsMS0uOS0uMjVBMS4zNywxLjM3LDAsMCwxLDEyLDE5Ljg5VjEzYTEuMzUsMS4zNSwwLDAsMSwuNjgtMS4xNSwxLjc4LDEuNzgsMCwwLDEsMS43MiwwbDYuNTIsMy40N2ExLjMsMS4zLDAsMCwxLDAsMi4zNkwxNC40MiwyMS4xQTEuOSwxLjksMCwwLDEsMTMuNiwyMS4yOVptMC03Ljg4djYuMDZhLjE1LjE1LDAsMCwwLC4yMi4xNGw1LjcxLTNhLjE4LjE4LDAsMCwwLDAtLjMybC01LjcxLTNBLjE1LjE1LDAsMCwwLDEzLjU5LDEzLjQxWiIgc3R5bGU9ImZpbGw6I2ZmZiIvPjwvc3ZnPg==)
![[object Object] Icon](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgMzIgMzIiPjxkZWZzPjxsaW5lYXJHcmFkaWVudCBpZD0iYSIgeDE9IjE2IiB5MT0iLTUxNzUuMDciIHgyPSIxNiIgeTI9Ii01MjA2LjgiIGdyYWRpZW50VHJhbnNmb3JtPSJtYXRyaXgoMSwgMCwgMCwgLTEsIDAsIC01MTc0LjkzKSIgZ3JhZGllbnRVbml0cz0idXNlclNwYWNlT25Vc2UiPjxzdG9wIG9mZnNldD0iMCIgc3RvcC1jb2xvcj0iIzFhYjNmZiIvPjxzdG9wIG9mZnNldD0iMSIgc3RvcC1jb2xvcj0iIzBlODJmZiIvPjwvbGluZWFyR3JhZGllbnQ+PC9kZWZzPjx0aXRsZT5JY29uczwvdGl0bGU+PHBhdGggZD0iTTEuNSwxMC40OHYxMWE0LjgxLDQuODEsMCwwLDAsMi40Myw0LjE3bDkuNjUsNS41MmE0LjgxLDQuODEsMCwwLDAsNC44NCwwbDkuNjUtNS41MmE0LjgsNC44LDAsMCwwLDIuNDMtNC4xN3YtMTFhNC44MSw0LjgxLDAsMCwwLTIuNDMtNC4xN0wxOC40Mi43OWE0LjgxLDQuODEsMCwwLDAtNC44NCwwTDMuOTMsNi4zMUE0Ljc4LDQuNzgsMCwwLDAsMS41LDEwLjQ4WiIgc3R5bGU9ImZpbGw6dXJsKCNhKSIvPjxwYXRoIGQ9Ik05LjMzLDE3YS42OC42OCwwLDAsMC0uNjcuNjh2My40MWEuNjcuNjcsMCwxLDAsMS4zNCwwVjE3LjY0QS42Ny42NywwLDAsMCw5LjMzLDE3Wm0zLTIuNjNhLjY3LjY3LDAsMCwwLS42Ny42OHY2YS42Ny42NywwLDEsMCwxLjM0LDBWMTVBLjY3LjY3LDAsMCwwLDEyLjM2LDE0LjMzWm02LjA2LTEuOWEuNjcuNjcsMCwwLDAtLjY3LjY4djcuOTRhLjY3LjY3LDAsMSwwLDEuMzQsMFYxMy4xMUEuNjcuNjcsMCwwLDAsMTguNDIsMTIuNDNaIiBzdHlsZT0iZmlsbDojZmZmIi8+PHBhdGggZD0iTTE0LjcxLDE2LjJhLjY3LjY3LDAsMSwxLDEuMzQsMHY0Ljg2YS42Ny42NywwLDEsMS0xLjM0LDBaIiBzdHlsZT0iZmlsbDojZmZmIi8+PHBhdGggZD0iTTIwLjc3LDEwLjk0YS42Ny42NywwLDAsMSwuNjctLjY4LjY4LjY4LDAsMCwxLC42Ny42OXYxMC4xYS42Ny42NywwLDEsMS0xLjM0LDBaIiBzdHlsZT0iZmlsbDojZmZmIi8+PC9zdmc+)
Roku 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 and Roku's native video element. This guide requires an already set up Bitmovin player or Roku video element.
For more information on how to setup the Bitmovin player, go to the Player getting started guide.
Step 1: Setup Your Analytics License
Allowlist Domains
In order to use the Bitmovin Analytics on your Roku channel(s), you have to allow-list the domain(s) for which you want to use it. This is a security mechanism and protects your license from being used elsewhere. Allow-list your Roku app by adding your channel ID.
During local development the domain is defined as dev.roku, which needs to be added to the allow-list. Once your Roku channel is published, make sure that you allow-list the domain (your channel id) which needs to be postfixed with .roku. For example: suppose the channel id is YOUR_CHANNEL_ID, then add YOUR_CHANNEL_ID.roku to the allow-list in the Bitmovin dashboard.
Step 2: Add your License Key
Add the Bitmovin Analytics License Key to your channel's manifest
Alternatively, you can add the license key to the Bitmovin Analytics configuration later on. More on that follows down below.
Step 3: Add the SDK to your Project
Add the Bitmovin Analytics SDK to your project
Visit the Github repository of the Bitmovin Analytics Roku Collector and download the whole repository to your machine. Copy the following directories into the components folder of your Roku app:
collectorCorebitmovinPlayerCollector
Step 4: Setup the Collector for Bitmovin Player
Create the collector
Instantiate the Bitmovin Analytics collector.
Create a collector config
Create a collector configuration object to set video metadata and custom data fields.
It is also possible to pass your Bitmovin Analytics License Key to the collector config with the key property. This is an optional step and not necessary if the license key is defined in the manifest file of your Roku app.
For all configuration options, please see the Analytics Configuration Overview.
Attach the collector to the Bitmovin Player
Initialize the collector with the config and attach it to the Bitmovin Player object m.bitmovinPlayer to start listening to player events.
Notify the collector about source changes
Notify the collector about a source change of the Bitmovin player.
Step 5: Setup the Collector for Roku Native Player
Create the collector
Instantiate the Bitmovin Analytics collector.
Create a collector config
Create a collector configuration object to set video metadata and custom data fields.
It is also possible to pass your Bitmovin Analytics License Key to the collector config with the key property. This is an optional step and not necessary if the license key is defined in the manifest file of your Roku app.
For all configuration options, please see the Analytics Configuration Overview.
Attach the collector to the Roku Native Player
Initialize the collector with the config and attach it to the native player object m.nativePlayer to start listening to player events.
Notify the collector about source changes
Notify the collector about a source change of the native player.
Deinitialize the collector
Clean up the analytics collector when it is no longer needed before removing the native video element.
Step 6: Final Review
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.
More Examples
You can find many more fully functional code examples in our Github Repository.