user agent utils enrichment - chuwy/snowplow-ci GitHub Wiki

HOME > SNOWPLOW SETUP GUIDE > Step 3: Setting up Enrich > Configurable enrichments > user-agent-utils enrichment

JSON Schema iglu:com.snowplowanalytics.snowplow/user_agent_utils_config/jsonschema/1-0-0
Compatibility r63+
Data provider user-agent-utils

This enrichment uses the user-agent-utils library to parse the useragent into the following fields:

br_name br_family br_version br_type br_renderengine os_name os_family os_manufacturer dvce_type dvce_ismobile

This enrichment has no special configuration: it is either off or on. Enable it with the following JSON:

{
    "schema": "iglu:com.snowplowanalytics.snowplow/user_agent_utils_config/jsonschema/1-0-0",
    "data": {
        "vendor": "com.snowplowanalytics.snowplow",
        "name": "user_agent_utils_config",
        "enabled": true,
        "parameters": {}
  }
}

Note: As an alternative solution, you could enable ua-parser enrichment either in place of this enrichment or as an accopmanying enhancement. There's no conflict here as the output data of these enrichments will end up in different tables.

###Data sources

The input value for the enrichment comes from ua parameter which is mapped to useragent field in atomic.events table.

###Algorithm

This enrichment uses 3rd party user-agent-utils library to parse the useragent string.

###Data generated

Below is the summary of the fields in atomic.events table driven by the result of this enrichment (no dedicated table).