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

Nueva característica

• Se agregó soporte nativo para la inserción de anuncios del lado del servidor de AWS Elemental MediaTailor mediante el adaptador RAFX_SSAI awsemt de Roku
• Se agregó el registro automático de VideoAdAction para los eventos del ciclo de vida de los anuncios de MediaTailor: AD_BREAK_START, AD_REQUEST, AD_START, AD_QUARTILE, AD_END, AD_BREAK_END y AD_ERROR
• Se agregó nrEnableMediaTailorTracking(nr, adIface) para registrar los listeners de New Relic en un adaptador RAFX_SSAI en una sola llamada
• Se agregó nrSetMediaTailorAdMetadata(tracker, metadata) para inyectar metadatos de valor principal de sidecar en los eventos de VideoAdAction
• Se agregó nrSendVideoAdEvent(nr, actionName, attr) para el registro directo de VideoAdAction desde cualquier rastreador
• Se agregó la tarea de referencia MediaTailorTask.brs y el ejemplo VideoScene.brs que demuestran el patrón de integración recomendado

Actualizar

• Se creó MediaTailorTracker en el hilo de la escena y se pasó a la tarea mediante un campo de nodo para la compatibilidad del listener de RAFX
• Sesión inicializada a través de RAFX_SSAI.requestStream(); se asignó la URL del manifiesto ensamblado de getStreamInfo().manifest_url al nodo de video
• Se agregó la observación del campo position del nodo de video en el bucle de eventos de la tarea para la resolución de la temporización de la pausa publicitaria
• Establecer el soporte de MediaTailor como opcional; se activa solo cuando se llama a nrEnableMediaTailorTracking

Corrección de errores

• Se corrigieron los eventos del ciclo de vida de los anuncios de Google IMA (AD_BREAK_START, AD_BREAK_END, AD_START, AD_END, AD_QUARTILE, AD_ERROR) para producir correctamente VideoAdAction en lugar de 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)

Nueva característica

• Se agregaron análisis de QoE para un seguimiento integral de la calidad de video con métricas de rendimiento avanzadas.
• Se agregó el atributo averageBitrate: tasa de bits promedio ponderada en el tiempo durante la reproducción
• Se agregó el atributo peakBitrate: tasa de bits más alta alcanzada durante la reproducción
• Se agregó el atributo startupTime: tiempo desde la solicitud de contenido hasta el primer fotograma (excluye los anuncios pre-roll)
• Se agregó el atributo rebufferingRatio: porcentaje del tiempo de reproducción dedicado al rebuffering
• Se agregó el atributo totalRebufferingTime: total de milisegundos en estados de búfer
• Se agregó el atributo totalPlaytime: tiempo total de reproducción de contenido en milisegundos
• Se agregó el atributo hadStartupError: booleano que indica si el arranque falló antes del inicio del contenido
• Se agregó el atributo hadPlaybackError: booleano que indica si ocurrieron errores de reproducción durante la sesión
• Se agregó nrActivateQoeTracking(nr) para habilitar el seguimiento de QoE (deshabilitado por defecto)
• Se agregó nrSetQoeAggregateIntervalMultiplier(nr, multiplier) para configurar la frecuencia de eventos

Actualizar

• Eventos de QoE sincronizados con ciclos de recolección
• Se evitaron eventos redundantes mediante duplicación inteligente
• Se implementó el aislamiento y la limpieza de métricas por sesión
• Se implementaron cálculos de tasa de bits ponderados por tiempo para mayor precisión.
• Se implementó el cálculo inteligente del tiempo de inicio excluyendo el tiempo de los anuncios
• Seguimiento de QoE desactivado por defecto; multiplicador de recolección establecido en 1 (cada ciclo de recolección)

Bug fix

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

Corrección de errores

• Evite agregar appId de dataToken.
• Se corrigió nrSendErrorEvent para enviar datos correctos.

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

Nueva característica

Analítica de tiempos de errores de anuncios

• Se agregó un seguimiento integral de los patrones de recuperación de errores de anuncios para mejorar las analíticas de publicidad en video.

Qué cambió

Nuevo atributo de temporización

• timeSinceLastAdError: Rastrea el tiempo transcurrido desde que ocurrió el último error de anuncio
  • Disponible solo para el tipo de evento VideoAdAction
• Proporciona información sobre los patrones de errores de anuncios y los tiempos de recuperación
• Ayuda a optimizar las estrategias de manejo de errores de anuncios

Detalles de implementación

• Función nrTrackRAF() mejorada con seguimiento de marcas de tiempo de errores
• Se agregó lógica de atributos condicionales en la función nrAddRAFAttributes()
• Se implementó una gestión robusta de estados de error para una temporización precisa

Bug fix

• Renamed errorName with errorMessage as errorName has been deprecated.