Streaming Video & Ads for Mobile release notes

Streaming Video & Ads for Mobile v3.0.0

Thu, 06 Mar 2025 00:00:00 +0000

New features and 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.

Deprecations

MobileVideo
- The MobileVideo 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 and actions required

Transition from PageAction: Users currently tracking PageAction 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.

Streaming Video & Ads for Mobile v3.0.1

Thu, 06 Mar 2025 00:00:00 +0000

Bug fixes

Added method to set, userId for ads

Streaming Video & Ads for Mobile v3.0.2

Fri, 02 May 2025 00:00:00 +0000

Bug fixes

Added ErrorCode and ErrorName as new attributes

Streaming Video & Ads for Mobile v3.0.3

Wed, 09 Jul 2025 00:00:00 +0000

Update

Improved calculation logic for contentBitrate

Bug fixes

Fixed the totalPlayTime attribute

Streaming Video & Ads for Mobile v4.0.0

Fri, 01 Aug 2025 00:00:00 +0000

Update

Introduced Android Video Agent with Self-Harvesting Capabilities

Streaming Video & Ads for Mobile v4.0.1

Mon, 15 Sep 2025 00:00:00 +0000

Update

Enriched custom event with attributes like content*, view*, timeSince*

Streaming Video & Ads for Mobile v4.0.3

Fri, 28 Nov 2025 00:00:00 +0000

Update

Fixed CONTENT_DROPPED_FRAMES event volume issue

It does not include any code changes, It fixes the version inconsistency

Streaming Video & Ads for Mobile v4.0.2

Thu, 27 Nov 2025 00:00:00 +0000

Update

Fixed CONTENT_DROPPED_FRAMES event volume issue

Streaming Video & Ads for Mobile v4.0.4

Thu, 18 Dec 2025 00:00:00 +0000

Bug fixes

Build issues codeql (#70) (32f4438)
updated sample app's custom attribute (9054208)

Streaming Video & Ads for Mobile v4.0.5

Tue, 20 Jan 2026 00:00:00 +0000

Bug fixes

Replace bitrate calculation to use video quality instead of download speed (b676954)
Update media3 from 1.1.0 to 1.2.0 for Android 14 compatibility (320d92b)

Streaming Video & Ads for Mobile v4.0.6

Tue, 10 Feb 2026 00:00:00 +0000

Bug fixes

Regional collector URLs, drop bitrate attributes before start, HEARTBEAT timing, and build fixes (e717dda)

Streaming Video & Ads for Mobile v4.1.0

Tue, 31 Mar 2026 00:00:00 +0000

New features

Added beta release workflow for JitPack from the stable-beta branch (6317416) (94475c6)
Updated beta release workflow (aa77e9e) (131dd23)

Update

Added bitrate (7bb2d07)
Renamed QoE playback failure attributes to error (825779c)
Used getActualBitrate function (ba7b922)

Bug fixes

Fixed regional collector URLs (ac2811b)
Fixed staging credentials (7187413)
Reverted use of getOrDefault (5cb62a6)
Triggered HEARTBEAT at elapsed time 0 (fb40db3)

Streaming Video & Ads for Mobile v4.1.1

Wed, 22 Apr 2026 00:00:00 +0000

New features

Added obfuscation rules (f756c78)
Added qoeHarvestCycle (aa4940c) (0218d31)
Added timeSinceRequested, timeSinceStarted to QoE event payload (1f627cf)
Added QoeProvider (ed48dee)

Update

Changed QoE architecture (7913826)
Updated bitrate name (928d3af)
Updated function name (42a842e)
Updated name to contentSegmentDownloadBitrate and contentNetworkDownloadBitrate (e1a3dc9)
Updated calculation of startup time and average bitrate (371da00)
Updated harvestCycle to AtomicInteger (0d550d2)
Updated condition for sending QoE events (f307de9)

Bug fixes

Added fallback for ad bitrate (3077faa)
Added final QoE event at content end (f151a21)
Implemented thread-safe QoE generation and real-time totalPlaytime calculation (e53e6f7)
Implemented thread-safe QoE generation using attribute caching (43d21cd)
Implemented thread-safe QoE with real-time metrics and immediate final QoE (a506f66)

Streaming Video & Ads for Mobile v4.3.1

Mon, 13 Jul 2026 00:00:00 +0000

4.3.1 (2026-07-13)

Bug Fixes

Fixed an issue where CSAI preroll operations inadvertently dropped CONTENT_START events. (948f229)

Streaming Video & Ads for Mobile v4.2.0

Thu, 21 May 2026 00:00:00 +0000

New features

Added the AWS MediaTailor server-side ad insertion (SSAI) tracker for DASH and HLS streams. (caf8f7c)

Bug fixes

Removed trust-all SSL bypass in MediaTailor sample (92ad555)

Streaming Video & Ads for Mobile v4.5.0

Mon, 31 Aug 2026 00:00:00 +0000

Features

sample-app: show a LIVE badge instead of a countdown for live streams
sample-app: support direct manifest URL playback and mock-server testing

Bug Fixes

exoplayer: report contentIsLive and omit contentDuration for live streams
mediatailor: append newly-reported ads when a tracking-built avail grows (fd2b5fd), closes #2 #3
mediatailor: centralise trailing-segment sessionId extraction
mediatailor: classify how the tracking endpoint was resolved
mediatailor: correct DASH cue offset and give HLS breaks a stable id
mediatailor: derive tracking URL from implicit-session DASH playlist path
mediatailor: derive tracking URL from implicit-session HLS playlist path
mediatailor: describe pending implicit-session tracking URL as deferral
mediatailor: emit AD_ERROR when tracking fetch fails silently
mediatailor: expose creativeId-first primary key for per-ad metrics
mediatailor: harden schedule merge against zombie breaks and pod drift
mediatailor: keep manifest pod boundaries when tracking ad count disagrees
mediatailor: let EXT-X-DATERANGE override an earlier trackingUrl guess
mediatailor: make playhead poll interval configurable at construction
mediatailor: match growing-avail ads by start time when adId is absent
mediatailor: match manifest breaks by id, gate MISSING_AVAIL_START once
mediatailor: paginate NextToken within one poll instead of across polls
mediatailor: parse tracking-event beacons with ad-start-relative timing
mediatailor: pod endTimeMs must not exceed its enclosing break
mediatailor: prune viewed avails from the live schedule
mediatailor: read HLS tracking URL from EXT-X-DATERANGE when advertised
mediatailor: rename segmentPrefix to canonical adSegmentPrefix
mediatailor: require unanimous representation agreement for DASH ad periods
mediatailor: revert tracking requests from POST back to GET
mediatailor: round-trip NextToken across tracking polls
mediatailor: stabilise avail identity across live window rotations
mediatailor: surface avails missing startTimeInSeconds as an error
mediatailor: surface pods appended after the playhead left their window
mediatailor: treat empty avails as no-fill instead of firing AD_START

Streaming Video & Ads for Mobile v4.4.0

Tue, 04 Aug 2026 00:00:00 +0000

New features

Added JP region support. (e97c6ca)

Bug fixes

Aligned totalPauseTime with the iOS clock model and stopped emitting totalTimeSwitchedDown. (924c7b9)
Classified startup and playback errors by content-started state, for iOS parity. (a6b3288)
Corrected CONTENT_DROPPED_FRAMES event fields and fixed the underlying ANR root cause. (a5afc73)
Deduplicated consecutive identical download-rate samples. (e9b6d1f)
Emitted a fresh totalPlaytime value in QOE_AGGREGATE. (af065d6)
Excluded only ad time from startupTime, for iOS parity. (9321ac8)
Recorded the final QoE event into the crash-safe buffer at CONTENT_END. (e1d3ae1)
Removed an unused classpath. (f729768)
Removed an unused dependency. (0bdd95b)
Removed an unused plugin. (fa11838)
Replaced the global harvestCycleNumber gate with a per-tracker gate. (9e19faf)
Updated a variable name. (72de035)
Updated the allowlist for QOE_AGGREGATE context attributes, for iOS parity. (dd1d3ef)
Updated the bitrate timer to use the isPlaying transition. (011ade3)

Streaming Video & Ads for Mobile v3.0.0

Mon, 03 Mar 2025 00:00:00 +0000

New features and 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.

Deprecations

MobileVideo
- The MobileVideo 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. Event Types • VideoAction: Events triggered by general video interactions, such as starting, pausing, or seeking. • VideoAdAction: Events related to ad playback, such as starting, completing, or skipping an ad. • VideoErrorAction: Events triggered by errors encountered during video or ad playback. • VideoCustomAction: Custom events defined to capture specific actions or interactions beyond default event types.

Impact and actions required

Transition from MobileVideo: Users currently tracking MobileVideo events should adapt their implementations to utilise 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

Streaming Video & Ads for Mobile v3.0.1

Wed, 23 Apr 2025 00:00:00 +0000

Minor changes

The errorName attribute has been renamed to errorMessage.

Streaming Video & Ads for Mobile v4.0.0

Mon, 13 Oct 2025 00:00:00 +0000

Major features

Standalone agent with advanced harvest logic

Introduced standalone initialization with advanced harvest logic for improved event processing
Added multi-task harvest scheduler for efficient data collection and transmission
Implemented priority-based event buffering system
New optimized HTTP client with enhanced networking capabilities

Enhanced event management

New crash-safe event buffer with persistent storage
Integrated dead letter handler for failed event recovery
Priority event buffer for critical events
Default size estimator for optimized memory usage

Swift support

Updated iOS agent with Swift code support
Added Swift example implementation (PiPExampleSwift)
Improved Swift interoperability

Architecture changes

Pod restructuring

Breaking Change: Renamed NewRelicVideoCore to NewRelicVideoAgent
Updated pod specifications and dependencies
Streamlined component factory pattern

New core components

NRVAVideo - Main video agent interface
NRVAVideoConfiguration - Centralized configuration management
NRVATokenManager - Enhanced authentication handling
NRVAHarvestManager - Centralized harvest orchestration
NRVAVideoLifecycleObserver - Video lifecycle management
NRVADeviceInformation - Device information collection
NRVAErrorExceptionHandler - Centralized error handling

Storage & persistence

New offline storage capabilities with crash recovery
Crash-safe harvest factory for reliable data persistence
Integrated dead letter handling for failed events

Breaking changes

Pod name change: NewRelicVideoCore has been renamed to NewRelicVideoAgent
- Update your podfile: pod NewRelicVideoAgent
Initialization changes: New standalone initialization pattern with configuration objects
API changes: Some internal APIs have been refactored for the standalone architecture

Streaming Video & Ads for Mobile v4.0.1

Tue, 25 Nov 2025 00:00:00 +0000

Changes

Fixed concurrent access crash in NRTimeSinceTable
Fixed inaccurate totalPlayTime

Streaming Video & Ads for Mobile v4.0.2

Mon, 12 Jan 2026 00:00:00 +0000

Bug fixes

Corrected Log attribute spelling (0b90490)

Streaming Video & Ads for Mobile v4.0.3

Tue, 20 Jan 2026 00:00:00 +0000

Whats changed

iOS fix contentBitrate to report actual video quality in #169
chore(release): 4.0.3 by @github-actions[bot] in #175

Streaming Video & Ads for Mobile v4.0.4

Mon, 02 Feb 2026 00:00:00 +0000

Published to CocoaPods:

NewRelicVideoAgent 4.0.4
NRAVPlayerTracker 4.0.4
NRIMATracker 4.0.4

What's changed

Bug fixes

Staging token issue (04956d5)

Streaming Video & Ads for Mobile v4.1.0

Tue, 31 Mar 2026 00:00:00 +0000

Published to CocoaPods

NewRelicVideoAgent 4.1.0
NRAVPlayerTracker 4.1.0
NRIMATracker 4.1.0

New features

Added QoE aggregation system and fixed critical timing/playtime bugs (aa761f8)

Bug fixes

Improved error handling and retry logic in CocoaPods publish workflow (00e4e46)

Streaming Video & Ads for Mobile v4.0.5

Tue, 17 Feb 2026 00:00:00 +0000

Published to CocoaPods

NewRelicVideoAgent 4.0.5
NRAVPlayerTracker 4.0.5
NRIMATracker 4.0.5

Changes

Drop bitrate attributes before start event (ad4f9ba)
IMA tracker null ad attributes in AD_HEARTBEAT and bitrate unit mismatch (e51b109)

Streaming Video & Ads for Mobile v4.1.3

Thu, 21 May 2026 00:00:00 +0000

Published to CocoaPods

NewRelicVideoAgent 4.1.3
NRAVPlayerTracker 4.1.3
NRIMATracker 4.1.3

Streaming Video & Ads for Mobile v4.1.1

Wed, 22 Apr 2026 00:00:00 +0000

Published to CocoaPods

NewRelicVideoAgent 4.1.1
NRAVPlayerTracker 4.1.1
NRIMATracker 4.1.1

Bug fixes

Add obfuscation rules support (2734ca7)
New bitrate metrics added (61cc6d1)

Streaming Video & Ads for Mobile v4.1.2

Wed, 20 May 2026 00:00:00 +0000

Published to CocoaPods

NewRelicVideoAgent 4.1.2
NRAVPlayerTracker 4.1.2
NRIMATracker 4.1.2

Streaming Video & Ads for Mobile v4.1.4

Fri, 05 Jun 2026 00:00:00 +0000

Published to CocoaPods

NewRelicVideoAgent 4.1.4
NRAVPlayerTracker 4.1.4
NRIMATracker 4.1.4

Bug fixes

Exposed sendSeekStart/sendSeekEnd on NRVAVideo; auto-detected seek in AVPlayerTracker (34493b4)
Fixed NRTrackerPair leaking NSNull sentinel to callers (82ef94f)
Implemented partial container sanitization, nil guard, and dead code removal (6aac79f)
Read totalPreRollAdTime from CONTENT_START attributes (d565378)
Sanitized attribute values at setAttribute storage boundary (7d07298)

Streaming Video & Ads for Mobile v4.3.0

Tue, 04 Aug 2026 00:00:00 +0000

Published to CocoaPods

NewRelicVideoAgent 4.3.0
NRAVPlayerTracker 4.3.0
NRIMATracker 4.3.0

New features

Added JP region support. (2acc442)
Added new QOE attributes. (7b06033)

Bug fixes

Fixed ad-break time inflating totalPauseTime. (7c41112)
Corrected rendition KPIs across views in multi-video sessions. (bd7d6c9)
Fixed multiple device UUIDs per viewId. (790c7e6)

Streaming Video & Ads for Mobile v4.4.0

Thu, 03 Sep 2026 00:00:00 +0000

New features

Added support for Swift Package Manager.
NRMediaTailorTracker: Added a new AWS MediaTailor server-side ad-insertion (SSAI) tracker for AVPlayer (iOS 12+ and tvOS 12+), offering feature parity with NRIMATracker.

Bug Fixes

ios-publish: Modified retry logic to survive partial pipeline failures.