Analytics Collector - Android v1

:warning: This page contains Release Notes for the v1 version (UNSUPPORTED) of the Analytics Collector. You can find the current, v2 release notes here.


1.36.0

Released 2023-01-24

Added

  • Detection of FireOS 8

Changed

  • BitmovinPlayer: Improved ad tracking

Fixed

  • Detection of UHD screens on AndroidTVs

Deprecated

  • v1 Collector for Bitmovin Player

1.35.2

Released 2022-12-22

Changed

  • Increased collected error stacktrace size to 50 lines

1.35.1

Released 2022-11-28

Changed

  • Upgraded Kotlin Version to 1.7.20
  • Updated example apps to reflect latest player changes

Fixed

  • Race Condition during startup when analytics license is not enabled

1.35.0

Released 2022-10-25

Fixed

  • Race condition on HttpRequestTracking feature
  • Stability improvements on HttpRequestTracking feature for ExoPlayer

1.34.0

Released 2022-08-30

Added

  • option to pass progressive URL via progUrl to BitmovinAnalyticsConfig and SourceMetadata

1.33.1

Released 2022-07-06

Fixed

  • fixed issue where late attaching of collector caused videoStartupTime = 0

1.33.0

Released 2022-06-28

Added

  • Add exception message to error_message field of sample for ExoPlayer collector

1.32.0

Released 2022-06-09

Added

  • getUserId to adapter API to retrieve the user ID
  • BitmovinPlayer: if playerKey is not set on BitmovinAnalyticsConfig value from the player is used

Removed

  • Heartbeat interval duration configuration on BitmovinAnalyticsConfig

1.31.1

Released 2022-04-13

Fixed

  • screen size detection for devices with a logical display density != 1

1.31.0

Released 2022-04-11

Deprecated

  • ExoPlayerCollector

1.30.2

Released 2022-04-11

Fixed

  • Wrong transitions from startup state to paused state

1.30.1

Released 2022-03-22

Changed

  • bitmovin player dependency update and internal refactorings
  • improved exception handing on error detail tracking

1.30.1-beta1

Released 2022-02-07

Changed

  • bitmovin player dependency update and internal refactorings

1.30.0

Released 2022-01-24

Added

  • customData fields 26-30

1.29.0

Released 2021-12-15

Added

  • Detection of FireOS devices

1.28.0

Released 2021-11-04

Added

  • version property on Collector classes

1.27.0

Released 2021-10-26

Added
customData fields 8 to 25


1.26.0

Released 2021-09-30

Added

  • Error detail tracking feature
  • castTech field

Removed

  • Unintended public methods from Collector classes

Fixed

  • BitmovinPlayerCollector didn't report some metrics with sub-second granularity
  • ExoPlayerCollector used wrong field to track audioBitrate
  • ExoPlayerCollector reported qualitychange events although the quality did not change

1.25.0

Released 2021-06-21

Added

  • Option to generate randomized userId value

1.24.0

Released 2021-04-27

Changed

  • Support attachment of already playing ExoPlayer to ExoPlayerCollector

1.23.0

Released 2021-04-20

Added

  • setCustomData and setCustomDataOnce

Changed

  • Added default implementation of AnalyticsListener.onPlayerStateChanged to avoid ExoPlayer crashes on certain devices

1.22.1

Released 2021-03-12

Fixed

  • Added upper exclusive bound of 2.12.0 for ExoPlayer dependency

1.22.0

Released 2021-02-01

Added

  • Functionality to retry sending of samples that couldn't be sent due to a HTTP timeout
  • Ability to attach the ExoPlayerCollector to a player that's already in a loading state.

1.21.0

Released 2021-01-10

Added

  • ability to override the mpdUrl and m3u8Url via the analytics configuration

1.20.0

Released 2020-10-27

Added

  • If the video startup fails due to a timeout, we add a ANALYTICS_VIDEOSTART_TIMEOUT_REACHED error to the sample, so it can be easily filtered in the dashboard

Changed

  • We now stop collecting events after the collector encounters a video startup failure

1.19.0

Released 2020-08-31

Changed

  • Calculations for available screen width and height to now include screen density and be more independent of physical pixel
  • Make collectors more resilient to exceptions in event listeners

1.18.0

Released 2020-08-03

Added


1.17.0

Released 2020-06-21

Changed

  • tracking of video startup times when autoplay is enabled in order to be consistent with the web collector

Fixed

  • memory issues with CountDownTimer after player adapter is released

1.16.0

Released 2020-06-21

Changed

  • only send qualitychanged sample when bitrate changed
  • changed player error mapping to improve transparency for Bitmovin Player & ExoPlayer
  • persist DRM information fields drmType in every sample

Fixed

  • crash when onAdError was fired with empty ad tag url

1.15.0

Released 2020-05-24

Added

  • Added errorData to samples in Bitmovin Player

1.14.0

Released 2020-05-10

Added

  • Detection for AndroidTV devices
  • playback start failure metrics to ExoPlayer

Changed

  • Updated support libraries to androidX

Fixed

  • Bug with ever increasing download speed measurements
  • Missing audio codec data for bitmovin player

1.13.0

Released 2020-04-27

Added

  • Added a heartbeat to rebuffering to increase rebuffer accuracy
  • Data downloaded metrics to ExoPlayer

Fixed

  • issue in Exoplayer related to rebuffering during seeks

1.12.1

Released 2020-04-13

Added

  • DRM performance metrics for Bitmovin Player
  • DRM performance metrics for Exoplayer

1.11.3

Released 2020-01-13

Fixed

  • a crash when isLive was not specified in the analytics configuration

1.11.2

Released 2019-12-09

Added

  • BitmovinAnalytics.addDebugListener adds the possibility to listen to debug events

Changed

  • duration measurements now use SystemClock.elapsedRealtime() to be accurate even when the phone's date changes

Fixed

  • empty MPD URL when manifest DASH manifest location is null
  • Very high duration measurement when the phone's date changes.

1.11.1

Released 2019-12-01

Changed

  • PlaybackFinished event will set the videoTimeEnd to videoDuration, as currentTime might not be accurate due to rounding errors

Fixed

  • exoplayer collector crashes when specific exoplayer modules have not been loaded

1.11.0

Released 2019-11-25

Added

  • added customData6 and customData7 to the EventData and AdEventData

Fixed

  • player started state transition before the player was ready
  • pause state activated heartbeat and sent out unnecessary payload

1.10.0

Released 2019-11-10

Added

  • Added Analytics AdAdapter for Bitmovin Player
  • New boolean configuration field called isLive to indicate if the upcoming stream is a live stream. Will be overridden once playback metadata is available.

Known Issues

  • tracking of advertising metrics percentageInViewport and timeInView not possible in Android

1.9.0

Released 2019-10-20

Added

  • Improved collection of runtime errors in ExoPlayer with additional information as well as parts of the Stack Trace being sent in errorData

1.8.0

Released 2019-09-23

Added

  • Tracking of selected audio track language for Bitmovin Player
  • Tracking of selected subtitlte language for Bitmovin Player

1.7.0

Released 2019-09-08

Added

  • Collection of Device Information (Build.MANUFACTURER and Build.MODEL)

1.6.4

Released 2019-08-27

Fixed

  • BitmovinSdkAdapter didn't transition to the pause state on a pause event
  • droppedFrames was not collected

1.6.3

Released 2019-06-12

Fixed

  • Fixed a possible NullPointerException if the licensing backend responded with a malformed message that didn't contain a message

1.6.2

Released 2019-05-12

Changed

  • Exoplayer Collector now reports playerVersion as exoplayer-<SDK-version>
  • Bitmovin Collector now reports playerVersion as bitmovin-<SDK-version>

Fixed

  • Corrected reporting of sources in BitmovinSdkAdapter (fields streamFormat, m3u8Url, mpdUrl, progUrl)

Known Issues

  • Can't get progressive source from Exoplayer

1.6.1

Released 2019-05-07

Changed

  • Exoplayer Collector now reports playerVersion as exoplayer-<SDK-version>
  • Bitmovin Collector now reports playerVersion as bitmovin-<SDK-version>

Fixed

  • videoTimeStart and videoTimeEnd were not set when sending out heartbeats

1.6.0

Released 2019-04-14

Added

  • Tracking for client's supported video codecs

1.5.1

Released 2019-03-10

Fixed

  • In the collector-bitmovin-player, the userAgent contained the player version the collector was compiled against instead of the runtime version

1.5.0

Released 2019-03-10

Added

  • Collecting information about currently playing audio and video codec

Fixed

  • Changed title property in payload to videoTitle
  • In some cases the collector reported the player version it was compiled against, not the version in use (both Exoplayer and Bitmovin Player)

1.4.2

Released 2019-01-06

Added

  • Improved Logging around LicenseCall responses
  • Sequence Number of outgoing Analytics samples
  • platform field in outgoing Analytics samples

1.4.1

Released 2018-09-24

Fixed

  • package structure and naming of maven imports

1.4.0

Released 2018-09-17

Added

  • Added title metadata configuration (human readable variant of videoId)

Changed

  • Seperated Bitmovin Android SDK and ExoPlayer into seperate packages and libraries
  • Bitmovin Player Android SDK Collector: com.bitmovin.analytics:collector-bitmovin-player
  • Exoplayer Collector: com.bitmovin.analytics:collector-exoplayer

1.3.8

Released 2018-08-22

Added

  • Support for Bitmovin Android SDK 2.13.0

1.3.7

Released 2018-08-03

Added

  • Support for Bitmovin Android SDK 2.12.0

1.3.6

Released 2018-07-08

Added

  • Support for Bitmovin Android SDK 2.11.0

1.3.5

Released 2018-07-08

Added

  • Support for Bitmovin Android SDK 2.10.3

1.3.4

Released 2018-06-20

Added

  • Changing of impressionId when a new source is loaded in an existing player instance

1.3.3

Released 2018-06-18

Added

  • Support for Exoplayer 2.8.1
  • Support for Bitmovin Android SKD 2.10.2

Fixed

  • reported video quality switches now use onVideoPlaybackQualityChangedListener

1.3.2

Released 2018-06-15

Added

  • missing error codes to match errors reported by the Web SDK

1.3.1

Released 2018-05-29

Added

  • Support for Exoplayer 2.8.0
  • Support for Bitmovin Android SKD 2.10.0

1.2.0

Released 2018-04-23

Added

  • Support for Exoplayer 2.7.3
  • Support for Bitmovin Android SKD 2.9.0

1.1.0

Released 2018-03-19

Added

  • Exoplayer 2.7.0 support
  • Bitmovin Player Android SDK 2.8.3 support

Changed

  • Cleaned up sample projects
  • Changed package name to com.bitmovin.analytics

1.0.0

Released 2018-03-12

Added

  • Exoplayer support
  • Bitmovin Player Android SDK support