Version 4.1.0

4.1.0 (2024-11-28)

This release adds a new appVersion configuration option to the newTracker call that will track the application version in a context entity along with all events.

It also adds the button element as a parameter in the callback function in the button click tracking plugin. Thanks to @irenehakes for the contribution!

Enhancements

• Add appVersion configuration option to track a context entity with the application version (#1373)
• Pass clicked element to dynamic context functions for button click tracking plugin (#1368) thanks to @irenehakes

Version 4.0.4

4.0.4 (2024-11-21)

Bug fixes

• Fix multiple link click events tracked for a single tracker in case multiple trackers are initialized on the page (close #1384)

Version 4.0.3

4.0.3 (2024-11-20)

This release fixes an issue introduced in the v4 tracker release that caused multiple simultaneous sessions being started if a page was opened in multiple tabs/windows at once.

Bug fixes

• Serialize new session cookie synchronously to avoid overlapping sessions (#1381)

Version 4.0.2

4.0.2 (2024-11-11)

This release fixes a bug that caused the postPath configuration option to be ignored when making requests to the collector. It also fixes a bug in the media tracking plugin which didn't add the configured label to media events.

In the tag-based JavaScript tracker, we added a new contexts.performanceNavigationTiming option to enable/disable the performance navigation timing context entity. Since the option was previously missing, the context was added to all events. Now the context is disabled by default.

Bug fixes

• Fix ignored label property in the startHtml5MediaTracking call (#1378)
• Fix postPath configuration being ignored (close #1376)
• Add option to disable performanceNavigationTiming plugin (#1375)

Version 4.0.1

4.0.1 (2024-11-01)

This patch release fixes an issue in the HTML5 media tracking plugin in that it didn't correctly initialize and failed to track events.

Bug fixes

• Fix initialization of the HTML5 media tracking plugin so that it initializes the parent media plugin (#1369)

Under the hood

• Fix broken API docs generation by adding explicit type for EventStoreIteratorNextResult (#1367)

Version 4.0.0

4.0.0 (2024-10-28)

The release adopts the fetch API for making requests to the Snowplow collector which provides the keepalive option that enables requests to outlive the webpage they were made from.

Performance of the track calls has been improved by making cookie writes async. Our benchmarks show this improves the time it takes to track 100 events to a third of what it was in v3.

The tracker APIs have been significantly improved and simplified:

• Form and link click tracking now support event delegation and don’t require the app to refresh the tracking after page changes.
• It’s now easier to manage global context using named tags.
• Plugins add a new filter function to enable skipping events.
• The tracker API on Node.JS has been significantly revised and streamlined also thanks to the use of the fetch API.

Other changes include the YouTube and HTML5 media plugins adopting new media schemas, upgrades to the UUID package, revised defaults, and removal and deprecation of older plugins.

Enhancements

• Use fetch API instead of XMLHttpRequest both in browser and Node trackers and refactor emitter and event store interfaces (#1076)
• Make cookie writes async by default to improve tracker performance (#1340)
• Fix message when a resource triggers errors (#1341)
• Add event delegation for form tracking (#1329)
• Add support for named global context (#1331)
• Add a filter function to plugins to filter out events so that they are not tracked (#1326)
• Add event delegation for link click tracking (#1325)
• Add browser-tracker-core default for os_timezone (#1338)
• Revise Node.js initialization API
• Migrate to v2 Media for HTML5 Plugin (#1344)
• Migrate to v2 Media for YouTube plugin (#1342)
• Support events on buttons/links/forms in ShadowDOMs (#1351)
• Use capture-phase listeners for button click tracking (#1348)
• Switch to GA4 as default for gaCookies plugin (#1349)
• Disable b64 for SDJ data on POST requests from browsers by default (#1352)
• Update discoverRootDomain default behaviour (#1350)

Removed deprecated functionality

• Remove browser-features, optimizely, ecommerce and consent plugins, deprecate enhanced ecommerce and performance timing plugins and add web vitals by default (#1345)
• Revise default plugins included on the JavaScript tracker (#1147)

Upgraded internals

• Update uuid package dependency to version 10.0.0 (#1305)
• Update browser targets for compilation (#1131, #1132)
• Update Node.js to v14 (#1129, #1130)

Other improvements and fixes

• Change default tracker initialization parameters for JS/Browser v4 (#1144)
• Fix SelfDescribingJson type to allow optional keys in type parameter (#1330)
• Fix newTracker optional typing (#1237)
• Fix newTracker typing to accurately return null or undefined (#1167)
• Read the request response to avoid overlapping requests to collector (#1358)

Version 3.24.6

3.24.6 (2024-10-28)

This release addresses a problem with validation errors for the browser context entity in case browsers reported 0 width and height.

Bug fixes

• Allow 0x0 viewport in browser context to avoid schema validation errors (#1365)

Version 3.24.5

3.24.5 (2024-10-25)

This patch release fixes a problem with removing global context generator functions in case multiple were used.

Bug fixes

• Fix removal of context generator functions (#1361)

Version 4.0.0-beta.4

4.0.0-beta.4 (2024-10-22)

Enhancements

• Read the request response to avoid overlapping requests to collector (#1358)
• Update uuid package dependency to version 10.0.0 (#1305)

Version 4.0.0-beta.3

4.0.0-beta.3 (2024-10-18)

Enhancements

• Enable batching multiple events into a single POST request over buffer size if maxPostBytes setting is followed (#1356)
• Make base64 encoding an optional parameter in Node newTracker call (#1354)