Streaming Video & Ads for others release notesRSS

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

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)

Bug fix

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

고치다

• dataToken 에서 appId 더하지 마십시오.
• nrSendErrorEvent 수정하여 올바른 데이터를 전송하세요.

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

새로운 기능

광고 오류 타이밍 분석

• 동영상 광고 분석을 강화하기 위해 광고 오류 복구 패턴에 대한 포괄적인 추적 기능을 추가했습니다.

변경된 사항

새로운 타이밍 속성

• timeSinceLastAdError: 마지막 광고 오류 발생 이후 경과 시간을 추적합니다.
  • VideoAdAction 이벤트 유형에만 사용 가능합니다.
• 광고 오류 패턴 및 복구 시간에 대한 정보를 제공합니다.
• 광고 오류 처리 전략 최적화에 도움이 됩니다.

구현 세부 사항

• 오류 타임스탬프 추적 기능이 추가된 향상된 nrTrackRAF() 함수
• nrAddRAFAttributes() 함수에 조건부 속성 로직을 추가했습니다.
• 정확한 타이밍을 위해 강력한 오류 상태 관리 기능을 구현했습니다.

Bug fix

• Renamed errorName with errorMessage as errorName has been deprecated.

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.

고치다

• errorName 더 이상 사용되지 않으므로 errorName 의 이름이 errorMessage 로 변경되었습니다.