Streaming Video & Ads for others release notes

Streaming Video & Ads for others v4.0.0

Tue, 25 Feb 2025 00:00:00 +0000

New features & enhancements

New Event Types Introduced
- VideoAction: This event type represents standard actions related to video playback and interaction.
- VideoErrorAction: This event type captures errors that occur during video playback, providing detailed insight for troubleshooting.
- VideoAdAction: Dedicated event type for tracking actions related to video advertisements, ensuring better granularity and reporting.
- VideoCustomAction: A flexible event type for custom actions and interactions within video applications.
- ConnectedDeviceSystem: This event type monitors general system level events.

Deprecations

RokuVideo
- The RokuVideo event type has been deprecated. Users should transition to using the newer event types that offer enhanced tracking capabilities and specificity.
RokuSystem
- The RokuSystem event type has been deprecated. Users should transition to using the newer event types that offer enhanced tracking capabilities and specificity.

New attributes introduced

We have introduced a set of new attributes to enhance data tracking and analytics. These attributes provide additional context and details for the new event types. Please refer to the data model documentation for more details.

Impact & actions required

Transition from RokuVideo: Users currently tracking RokuVideo events should adapt their implementations to utilize the newly introduced event types. This change provides improved specificity and scope in tracking actions across video interactions.
Update Implementations: Integrators should update their systems to leverage new attributes introduced with the release, which provide richer context and detail for event tracking.
Testing & Validation: We recommend testing the implementation of new attributes and event types to ensure compatibility and correct data transmission.

Additional information

For more details on implementing these changes, refer to the updated documentation and integration guides available here. Should you have any questions or require further assistance, please reach out to our support team.

Streaming Video & Ads for others v4.0.1

Tue, 22 Apr 2025 00:00:00 +0000

Bug fix

Renamed errorName with errorMessage as errorName has been deprecated.

Streaming Video & Ads for others v4.0.2

Tue, 22 Apr 2025 00:00:00 +0000

Updated

Added contentBitrate attribute to video events. This uses segmentationBitrate if available, and falls back to streamBitrate when necessary.
Added adBitrate attribute to ad events. The ad bitrate is now extracted using multiple methods and is standardized to bps (bits per second).
Added timeSinceLastError attribute to error events, reporting the time elapsed since the previous error event.

Streaming Video & Ads for others v4.0.4

Wed, 12 Nov 2025 00:00:00 +0000

Bug fix

Avoid adding appId from dataToken.
Fixed nrSendErrorEvent to send proper data.

Streaming Video & Ads for others v4.0.3

Wed, 22 Oct 2025 00:00:00 +0000

New feature

Ad error timing analytics

Added comprehensive tracking for ad error recovery patterns to enhance video advertising analytics.

What's changed

New timing attribute

timeSinceLastAdError: Tracks elapsed time since the last ad error occurred
- Available for VideoAdAction event type only
Provides insights into ad error patterns and recovery times
Helps optimize ad error handling strategies

Implementation details

Enhanced nrTrackRAF() function with error timestamp tracking
Added conditional attribute logic in nrAddRAFAttributes() function
Implemented robust error state management for accurate timing

Streaming Video & Ads for others v4.1.0

Thu, 09 Apr 2026 00:00:00 +0000

New features

Added QoE analytics for comprehensive video quality tracking with advanced performance metrics
Added averageBitrate attribute: time-weighted average bitrate across playback
Added peakBitrate attribute: highest bitrate achieved during playback
Added startupTime attribute: time from content request to first frame (excludes pre-roll ads)
Added rebufferingRatio attribute: percentage of playback time spent rebuffering
Added totalRebufferingTime attribute: total milliseconds in buffer states
Added totalPlaytime attribute: total content playback time in milliseconds
Added hadStartupError attribute: boolean indicating if startup failed before content start
Added hadPlaybackError attribute: boolean indicating if playback errors occurred during session
Added nrActivateQoeTracking(nr) to enable QoE tracking (disabled by default)
Added nrSetQoeAggregateIntervalMultiplier(nr, multiplier) to configure event frequency

Update

Synchronized QoE events with harvest cycles
Prevented redundant events through intelligent duplication
Implemented per-session metric isolation and cleanup
Implemented time-weighted bitrate calculations for accuracy
Implemented smart startup time calculation excluding ad time
Disabled QoE tracking by default; harvest multiplier set to 1 (every harvest cycle)

Streaming Video & Ads for others v4.2.0

Thu, 14 May 2026 00:00:00 +0000

New features

Added native support for AWS Elemental MediaTailor server-side ad insertion via Roku's RAFX_SSAI awsemt adapter
Added automatic VideoAdAction recording for MediaTailor ad lifecycle events: AD_BREAK_START, AD_REQUEST, AD_START, AD_QUARTILE, AD_END, AD_BREAK_END, and AD_ERROR
Added nrEnableMediaTailorTracking(nr, adIface) to register New Relic listeners on a RAFX_SSAI adapter in one call
Added nrSetMediaTailorAdMetadata(tracker, metadata) to inject sidecar key/value metadata into VideoAdAction events
Added nrSendVideoAdEvent(nr, actionName, attr) for direct recording of VideoAdAction from any tracker
Added MediaTailorTask.brs reference task and VideoScene.brs sample demonstrating the recommended integration pattern

Update

Created MediaTailorTracker in the scene thread and passed to the task via a node field for RAFX listener compatibility
Initialised session through RAFX_SSAI.requestStream(); assigned stitched manifest URL from getStreamInfo().manifest_url to the Video node
Added Video node position field observation in the task event loop for ad-break timing resolution
Set MediaTailor support as opt-in; activates only when nrEnableMediaTailorTracking is called

Bug fixes

Fixed Google IMA ad lifecycle events (AD_BREAK_START, AD_BREAK_END, AD_START, AD_END, AD_QUARTILE, AD_ERROR) to correctly produce VideoAdAction instead of VideoAction

Streaming Video & Ads for others v4.2.2

Wed, 05 Aug 2026 00:00:00 +0000

New features

Added "JP" as a supported region value (alongside "US", "EU", and "staging"), routing event, log, metric, and mobile-connect traffic to the New Relic Japan collector endpoints. Region matching is case-insensitive ("JP" or "jp").

Bug fixes

Fixed a dirty-check gap where QOE_AGGREGATE events stopped being sent after the first one whenever only a KPI added in 4.2.1 (avgDownloadRate, minDownloadRate, maxDownloadRate, totalSwitchUps, totalSwitchDowns, totalPauseTime, totalRenditions) changed between harvests—most noticeable during a long pause, where totalPauseTime was the only value still moving.

Notes

Removed totalTimeSwitchedDown from the QOE_AGGREGATE event and its internal tracking (rendition-switch-down interval accumulation).

Streaming Video & Ads for others v4.2.3

Thu, 27 Aug 2026 00:00:00 +0000

Added

Added contentIsLive attribute to VideoAction/VideoAdAction events, reflecting the Video node's content.live field when set — brings Roku in line with the standard cross-agent video data model.

Fixed

Fixed CONTENT_BUFFER_END being delayed until playback resumed when a rebuffer completed while the video was paused. The event now fires as soon as buffering actually recovers, independent of whether the user has resumed playback — correcting over-reported buffering duration and total rebuffering time for pause-during-buffer scenarios.
Fixed errorCode/errorMessage/backtrace being stamped onto every VideoAction/VideoAdAction event, including heartbeats — Roku's Video node reports errorCode: 0 (not invalid) even absent an error, so every non-error event was leaking error-shaped attributes (NR-606648). These now only appear on actual error events.
Fixed MediaTailor SSAI debug logging (nrActivateLogging) being silently suppressed since its introduction in 4.2.0 — an extra argument passed to nrCheckLoggingState() via callFunc caused the call to no-op instead of evaluating the logging gate, so no MediaTailor debug output was ever produced regardless of logging state.