1. Home
  2. Docs
  3. Enriching your data
  4. Available enrichments
  5. UA parser enrichment

UA parser enrichment

This enrichment uses the ua-parser library to parse the user agent and provide information about the user’s device.

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.

Configuration

Input

This enrichment uses the field useragent.

Output

This enrichment adds a new context to the enriched event with this schema.

FieldDescription
useragent_familyUseragent family (browser) name
useragent_majorUseragent major version
useragent_minorUseragent minor version
useragent_patchUseragent patch version
useragent_versionFull version of the useragent
os_familyOperation system name
os_majorOperation system major version
os_minorOperation system minor version
os_patchOperation system patch version
os_patch_minorOperation system patch minor version
os_versionOperation system full version
device_familyDevice type

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

would 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
os_versionWindows 7
device_familyOther

*empty values denoted by “-“

If you’d like to learn more about Snowplow Insights you can book a demo with our team, or if you’d prefer, you can try Snowplow technology for yourself quickly and easily.