We are pleased to announce a new release of the Snowplow Android Tracker.
Version 0.7.0 introduces first-class methods for tracking when users grant or withdraw consent for their personal data to be processed for specific purposes, as well as new and improved form tracking and the ability to create new tracker sessions client-side.
Read on below the fold for:
- Consent tracking
- More flexible lifecycle tracking
- Improved TLS configuration
- New session convenience method
- Updates and bug fixes
- Getting help
1. Consent tracking
Against the backdrop of the incoming GDPR and ePrivacy regulations, this release adds new events to track when users give their consent to, and withdraw their consent from, having their personal data processed for specific purposes.
We envision that many digital businesses will want to track the consent of their users against relatively fine-grained “bundles” of specific use cases for data, which we model in Snowplow as consent documents.
The two new consent tracking methods are:
trackConsentGrantedfor the giving of consent by a data subject
trackConsentWithdrawnfor the removal of consent by a data subject
Each consent event will be associated to one or more consent documents, attached to the event as contexts.
Here is an example of a user opting into data collection per a specific consent document
2. More flexible lifecycle tracking
App lifecycle tracking is a powerful auto-tracking capability, introduced in version 0.6.0. In this release we add fine-tuned control of lifecycle tracking, with the functions
For example, this can be used to maintain a session uninterrupted when something momentarily backgrounds an activity:
The lifecycle handler can also now be constructed with a custom context, so that all
application_background events will include the custom context:
Documentation can be found here.
3. Improved TLS configuration
With this release, the TLS version(s) used by the emitter can be specified in the builder:
Alternatively a single enum can be passed to the builder like so:
As always, documentation is found here.
4. New session convenience method
With this release, a new session can be started with the tracker method,
5. Updates and bug fixes
Other updates and fixes include:
- Fixing the bug where
firstIdwas not reset if the app is in the foreground (issue #257)
- Raising the minimum supported Android API to level 14 (issue #262)
- Unregistering LifecycleHandler callbacks on activity destruction (issue #259)
- Fixing our outdated and broken Travis configuration (issue #258)
identifyUseras an alias for
tracker.setLifecycleHandlertake a Context instead of an Activity (issue #224)
You can find the updated Android Tracker documentation on our wiki.
As part of this release we have updated our tutorials to help Android developers integrate the Tracker into their apps:
- Guide to integrating the tracker
- Guide to setting up a test environment
- Walkthrough of our Android demo app
You can find the full release notes on GitHub as Snowplow Android Tracker v0.7.0 release.
7. Getting help
For more details on this release, please check out the release notes on GitHub.