Tealium for Android (Kotlin) release notes

For a complete list of changes to Tealium for Android (Kotlin), see the GitHub change log.

1.5.5 (September 2023)

• BugFix: ProGuard adjustment resolve missing BatchDispatch$Companion class.
• Minor lint warning fixes

1.5.4 (August 2023)

• Core 1.5.4
  • Session Data Expiration BugFix: fixes an issue whereby session scoped data may not be expired on launch
  • Event Router events Buffering: buffers events until sdk is ready so events are not missed during startup
  • Database Lock crash BugFix: Some uncaught exceptions in persistence led to possible crashes
  • ProGuard rules updates to reinstate incorrectly obfuscated BatchDispatch class
• AdIdentifier 1.1.2
  • BugFix: DataLayer writes moved onto Tealium background thread

1.5.3 (June 2023)

• Database BugFix: add database status check before performing writable actions, and allow event queuing until database is fully operational
• Library Settings BugFix: update how remote settings were fetched and saved
• Module Manager BugFix: update to thread-safe collection

1.5.2 (April 2023)

• Connectivity Collector BugFix:
  • Fixes an issue in the event where there is a blank string returned from telephonyManager.networkOperator
• Deep Link Reporting BugFix:
  • Deep Link handling limited to Activities launched with Intents where action == Intent.ACTION_VIEW
  • Empty Uris are ignored, and deep links that match what is already stored is a no*op
  • Handling pushed onto Tealium background thread.

1.5.1 (October 2022)

• Bug fix - Fixed an issue where events arrived at dispatchers in the incorrect order

1.5.0 (October 2022)

• Visitor Switching
  • Added TealiumConfig.visitorIdentityKey to specify the data layer key that represents a known identity in the data layer
  • Known identities are hashed and linked to the tealium_visitor_id for better switching between known identities
• Added the following listeners:
  • VisitorIdUpdatedListener - notifies when the visitor ID is updated as a result of switching identities or resetting the visitor ID
  • DataLayerUpdatedListener - listens for updates to key/value pairs in the data layer
  • onDataUpdated(String, Any) - notifies when a value is updated in the data layer
  • onDataRemoved(Set<String>) - notifies when the specified key is removed from the data layer by user interaction or data expiration
• RemoteCommandDispatcher 1.2.0
  • Support for default mapping all_events and all_views in the JSON mapping file to enable triggering specific commands in response to each view or event
• TagManagement 1.2.0
  • QueryParameterProvider - to add additional parameters to the URL for the Tag Management module
  • Improved webview instantiation and page load management
• Kotlin Dependency updates
  • Stdlib: 1.6.21
  • Coroutines: 1.6.2

1.4.3 (September 2022)

• Core 1.4.3
  • DeviceCollector bug fix - Correct calculation for tealium_logical_resolution
• TagManagement 1.1.3
  • Bug fix - Relocate sessionCountingEnabled to fix miscount on fresh launch
• VisitorService 1.1.1
  • Bug fix - Move Visitor service profile override to earlier initialization
• Location: Add missing Proguard rules for new classes

1.4.2 (June 2022)

• Core 1.4.2
  • Added overrideConsentCategoriesKey to TealiumConfig to add a custom consent categories key

1.4.1 (June 2022)

• Core 1.4.1
  • Bug fix - Update consent status to return string instead of enum value

1.4.0 (May 2022)

• Core 1.4.0
  • Added gatherTrackData to expose all data layer and collector variables

1.3.3 (April 2022)

• Core 1.3.3
  • Update remote command dependency
• RemoteCommandDispatcher 1.1.1
  • Added remote command names and versions to data layer

1.3.2 (March 2022)

• Core 1.3.2
  • Added events property to TealiumConfig to add listeners at startup. This fixes the issue of missed events at startup.
• Lifecycle 1.1.1
  • Bug fix - Fixed the default values for some attributes that caused missed events when combined with the Tag Management module
• InAppPurchase 1.0.1
  • Additional purchase_date key provided in ISO-8601 format
• Tag Management 1.1.2
  • Added the sessionCountingEnabled flag to TealiumConfig to disable session counting for Tealium iQ accounts that use self-hosted JavaScript files.

1.3.1 (February 2022)

• Core 1.3.1
  • Stability fix for failed webview creation
  • Stability fix for connectivity exception handling
  • In App Purchase auto tracking 1.0.0 release.

1.3.0 (October 2021)

• Core 1.3.0
  • Missing variables reinstated from the Java library:
    • Default: tealium_random and was_queued
    • DeviceCollector - device_battery_percent and device_ischarging
    • TimeCollector - timestamp_epoch
  • DataLayer performance improvements, and additional support for storing JSONArray objects
  • Dates now get formatted as ISO 8601 as standard
  • Dependency updates to Kotlin, Coroutines, Android Target Version, AGP 7, Java 11, MockK, Robolectric
  • BugFixes:
    • Opaque URI’s are now appropriately handled by the DeepLinkHandler
  • Deprecations to unused code
• AutoTracking 1.0.0
  • New activity tracking module to automatically track screen view events
• AdIdentifier 1.1.0
  • Support for new AppSet identifier
  • Dependency Updates in line with Core.
• CollectDispatcher 1.1.0, TagManagementDispatcher 1.1.0
  • Serialization standardized to use JsonUtils
  • Dependency Updates in line with Core.
• CrashReporter 1.1.0, HostedDataLayer 1.1.0, InstallReferrer 1.1.0, Lifecycle 1.1.0, Location 1.1.0, Media 1.1.0, RemoteCommandDispatcher 1.1.0
  • Dependency Updates in line with Core.
• VisitorService 1.1.0
  • Additional configuration option to override the Tealium Profile name to use when updating a Visitor: config.overrideVisitorServiceProfile
  • Serialization/Deserialization performance improvements
  • Dependency Updates in line with Core.
  • BugFix:
    • Date parsing exception when dates are 0

1.2.8 (October 2021)

• Core 1.2.8
  • Added TealiumConfig.logLevel to enable overriding the log level derived from the environment.
  • Added consent_last_updated timestamp to the payload of each event triggered by the Consent Manager.
  • Payload key constants migrated to Dispatch.Keys.XXX for ease of access.
  • Bug Fixes
    • app_name now falls back to a non-localized version of the app label.
    • Fixed event router crashes caused by threading.
    • screen_title re-added to the TealiumView payload by default, and set to the viewName when one is not provided in the context data
    • Unnecessary logging removed when trying to load tealium-settings.json as an Asset.
    • Where multiple deep links occur during a session, previous deep link parameters are now removed from the data layer prior to adding the new ones.
• CollectDispatcher 1.0.6, HostedDataLayer 1.0.4, RemoteCommandDispatcher 1.0.5, TagManagement 1.0.7
  • Event key references updated to use the new Dispatch.Keys.XXX (only present in Core 1.2.8+).

1.2.7 (September 2021)

• Core 1.2.7
  • Added device_logical_resolution to the data layer from the DeviceData module.

1.2.6 (July 2021)

• Core 1.2.6
  • Added TealiumConfig.existingVisitorId to support using your own unique identifier.
  • Added TealiumConfig.consentManagerLoggingProfile to support to overriding the profile for Consent Logging.
  • Consent Logging event routed through all enabled Dispatchers.
  • Updated values for data layer variables app_build and app_version.
• Tag Management Dispatcher 1.0.6
  • Support for Consent Logging profile override.
• Collect Dispatcher 1.0.5
  • Support for Consent Logging profile override.
• Visitor Service 1.0.5
  • Bug fix: deserializing stored long values.

1.2.5 (May 2021)

• Fixed issues with HttpClient and consent logging failures.
• Improved asynchronous performance by moving HttpClient execution onto the IO dispatcher.

1.2.4 (April 2021)

• Core 1.2.4

  • Added new data layer variables enabled_modules and enabled_modules_versions. Both are arrays of strings, containing a sorted list of modules in use and their version number - latest versions of all modules required to retrieve their version.

  module names have also been changed from “UPPER_SNAKE_CASE” to “PascalCase” to match Swift.

  • New config option remoteApiEnabled to permit disabling of remote_api events when using the RemoteCommands and TagManagement modules.
  • New config option overrideCollectProfile to permit overriding the value of tealium_profile in the event payload, routing events to a different Tealium profile to the one set on the TealiumConfig object.
  • Bug fix: Added support for both application/json and x-www-form-urlencoded content types when using the HttpRemoteCommand.
  • Bug fix: Fixed an issue with specific collections not being encoded correctly.

1.2.3 (March 2021)

• Core 1.2.3
  • Consent Management: Added option for setting a custom consent policy.
  • Add new device_language, os_name to DeviceCollector module.
• Crash Reporter 1.0.2
  • Updated keys for CrashReporter module: crash_exception_name changed to crash_name, crash_exception_cause changed to crash_cause.

1.2.2 (March 2021)

• Core 1.2.2
  • Added request_uuid to event and view payload
• TagManagement Dispatcher 1.0.4, RemoteCommand Dispatcher 1.0.3
  • Bug fix: Routed HttpRemoteCommand to background thread for execution

1.2.1 (March 2021)

• ProGuard and Consumer Rules revision; added missing public classes, and the consumer rules have been revised
• Core 1.2.1, Collect Dispatcher 1.0.3, TagManagement Dispatcher 1.0.3, Install Referrer 1.0.2, Lifecycle 1.0.3, Location 1.0.3, VisitorService 1.0.3, RemoteCommand Dispatcher 1.0.2, Hosted DataLayer 1.0.2, Crash Reporter 1.0.1, Ad Identifier 1.0.1

1.2.0 (January 2021)

• Consent Management
  • Consent Expiration: Introduced the ability to set an expiration for provided consent
  • Deprecated consentManagerEnabled config property; setting a valid ConsentPolicy automatically enabled the Consent Manager
  • Bug fix: Incorrect consent collector logic
• Visitor ID: New method manually regenerates a Visitor ID for the device
  • ProGuard: Initial ProGuard rules added to generated binaries and consumer ProGuard rules
• AdIdentifier 1.0.0
  • Initial release of the AdIdentifier module: if available, AdIdentifier is added to each Dispatch
• CrashReporter 1.0.0
  • Initial release of the CrashReporter module: uncaught exceptions causing a crash are recorded and any crash data is sent on the next dispatch when the app launches again
• Collect Dispatcher 1.0.2, Hosted DataLayer 1.0.1, InstallReferrer 1.0.1, Lifecycle 1.0.2, Location 1.0.2, RemoteCommand Dispatcher 1.0.1, TagManagement Dispatcher 1.0.1, Visitor Service 1.0.2
  • ProGuard - Initial ProGuard rules added to generated binaries and consumer ProGuard rules

1.1.0 (November 2020)

• Timed Events support for reporting the time taken between user events of interest
• New device_model and device_manufacturer data keys provided by the DeviceCollector
• Automated unit and instrumented tests for PRs into master using Github Actions
• Collect Dispatcher 1.0.1
  • Additional Collect URL overrides
  • Test coverage increase
• Hosted Datalayer 1.0.0
  • Test coverage increase
• Lifecycle 1.0.1
  • Bug fix: Missing autotracked key on sleep events
  • Test coverage increase
  • Location 1.0.1
  • Bug fix: Issue with automatically adding nearby geofences
  • Test coverage increase
• Visitor Service 1.0.1
  • Non-breaking change for testability purposes
  • Test coverage increase

0.1.2 (October 2020)

• Support for multiple instances of Tealium
  • Breaking changes introduced for construction of Tealium instances
• Fix: Connectivity issues on older Android versions

0.1.1 (September 2020)

• Maven dependency fix
• Additional Dispatch payload logging

0.1.0 (July 2020)

• Initial release
• Tealium Tag Management support
• Collect support