Version 5.5.0

This release adds an option to disable retrying all failed requests to the collector. The option is called EmitterConfiguration.retryFailedRequests. If configured, events that fail to be sent in the first request to the collector will be dropped. This may be useful in situations where it's necessary to prevent traffic spikes with many events being sent at the same time.

Enhancements
Add option to disable retrying any failed requests (#826)

Under the hood
Separate targets for unit and integration tests (#831)

Version 5.5.0-beta.2

This pre-release updates the 5.5.0 beta on top of the latest 5.4 patch releases.

Version 5.4.2

This release fixes the schema used for the player entity in media events. The URI of the schema was changed due to conflicts with another schema.

Bug fixes
Update vendor and version of the player schema used in media tracking (#812)

Release 5.4.1

This is a patch release that fixes an occasional crash in the StateMachine manager, and ApplicationInstall events sent before updated tracker configuration.

Bug fixes
Add thread-safety to a globalContext manager function (#809)
Fix application_install event sent with wrong configuration (#808)

Version 5.5.0-beta.1

This pre-release adds a new tracker plugin to integrate with the Kantar FocalMeter system by sending the user ID in HTTP GET request to a specified endpoint whenever the ID changes.

Enhancements

• Add configuration to send requests with user ID to a Focal Meter endpoint (#745)

Release 5.4.0

This release brings Snowplow ecommerce tracking to our Android and iOS trackers. We've added 11 new event types to make tracking and modeling ecommerce user behaviour easier. It's the same API as for the Snowplow ecommerce plugin in the JavaScript tracker, and the mobile data is already supported by the ecommerce data model. Check out the documentation to find out how to enable this, and stay tuned for the mobile version of the Ecommerce Accelerator.

This release also updates the interval for refreshing properties in the platform context entity from 0.1s to 1s in order to reduce CPU usage. Finally, it exposes a function for retrieving the payload from ConsentDocument that was removed in version 5.

Changelog

Enhancements

• Add Snowplow ecommerce events and entities (#800)
• Increase interval for updating platform context properties from 0.1s to 1s (#798)
• Expose property for retrieving payload in ConsentDocument that was removed in v5 (#804)

Version 5.3.1

This is a patch release that fixes a bug with disabled screen view autotracking configuration being ignored and wrong deserialization of timestamps when migrating from version 1.7 of the tracker.

Bug fixes

• Fix incorrect date deserialization when reading the install timestamp from 1.7 version of the tracker (#801)
• Fix disabling screen view autotracking in tracker configuration (#802)

Version 5.3.0

This release brings the new media tracking APIs and improvements in remote configuration!

The media tracking APIs enable tracking of media events from video or audio playback. They provide the following key features:

1. Integrate with any media player: Instead of integrating with a specific media player, the plugin provides universal media tracking APIs that can be utilized to track media events regardless of the media player being used to play the content.
2. Media session tracking: The plugin adds a new media session context entity to tracked events that identifies the media playback. The entity also adds statistics calculated using edge analytics on the tracker such as the time spent playing, buffering or the number of ads played.
3. Support for tracking live video: With the addition of media ping events, the plugin now supports periodically tracking the progress within a live streamed video. The media ping events are fired periodically when the media is being played with configurable frequency and settings. Moreover, the plugin also makes sure that page ping events are being tracked during playback even if the user is not interacting with the page.
4. Tracking ads during playback: The plugin provides out-of-the-box events and entities for tracking ads within linear, non-linear and companion ad breaks during playback.
5. New media event schemas: The tracked events follow new schemas with additional properties. New events and entities for data quality and error tracking have been added.
6. Customizable: The plugin supports tracking custom media events and custom entities to meet your specific requirements.
7. AVPlayer auto-tracking: The plugin provides APIs to auto-track media events from the AVPlayer media player.

Here is an example of how to track media events on iOS:

let id = "XXXXX"
let tracker = Snowplow.defaultTracker()

// Initialize the media tracking identified by the `id`. It will start tracking media ping events.
let mediaTracking = tracker.media.startMediaTracking(id: id)
// Track a media play event within the media tracking.
mediaTracking.track(MediaPlayEvent())
// Update the current playback position without tracking any events.
mediaTracking.update(player: MediaPlayerEntity().currentTime(10.0))
// Track the start of an ad.
let ad = MediaAdEntity(adId: "1234").name("Podcast Ad").duration(15)
mediaTracking.track(MediaAdStartEvent(), ad: ad)
// End and clear the state for the media tracking.
tracker.media.endMediaTracking(id: id)

The release also brings improvements in the remote configuration. It adds support for configuring emitter configuration through remote configuration. It also respects default configuration for properties that are not configured through remote configuration.

Enhancements

• Add media controller with APIs to track media events (#765)
• Add emitter configuration support to remote configuration (#782)
• Use default configuration for properties that are not configured using remote configuration (#785)

Bug fixes

• Truncate URL scheme for page_url and page_refr properties (#793)
• Truncate language in platform context entity to max 8 characters (#795)
• Fix emit range configuration in Emitter not respected if using SQLite event store (#789)

Version 5.2.0

Tracker plugins provide a new filter callback that enables you to add custom logic that decides whether a given event should be tracked or not. This can for example enable you to intercept events automatically tracked by the tracker and skip some of them. For instance, the following code will apply to all screen view events and only accept ones with the name "Home Screen", other screen view events will be discarded:

plugin.filter(schemas: [
    "iglu:com.snowplowanalytics.snowplow/screen_view/jsonschema/1-0-0", // screen view events
]) { event in
    return event.payload["name"] as? String == "Home Screen"
}

Finally, you can now provide a configuration version for default configuration used in the remote configuration setup. This makes sure that the tracker is only reloaded when a newer configuration is available on the remote endpoint than the default one.

Enhancements

• Add a filter API to plugins to decide whether to track an event or not (#783)
• Add version to default remote configuration and don't update unless remote configuration is newer (#779)

Under the hood

• Handle unprotected access to sending state in Emitter from concurrent threads (#774)

Version 5.1.0

This minor release extends the platform context entity tracked in events with new information:

• isPortrait – whether the device orientation is portrait (either upright or upside down).
• resolution – Screen resolution in pixels.
• scale – Scale factor used to convert logical coordinates to device coordinates of the screen.
• language – System language currently used on the device (ISO 639)

It also makes it configurable which properties should be tracked in the platform context entity using the TrackerConfiguration.platformContextEntities configuration.

Enhancements

• Track new properties in platform context version 1-0-3 and make it configurable which properties to track (#771)

Bug fixes

• Fix remote config negative hash bug (#775)
• Fix memory leak when tracker is fetched in remote configuration (#776)