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

Nouvelles fonctionnalités

• Ajout de la prise en charge native de l’insertion publicitaire côté serveur AWS Elemental MediaTailor via l’adaptateur RAFX_SSAI awsemt de Roku
• Ajout de l'enregistrement automatique de VideoAdAction pour les événements du cycle de vie des publicités MediaTailor : AD_BREAK_START, AD_REQUEST, AD_START, AD_QUARTILE, AD_END, AD_BREAK_END et AD_ERROR
• Ajout de nrEnableMediaTailorTracking(nr, adIface) pour enregistrer les écouteurs New Relic sur un adaptateur RAFX_SSAI en un seul appel
• Ajout de nrSetMediaTailorAdMetadata(tracker, metadata) pour injecter des métadonnées valeur clé sidecar dans les événements VideoAdAction
• Ajout de nrSendVideoAdEvent(nr, actionName, attr) pour l'enregistrement direct de VideoAdAction depuis n'importe quel tracker
• Ajout de la tâche de référence MediaTailorTask.brs et de l'exemple VideoScene.brs démontrant le modèle d'intégration recommandé

Mise à jour

• Créé MediaTailorTracker dans le thread de la scène et transmis à la tâche via un champ de nœud pour la compatibilité de l'écouteur RAFX
• Session initialisée via RAFX_SSAI.requestStream(); URL du manifeste assemblé assignée depuis getStreamInfo().manifest_url au nœud Video
• Ajout de l'observation du champ position du nœud vidéo dans la boucle d'événements de la tâche pour la résolution du minutage des coupures publicitaires
• Définir la prise en charge de MediaTailor comme opt-in ; s'active uniquement lorsque nrEnableMediaTailorTracking est appelé

Débogage

• Correction des événements du cycle de vie des annonces Google IMA (AD_BREAK_START, AD_BREAK_END, AD_START, AD_END, AD_QUARTILE, AD_ERROR) pour produire correctement VideoAdAction au lieu 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)

Nouvelles fonctionnalités

• Ajout d'analyses QoE pour un suivi complet de la qualité vidéo avec des métriques de performance avancées
• Ajout de l'attribut averageBitrate : débit binaire moyen pondéré dans le temps sur l'ensemble de la lecture
• Attribut peakBitrate ajouté : débit binaire le plus élevé atteint pendant la lecture
• Ajout de l'attribut startupTime : délai entre la requête de contenu et la première image (hors publicités pré-roll)
• Ajout de l'attribut rebufferingRatio : pourcentage du temps de lecture consacré au rebuffering
• Ajout de l'attribut totalRebufferingTime : total des millisecondes dans les états de mémoire tampon
• Attribut totalPlaytime ajouté : temps total de lecture du contenu en millisecondes
• Ajout de l'attribut hadStartupError : booléen indiquant si le démarrage a échoué avant le début du contenu
• Ajout de l'attribut hadPlaybackError : booléen indiquant si des erreurs de lecture se sont produites pendant la session
• Ajout de nrActivateQoeTracking(nr) pour activer le suivi de la QoE (désactivé par défaut)
• Ajout de nrSetQoeAggregateIntervalMultiplier(nr, multiplier) pour configurer la fréquence des événements

Mise à jour

• Événements QoE synchronisés avec les cycles de collecte
• Événements redondants évités grâce à la duplication intelligente
• Implémentation de l'isolation et du nettoyage des métriques par session
• Implémentation des calculs de débit binaire pondérés dans le temps pour plus de précision
• Implémentation du calcul intelligent du temps de démarrage excluant le temps de publicité
• Suivi de la QoE désactivé par défaut ; multiplicateur de collecte défini sur 1 (chaque cycle de collecte)

Bug fix

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

Débogage

• Évitez d'ajouter appId depuis dataToken.
• Correction de 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

Bug fix

• Renamed errorName with errorMessage as errorName has been deprecated.