@amplitude/plugin-user-agent-enrichment-browser

Official Browser SDK plugin for user agent enrichment.

Installation

This package is published on NPM registry and is available to be installed using npm and yarn.

``sh


npm

npm install @amplitude/plugin-user-agent-enrichment-browser@^1.0.0

yarn

yarn add @amplitude/plugin-user-agent-enrichment-browser@^1.0.0
`

Usage

This plugin works on top of the Amplitude Browser SDK. It's used for enriching events with user agent information using the @amplitude/ua-parser-js. The user agent identifies the application, operating system, vendor, and/or version of the requesting client.
For Browser SDK v1.x, we use @amplitude/ua-parser-js internally to parse the user agent information. In Browser v2.x, we have removed this client-side user agent parser and have instead implemented server-side user agent parser. You can use this plugin to maintain consistency with the user agent information from earlier SDK versions.

$3

* @amplitude/analytics-browser
* @amplitude/plugin-user-agent-enrichment-browser

`typescript
import * as amplitude from '@amplitude/analytics-browser';
import { userAgentEnrichmentPlugin } from '@amplitude/plugin-user-agent-enrichment-browser';
`

$3

The plugin accepts 1 optional parameter, which is an Object to disable/enable the corresponding tracking options. Each option is enabled by default.

`typescript
const uaPlugin = userAgentEnrichmentPlugin({
osName: true,
osVersion: true,
deviceManufacturer: false,
deviceModel: false,
});
`

#### Options

|Name|Type|Default|Description|
|-|-|-|-|
|osName|boolean|true| Enables enrichment of os_name property. |
|osVersion|boolean|true| Enables enrichment of os_version property. |
|deviceManufacturer|boolean|true| Enables enrichment of device_manufacturer property. |
|deviceModel|boolean|true| Enables enrichment of device_model property. |

$3

`typescript
amplitude.add(uaPlugin);
`

$3

`typescript
amplitude.init('API_KEY');
`

Resulting page view event

This plugin parses user agent information using @amplitude/ua-parser-js and enriches events based on your configuration. This affects the value of the following properties: device_family, device_model, device_manufacturer, device_type, os, os_name, and os_version`.