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

새로운 기능

• Roku의 RAFX_SSAI awsemt 어댑터를 통해 AWS Elemental MediaTailor 서버 측 광고 삽입에 대한 기본 지원이 추가되었습니다.
• MediaTailor 광고 수명 주기 이벤트에 대한 자동 VideoAdAction 기록 추가: AD_BREAK_START, AD_REQUEST, AD_START, AD_QUARTILE, AD_END, AD_BREAK_END 및 AD_ERROR
• 한 번의 호출로 RAFX_SSAI 어댑터에 뉴렐릭 리스너를 등록하도록 nrEnableMediaTailorTracking(nr, adIface) 을(를) 추가했습니다.
• VideoAdAction 이벤트에 사이드카 핵심 가치 메타데이터를 주입하기 위해 nrSetMediaTailorAdMetadata(tracker, metadata) 을(를) 추가했습니다.
• 모든 트래커에서 VideoAdAction 을(를) 직접 기록할 수 있도록 nrSendVideoAdEvent(nr, actionName, attr) 을(를) 추가했습니다.
• 권장 통합 패턴을 보여주는 MediaTailorTask.brs 참조 작업 및 VideoScene.brs 샘플을 추가했습니다

업데이트

• RAFX 리스너 호환성을 위해 씬 스레드에서 MediaTailorTracker 을(를) 생성하고 노드 필드를 통해 태스크에 전달했습니다.
• RAFX_SSAI.requestStream()을(를) 통해 세션을 초기화했습니다, getStreamInfo().manifest_url 에서 비디오 노드에 스티치된 매니페스트 URL을 할당했습니다
• 광고 시간 타이밍 해결을 위해 작업 이벤트 루프에 비디오 노드 position 필드 관찰 추가
• MediaTailor 지원을 옵트인으로 설정, nrEnableMediaTailorTracking 이(가) 호출될 때만 활성화됩니다

버그 수정

• 다음 대신 VideoAdAction 을(를) 올바르게 생성하도록 Google IMA 광고 수명 주기 이벤트(AD_BREAK_START, AD_BREAK_END, AD_START, AD_END, AD_QUARTILE, AD_ERROR)를 수정했습니다 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)

새로운 기능

• 고급 성능 메트릭을 사용한 포괄적인 비디오 품질 추적을 위한 QoE 분석이 추가되었습니다.
• averageBitrate 속성 추가: 재생 전반의 시간 가중 평균 비트 전송률
• peakBitrate 속성 추가: 재생 중 달성한 최고 비트레이트
• startupTime 속성 추가: 콘텐츠 요청부터 첫 프레임까지의 시간(프리롤 광고 제외)
• rebufferingRatio 속성 추가: 재버퍼링에 소요된 재생 시간 비율
• totalRebufferingTime 속성 추가됨: 버퍼 상태의 총 밀리초
• totalPlaytime 속성 추가: 밀리초 단위의 총 콘텐츠 재생 시간
• hadStartupError 속성 추가: 콘텐츠 시작 전에 시작이 실패했는지 여부를 나타내는 부울
• hadPlaybackError 속성 추가: 세션 중 재생 오류가 발생했는지 여부를 나타내는 부울
• QoE 추적을 활성화하기 위해 nrActivateQoeTracking(nr) 을(를) 추가했습니다(기본적으로 비활성화됨)
• 이벤트 빈도를 구성하기 위해 nrSetQoeAggregateIntervalMultiplier(nr, multiplier) 을(를) 추가했습니다.

업데이트

• QoE 이벤트를 하베스트 주기와 동기화
• 지능형 중복 제거를 통해 중복 이벤트를 방지했습니다.
• 세션별 메트릭 격리 및 정리 구현
• 정확도를 위해 시간 가중 비트레이트 계산을 구현했습니다.
• 광고 시간을 제외한 스마트 시작 시간 계산을 구현했습니다.
• 기본적으로 QoE 추적 비활성화, 하베스트 배수를 1(매 하베스트 주기)로 설정

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.