Streaming Video & Ads for others release notesRSS

Fix

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

Réparer

• Évitez d'ajouter appId depuis dataToken.
• Corrigez nrSendErrorEvent pour envoyer des données correctes.

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

Nouvelle fonctionnalité

Analyse de la chronologie des erreurs publicitaires

• Ajout d'un suivi complet des modèles de récupération d'erreurs publicitaires pour améliorer les analyses de publicité vidéo.

Ce qui a changé

Nouvel attribut de chronométrage

• timeSinceLastAdError: Suit le temps écoulé depuis la dernière erreur publicitaire
  • Disponible uniquement pour le type d'événement VideoAdAction
• Fournit des informations sur les schémas d'erreurs publicitaires et les délais de rétablissement
• Aide à optimiser les stratégies de gestion des erreurs publicitaires

Détails de l'implémentation

• Fonction nrTrackRAF() améliorée avec suivi de l'horodatage des erreurs
• Ajout d'une logique d'attribut conditionnel dans la fonction nrAddRAFAttributes()
• Mise en place d'une gestion robuste des états d'erreur pour un chronométrage précis

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.

Fix

• Renamed errorName with errorMessage as errorName has been deprecated.

Réparer

• Renommer errorName avec errorMessage en errorName est obsolète.

Mis à jour

• Ajout de l'attribut contentBitrate aux événements vidéo. Ceci utilise segmentationBitrate si disponible, et se rabat sur streamBitrate si nécessaire.
• Ajout de l'attribut adBitrate aux événements publicitaires. Le débit binaire de la publicité est désormais extrait à l'aide de plusieurs méthodes et est normalisé en bps (bits par seconde).
• Ajout de l'attribut timeSinceLastError aux événements d'erreur, indiquant le temps écoulé depuis l'événement d'erreur précédent.

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.