EventNative supports ip_lookup
and user_agent_parse
enrichment rules per destination. Rules are executed before field mappings. Enrichment rule configuration has the following structure:
Field | Type | Description |
name (required) | string | Enrichment rule name. Currently supported rules: |
from (required) | string | JSON path to string IP address value. |
to (required) | string | JSON path to the result. |
IP lookup resolves address in from
JSON node into geo data structure and set geo data into to
JSON node. It uses MaxMind under the hood. IP lookup configuration example:
destinations:destination_name:enrichment:-name: ip_lookupfrom: /key1/ip_addressto: /key2/geo
Please note, that ip_lookup
works only if a MaxMind file is provided (see Geo Resolution page)
User Agent parse decomposes user agent in from
JSON node and set decomposed into to
JSON node. User Agent parse configuration example:
destinations:destination_name:enrichment:-name: user_agent_parsefrom: /client/device/user_agentto: /client/device/parsed_user_agent
Parsed user agent example:
{"ua_family": "Mobile Safari","ua_version": "14.0","os_family": "iOS","os_version": "14.0.1","device_family": "iPhone","device_brand": "Apple","device_model": "iPhone"}
EventNative has default enrichment rules that are applied to events from JavaScript API:
enrichment:- name: ip_lookupfrom: /source_ipto: /eventn_ctx/location- name: user_agent_parsefrom: /eventn_ctx/user_agentto: /eventn_ctx/parsed_ua