![[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+)
Overview
Bitmovin Analytics allows for extensive customization of your data architecture. This means data can be easily extended and enriched with information that is not collected through the player integration. Here’s a list of all fields that can be set in the Analytics configuration.
Configuration Options
| Field Name | Category | Use-Case | Pre-requisite for |
|---|---|---|---|
videoTitle | Required | Configuring the videoTitle will allow you to efficiently compare the performance of different content pieces in the Bitmovin Analytics Dashboard. You will see names and titles instead of just numbers and IDs. | Video Title Filter Video Title Breakdown Bitrate Heatmap |
videoId | Required | Configuring the videoId is important to ensure consistency within your data framework. We use the videoId to enable filtering and breaking down by videoTitle, hence setting the videoId is a pre-requisite to enable this feature. If no videoId is set the videoTitle filter cannot be applied to the data.In case there are multiple videoTitles with the same videoId, we assign the data to each of the different videoTitles. | Video Title Filter Video Title Breakdown Bitrate Heatmap |
cdnProvider | Optional | Setting the CDN provider in the configuration allows you to use CDN as a breakdown or global filter in the Bitmovin Analytics Dashboard and API. This will enable you to compare the performance of the different CDN providers that you’re using. | CDN Filter CDN Breakdown |
isLive | Optional | Differentiating between Live and VOD content is important, as both are often distributed through different workflows. Auto-detection is only possible once stream metadata is received so explicitly providing this information is helpful in certain cases and improves the accuracy of your data. | Live Filter Live Breakdown |
Experiment | Optional | For testing purposes, Bitmovin Analytics provides an Experiment field to differentiate between testing groups.A popular application for this data field is to use it for testing a new player version, before rolling it out to all your viewers. | Experiment Filter Experiment Breakdown |
customUserId | Optional | The customUserId field can be used to integrate a subscriber or user ID into Bitmovin Analytics.Features such as Session Tracking will only work if a customUserId is configured. Otherwise, all impressions will be assigned to a single null user.A consistent ID for a specific user is important to enable use-cases such as cross-device tracking. For privacy reasons we advise you to send customUserIds not as emails or otherwise personally identifiable form but either as IDs or in a hashed formIn case you want to tie your video Analytics data with other data sets, it is important to pass customUserIds in a format that is consisten across your different data sources. | Session Tracking |
customData1customData2customData3customData4customData5 | Optional | The five customData fields can be freely configured. The data sent through these fields can be used as a filter or as a breakdown to segment the data according to your needs.Common use-cases for customData are sending the app version used, a cross-domain or profile ID, to track viewers across different platforms, or assigning a high-level content category to order content assets. But the options are more or less unlimited.In the dashboard, under the license settings, customData fields can be labeled according to your liking. Note: For customData field queries we allow a cardinality of maximum of 15,000 distinct values per customData field within the selected time-frame. Each customData field has a limit of 160 characters. | Custom Filters Custom Breakdowns |