Streaming Video & Ads for others release notesRSS

Fix

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

Arreglar

• Evite agregar appId de dataToken.
• Corrija 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

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.

Actualizado

• Se agregó el atributo contentBitrate a los eventos de video. Esto utiliza segmentationBitrate si está disponible y recurre a streamBitrate cuando sea necesario.
• Se agregó el atributo adBitrate a los eventos de anuncios. La tasa de bits del anuncio ahora se extrae utilizando múltiples métodos y se estandariza a bps (bits por segundo).
• Se agregó el atributo timeSinceLastError a los eventos de error, que reporta el tiempo transcurrido desde el evento de error anterior.

Arreglar

• El nombre errorName renombrado con errorMessage como errorName quedó obsoleto.

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.