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 [e-mail].

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:

Parameter	Value
useragent_family	Chrome
useragent_major	48
useragent_minor	-
useragent_patch	2564
os_family	Windows 7
os_major	-
os_minor	-
os_patch_minor	-
device_family	Other

*empty values denoted by “-“