UA Parser Enrichment

Summary

This enrichment uses the ua-parser library to parse the useragent and attach a ua_parser_context to each event. This allows for all the data available from the user agent from the request header to be parsed into Snowplow parameters for loading into your database.

Overview

Collecting and separating out all the valuable device information to be found in the user agent is a great way to get insight into the types of devices and operating systems and versions your users are using. This helps with deciding which to support as well as in decisions around functionality releases.

With the device family field which is part of the context you can also benefit from the lookup done with our database to sort the multitude of different devices into higher level device types like desktop, mobile, tablet, other, etc.

For more information on this enrichment or for help configuring a custom database for it please reach out to support@snowplowanalytics.com.

Example

As an example, the useragent string

Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2564.116 Safari/537.36

will be parsed with the following result:

ParameterValue
useragent_familyChrome
useragent_major48
useragent_minor-
useragent_patch2564
os_familyWindows 7
os_major-
os_minor-
os_patch_minor-
device_familyOther

*empty values denoted by “-“