Conviva SDK Migration Benefits

Describes the benefits of migrating from the Conviva SDK 2.x to the simplified 4.x sensor version.

Updated 2026-05-29 migration, benefits, sensor developer center, sensor integration, migration benefits

The Conviva SDK 4.x version is significantly simplified when compared to the Conviva SDK 2.x version. It reduces integration time and effort, and enables solid foundation for future Conviva sensor implementation. Conviva strongly recommends migrating to Conviva SDK 4.x version. Only the Conviva SDK 4.x version will have new features implemented going forward.

The below table describes the benefits of migrating to Conviva SDK 4.x version.

Benefits Category Description
Stateless Integration New Feature Event-driven stateless integration instead of session management.
Faster / Simpler Error Reporting New Feature No need for player state manager or session cleanup. This has reduced error-reporting to one API call.
Ad Break Reporting New Feature SDK takes care of sending custom events, pausing VST during pre-rolls, and detaching player. This has reduced ad break handling to one API call.
Coding Style Improvements Cost of Ownership Cost of owning the platform decreases as less development work is needed to maintain successful integration.
  • Save time and resources reviewing code with 1/3rd fewer lines. (less than 40 total)
  • Improved overall coding style.
  • More developer friendly.
  • Aligned with industry standard best practices for each programming language.
Developer-friendly Syntax Cost of Ownership Streamline workflows with intuitive API naming and improved code readability.
  • adStart() is no longer needed to:
  • Report pin popup shown - Dismiss Conviva session
App-level Events New Feature Simpler handling of use cases. For example, backgrounding:
  • Cleanup is no longer required on backgrounding.
  • No longer necessary to re-create new session on foregrounding.
Ad Integration in Synchronization with Ad-manager Events New Feature Ad sessions are no longer managed like video content for Ad Insights.
  • Aligned with "ad world" event system. (Events for AD LOADED and AD STARTED to be mapped to correspondingly named Conviva APIs.)
Metadata (Platform) New Feature Virtual interface implementation is no longer required to retrieve device specific metadata.
Features New Feature
  • CDN Edge IP detection

  • Stream url, resource, and CwsErrorEvent error message now accept characters till 1024 bytes instead of the earlier 256 bytes.

  • Enhancements in device metadata detection.