Overview
Visitor Environment summarizes the technical environment of the visitor at the time of the event: the device they used (Device), the Browser running the request, the underlying Operating System, the resolved Platform (mobile, tablet, desktop, …), the geographic Location derived from the request, the Connection details, and miscellaneous client capabilities (Visitor Capabilities).
Device fields are split into a modern, fully supported set and a legacy set that remains available only in the Classic Raw Data Export.
Field Definitions
Device
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Device Class |
| The type of the detected device according to Mapps classification. Values: Desktop, SmartPhone, Tablet, TV, Console, Smartwatch, EReader, MediaHub, other |
|
|
Device Class ID |
| The numeric type of the detected device according to Mapps classification. |
| Numeric version of Hardware Device Class |
Device Full Name |
| The full name of the detected device including device vendor, device name and device family. |
| Contains "marketing name" |
Device Name |
| The detected device name. |
| Contains name |
Device Family |
| The detected device family. |
| contains family |
Device Vendor |
| The vendor of the detected device. |
| Contains vendor |
Device Model |
| The detected device model. |
| Contains model |
Device Release Year |
| Release year of the detected device. |
| Contains release year |
Device Release Month |
| Release month of the detected device. |
| Contains release month |
Device Screen Pixel Height |
| The pixel height of the device screen. |
| Contains screen pixel height |
Device Screen Pixel Width |
| The pixel width of the device screen. |
| Contains screen pixel width |
Device Screen Inches Diagonal |
| The diagonal screen size of the detected device in inches. |
| Contains screen inches |
Device Screen Color Depth |
| The color depth of the screen of the detected device in bits. |
| Contains screen colordepth |
Device ID |
| Unique ID of the detected device. |
| Contains unique id of the hardware (this is not the device.deviceEverId) |
Note
The following fields are deprecated and only available in the Classic Raw Data Export. Use the modern Device fields above instead.
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Device Full Name |
| The full name of the detected device including device vendor, device name and device family. |
| Will be deprecated. Please see new Device tab |
Device Name |
| The detected device name. |
| Will be deprecated. Please see new Device tab |
Device Family |
| The detected device family. |
| Will be deprecated. Please see new Device tab |
Device Vendor |
| The detected device manufacturer. |
| Will be deprecated. Please see new Device tab |
Device Model |
| The detected device model. |
| Will be deprecated. Please see new Device tab |
Device Class |
| The type of detected device according to Mapp's classification.Values: Desktop, SmartPhone, Tablet, TV, Console, Smartwatch, EReader, MediaHub, other |
| Deprecated, but still available. Please see new Device tab |
Device Screen Resolution |
| The detected device screen resolution in width x height format. |
| Deprecated, but still available. Please see new Device tab |
Device Screen Colordepth |
| The color depth of the screen of the detected device in bits. |
| Deprecated, but still available. Please see new Device tab |
Device Screen Inches Diagonal |
| The inches diagonal size of the screen of the detected device. |
| Will be deprecated. Please see new Device tab |
Device Release Year |
| The release year of the detected device. |
| Will be deprecated. Please see new Device tab |
Device Release Month |
| The release month of the detected device. |
| Will be deprecated. Please see new Device tab |
Device Ever Id (Cookie) |
| Device cookie ID (DEID). |
|
|
Browser
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Browser Full Name |
| The full name of the detected web browser. |
| new field, contains the "marketing name" of the browser |
Browser Name |
| The name of the detected web browser. |
| existing field, now filled, contains the browser name |
Browser Vendor |
| The vendor of the detected web browser. |
| existing field, now filled, contains the browser vendor |
Browser Version |
| The version of the detected web browser. |
| existing field, now filled, contains the browser version |
Browser Major Version |
| The major version of the detected web browser. |
| new field, contains the browser major version |
Browser Minor Version |
| The minor version of the detected web browser. |
| new field, contains the browser minor version |
Browser Javascript Version |
| The Javascript version of the detected browser. |
| existing field, now filled, contains the javascript version |
User Agent String |
| The user agent string from the browser of the tracked user. |
|
|
Browser ID |
| Unique ID of the deteced browser. |
| new field, contains a unique id of the browser |
Browser Release Year |
| Release year of the detected browser. |
| new field, contains the release year |
Browser Release Month |
| Release month of the detected browser. |
| new field, contains the release month |
Operating System
Note
These Operating System fields are deprecated and only available in the Classic Raw Data Export. Use the modern Platform fields below for new integrations.
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Operating System Name |
| The name of the operating system on which the detected device runs. |
| Deprecated. Please see new Platform tab |
Operating System Vendor |
| The vendor of the operating system on which the detected device runs. |
| Deprecated. Please see new Platform tab |
Operating System Version |
| The version of the operating system on which the detected device runs. |
| Deprecated. Please see new Platform tab |
Platform
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Operating System Full Name |
| The full name of the operating system on which the detected device runs. |
| new field, contains marketing name |
Operating System Name |
| The name of the operating system on which the detected device runs. |
| new field, contains name |
Operating System Vendor |
| The vendor of the operating system on which the detected device runs. |
| new field, contains vendor |
Operating System Version |
| The version of the operating system on which the detected device runs. |
| new field, contains version |
Operating System Major Version |
| The major version of the operating system on which the detected device runs. |
| new field, contains major version |
Operating System Minor Version |
| The minor version of the operating system on which the detected device runs. |
| new field, contains minor version |
Operating System ID |
| Unique ID of the detected operating system. |
| new field, contains a unique id of the platform |
Operating System Release Year |
| Release year of the detected operating system. |
| new field, contains the release year |
Operating System Release Month |
| Release month of the detected operating system. |
| new field, contains the release month |
Location
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Country Code |
| The detected ISO 3166 2-letter country code where the visit was originated |
| Root & Custom Stream contain country code (e.g. DE), whereas Raw Data export contains country name (e.g. Germany) |
City |
| The detected city where the visit was originated |
|
|
Region | n/a |
| Available in the future. |
Connection
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
Connection Speed |
| The detected connection speed the of the tracked user.Values: unknown, modem_isdn, cable_dsl, coorporate, mobile, satellite, wireless |
| Data Streams provides a String value, whereas the Raw data export provides a numeric code. In the Raw Data Export, the same value is represented as an integer. |
Connection ISP |
| The detected Internet Service Provider name of the tracked user. |
|
|
Connection Organization |
| The detected organization name of the tracked user. |
|
|
Visitor Capabilities
Name / Object | Key on Record | Description | Format | Comment |
|---|---|---|---|---|
New vs Returning Visitor | n/a |
|
| |
Javascript Flag | n/a |
|
| |
Java Flag | n/a |
|
| |
Browser Language | n/a |
| Might be added later to Data Streams. | |
Client Timezone | n/a |
| Might be added later to Data Streams. | |
Geid | n/a |
| Deprecated feature, not supported by Mapp Intelligence. | |
Browser Window size | n/a |
| Might be added later to Data Streams. |
Stream and Export Mapping
The same fields, mapped to their availability in the Root Stream, Custom Streams, the current Raw Data Export, and the Classic Raw Data Export. Use the Name / Object column to cross-reference rows with Field Definitions above.
Device
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Device Class |
|
|
|
|
|
|
Device Class ID |
|
|
|
|
|
|
Device Full Name |
|
|
|
|
|
|
Device Name |
|
|
|
|
|
|
Device Family |
|
|
|
|
|
|
Device Vendor |
|
|
|
|
|
|
Device Model |
|
|
|
|
|
|
Device Release Year |
|
|
|
|
|
|
Device Release Month |
|
|
|
|
|
|
Device Screen Pixel Height |
|
|
|
|
|
|
Device Screen Pixel Width |
|
|
|
|
|
|
Device Screen Inches Diagonal |
|
|
|
|
|
|
Device Screen Color Depth |
|
|
|
|
|
|
Device ID |
|
|
|
|
|
|
Note
The following fields are deprecated and only available in the Classic Raw Data Export. Use the modern Device fields above instead.
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Device Full Name |
|
|
|
|
|
|
Device Name |
|
|
|
|
|
|
Device Family |
|
|
|
|
|
|
Device Vendor |
|
|
|
|
|
|
Device Model |
|
|
|
|
|
|
Device Class |
|
|
|
|
|
|
Device Screen Resolution |
|
|
|
|
|
|
Device Screen Colordepth |
|
|
|
|
|
|
Device Screen Inches Diagonal |
|
|
|
|
|
|
Device Release Year |
|
|
|
|
|
|
Device Release Month |
|
|
|
|
|
|
Device Ever Id (Cookie) |
|
|
|
|
|
|
Browser
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Browser Full Name |
|
|
|
|
|
|
Browser Name |
|
|
|
|
|
|
Browser Vendor |
|
|
|
|
|
|
Browser Version |
|
|
|
|
|
|
Browser Major Version |
|
|
|
|
|
|
Browser Minor Version |
|
|
|
|
|
|
Browser Javascript Version |
|
|
|
|
|
|
User Agent String |
|
|
|
|
|
|
Browser ID |
|
|
|
|
|
|
Browser Release Year |
|
|
|
|
|
|
Browser Release Month |
|
|
|
|
|
|
Operating System
Note
These Operating System fields are deprecated and only available in the Classic Raw Data Export. Use the modern Platform fields below for new integrations.
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Operating System Name |
|
|
|
|
|
|
Operating System Vendor |
|
|
|
|
|
|
Operating System Version |
|
|
|
|
|
|
Platform
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Operating System Full Name |
|
|
|
|
|
|
Operating System Name |
|
|
|
|
|
|
Operating System Vendor |
|
|
|
|
|
|
Operating System Version |
|
|
|
|
|
|
Operating System Major Version |
|
|
|
|
|
|
Operating System Minor Version |
|
|
|
|
|
|
Operating System ID |
|
|
|
|
|
|
Operating System Release Year |
|
|
|
|
|
|
Operating System Release Month |
|
|
|
|
|
|
Location
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Country Code |
|
|
|
|
|
|
City |
|
|
|
|
|
|
Region |
|
|
|
|
|
Connection
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
Connection Speed |
|
|
|
|
|
|
Connection ISP |
|
|
|
|
|
|
Connection Organization |
|
|
|
|
|
|
Visitor Capabilities
Name / Object | Available in Root Stream | Field in Custom Stream | Available in Custom Stream | File in the Raw Data Export | Field in the Raw Data Export | Available in Classic Raw Data Export |
|---|---|---|---|---|---|---|
New vs Returning Visitor |
|
|
|
|
| |
Javascript Flag |
|
|
|
|
| |
Java Flag |
|
|
|
|
| |
Browser Language |
|
|
|
|
| |
Client Timezone |
|
|
|
|
| |
Geid |
|
|
|
|
| |
Browser Window size |
|
|
|
|
|