---
updatedAt: 2026-11-04T17:14:31.000Z
agentTools:
  siteIndex: https://developer.bitmovin.com/llms.txt
  projectIndex: https://developer.bitmovin.com/playback/llms.txt
---

# Analytics Collector - Roku

## 2.29.0

Release: 2026-11-04

### Added

* `videoBitrate` and `qualityChange` samples for the native Roku player collector, based on the Video node's `streamingSegment` field

***

## 2.28.0

Release: 2026-10-27

### Added

* `droppedFrames` reporting for all collectors on Roku OS 11.0 and later

***

## 2.27.0

Release: 2026-10-20

### Added

* `adTitle`, `creativeAdId`, `advertiserName`, `adClickthroughUrl`, `isLinear` and `isSlate` on THEOplayer client-side ad samples

### Fixed

* THEOplayer client-side ad samples reporting the VAST tag URL as `mediaUrl` instead of `adTagUrl`
* THEOplayer client-side ad samples reporting the content's `streamFormat` instead of the ad's

***

## 2.26.0

Release: 2026-10-09

### Fixed

* `videoStartupTime` on THEOplayer including the playback time of a client-side pre-roll
* `videoStartFailed` with reason `TIMEOUT` on THEOplayer reported for client-side pre-rolls of 60 seconds or longer
* spurious `seeking` sample after every CSAI ad break on THEOplayer
* `videoTimeEnd` of the closing `ad` sample pointing at the resumed content position instead of the ad break position

***

## 2.25.0

Release: 2026-09-25

### Added

* `programChange` support for the native player collector

***

## 2.24.0

Release: 2026-09-18

### Added

* `programChange` support for the Bitmovin Player collector

### Changed

* `programChange` now reports the state name `programchange` instead of `programChange`, matching the other platforms
* the first sample after a `programchange` now reports `duration` 1 instead of 0, matching the other platforms

***

## 2.23.0

Release: 2026-08-28

### Fixed

* `videostartfailed` not getting reset after startup errors
* ad abandonment tracking issues on unforeseen playback interruptions
* `error` samples sometimes not appearing in the dashboard on failover source loading

***

## 2.22.0

Release: 2026-07-28

### Added

* support for automated SSAI reporting on THEOplayer
* extended SSAI ad metadata for THEOplayer `creativeId`, `creativeAdId`, `advertiserName`, `title`, `universalAdIdValue`, `universalAdIdRegistry`, `isSlate`), extracted from `ad.customData` where not exposed as a top-level field

### Changed

* deprecated `ssaiEngagementTrackingEnabled` — SSAI ad engagement tracking (started, quartiles) is now always enabled for all collectors and the flag is ignored

### Fixed

* missing `adPodPosition` for SSAI

***

## 2.21.0&#x20;

Release: 2026-06-25

### Added

* support for new startup event order in THEOplayer `11.4.0`

***

## 2.20.0

Release: 2026-06-09

### Added

* sending of a final sample when player or collector are `destroy`ed

### Fixed

* missing `qualityChange` events and video bitrates for the Bitmovin Player collector

***

## 2.19.0

Release: 2026-05-28

### Added

* ad abandonment tracking metrics for SSAI

***

## 2.18.0

Release: 2026-05-15

### Added

* tracking for `autoplay` config on THEO and Bitmovin collectors

### Fixed

* missing `customdatachange`-event when calling `setCustomDataOnce`
* reported startup time in THEO collector being too low

***

## 2.17.0

Release: 2026-04-23

### Fixed

* `setCustomData` missing state-specific attributes

### Changed

* `setCustomDataOnce`/`setCustomData` to be safeguarded and only respect valid `customData<n>` keys in the parameter object

***

## 2.16.0

Release: 2026-04-09

### Changed

* Tracking playback quality by observing `activequalitychanged` for THEOplayer versions >= `10.11.0`

### Fixed

* Buffering samples now always report as "buffering"

***

## 2.15.2

Release: 2026-04-03

### Fixed

* `setCustomData` sending unnecessary samples if the provided new custom data values match the current values

***

## 2.14.2

Release: 2026-04-03

### Fixed

* `setCustomData` sending unnecessary samples if the provided new custom data values match the current values

***

## 2.15.1

Release: 2026-03-25

### Fixed

* Potential runtime error after player destruction with THEOplayer collector

***

## 2.14.1

Release: 2026-03-24

### Fixed

* Potential runtime error after player destruction with THEOplayer collector

***

## 2.15.0

Release: 2026-03-19

### Added

* official support for CSAI-tracking on THEOplayer/Dolby OptiView

***

## 2.15.0-beta.0

Release: 2026-03-18

### Added

* automated CSAI tracking for THEOplayer/Dolby OptiView
* error tracking for CSAI on THEOplayer/Dolby OptiView
* proper ad-state tracking in the dashboard *Session log* for THEOplayer/Dolby OptiView

### Fixed

* Prevent duplicate SETUP sample with THEO player when calling `setCustomData` or `setCustomDataOnce` before playback starts
* THEO player collector stops on player error

***

## 2.14.0

Release: 2026-03-02

### Added

* support for Dolby OptiView's THEOplayer Roku SDK

***

## 2.14.0-beta.0

Release: 2026-02-19

### Added

* experimental support for Dolby OptiView's THEOplayer Roku SDK

***

## 2.13.0

Release: 2025-12-04

### Fixed

* collector crashing when the player license request gets rejected with newer player versions

***

## 2.12.0

Release: 2025-10-30

### Added

* `error` field on collectors for dynamic error mapping

### Fixed

* potential crashes if metadata is not set during SSAI ad breaks

***

## 2.11.1

Released: 2025-09-26

### Fixed

* crashes when calling `adQuartileFinished` when there is no `adQuartileMetadata`

***

## 2.11.0

Released: 2025-02-14

### Added

* Add 20 additional `CustomData` fields

### Changed

* When calling `adBreakStart` the `AdPosition` property of the `adBreakMetadata` parameter now has to be one of the following values: "preroll", "midroll", "postroll". Otherwise API call is ignored and warning is issued

***

## 2.10.0

Released: 2024-10-30

**Added**

* Add `ssaiEngagementTrackingEnabled` flag to bitmovin analytics config to enable ad engagement tracking

**Changed**

* Ad engagement is no longer tracked by default

***

## 2.9.1

Released 2024-10-22

**Fixed**

* incorrect version being reported (previous versions may get mistakenly reported as `2.6.3`)

***

## 2.9.0

Released 2024-10-10

**Fixed**

* collector crashes for certain SSAI workflows

**Known Issues**

* Collector is reported with version `2.6.3`

***

## 2.8.0

Released 2024-09-02

**Added**

* `adQuartileFinished` API call to enable tracking of SSAI ad quartiles

**Fixed**

* Some errors during startup were not tracked

**Known Issues**

* Collector is reported with version `2.6.3`

***

## 2.7.0

Released 2024-07-09

**Added**

* `adBreakStart`, `adStart`, `adBreakEnd` API calls to enable the tracking of SSAI ads.

**Fixed**

* Bitmovin player name was uppercased which is inconsistent with other Bitmovin Player collectors

**Known Issues**

* Collector is reported with version `2.6.3`

***

## 2.6.3

Released 2024-03-26

**Fixed**

* Collector permanently stops collecting data after an error event

***

## 2.6.2

Released 2023-09-28

**Fixed**

* Video start up time being 0 when autoplay is disabled
* Player not correctly being recognized as Bitmovin player

***

## 2.6.1

Released 2023-05-12

**Fixed**

* Runtime error when seeking on a live stream with Bitmovin Collector

***

## 2.6.0

Released 2022-11-29

**Added**

* tracking of video duration for Bitmovin and Native player

***

## 2.5.2

Released 2022-06-01

**Fixed**

* fixed console warnings which have been introduced with Roku OS 11

***

## 2.5.1

Released 2022-06-01

**Changed**

* bitmovin player collector does not require manual deinitialisation call anymore. It automatically removes itself after the Bitmovin player is destroyed.

***

## 2.5.0

Released 2022-05-12

**Added**

* deinitialisation path for the collector with the destroy method

***

## 2.4.0

Released 2022-04-11

**Added**

* tracking of system, audio and subtitle language

***

## 2.3.0

Released 2022-01-18

**Added**

* additional customData fields 26 to 30

***

## 2.2.0

Released 2021-10-19

**Added**

* customData fields 8 to 25

***

## 2.1.0

Released 2021-03-31

**Changed**

* collector behaviour to stop collecting samples after an error

**Removed**

* collection of error segments

**Fixed**

* native collector reporting wrong seek time

***

## 2.0.0

Released 2021-01-17

This release introduces a breaking change of how Bitmovin Analytics is initialised.

**Changed**

* setup of Bitmovin Analytics to also set the licenseKey during runtime (alternative to setting it in manifest file)

**Fixed**

* detection of operating system and device type

***

## 1.1.1

Released 2020-07-28

**Fixed**

* `videoTitle` was not correctly sent to the server

***

## 1.1.0

Released 2019-06-17

**Added**

* playAttempt tracking for player errors and timeouts during video startup
* logging of failed licensing requests to developer console for easier debugging

***

## 1.0.0

Released 2019-03-29

**Added**

* Initial release of Roku Collector