Users

New
  • 1 minute(s) read
Prev Next

Overview

This page lists every record-content field captured for the user (visitor) — including the visitor identifier, the customer identifier, global user id, and user-level categories. All field names below match the technical record schema (e.g. user.id, user.customerId).

For the sender-side perspective — how user tracking data is transmitted via Tag Integration / Smart Pixel — see Users in the Smart Pixel documentation.

Field Definitions

Name / Object

Key on Record

Description

Format

Comment

User Id (URM Visitor Id)

user.id

A unique visitor ID, that is generated by the "End device Visitor Ids" (cookie ID) and/or the "URM - Custom Visitor Id" (customer ID).

String

May change within a session.

User First Visit Timestamp

user.timestamp

The instant where the user data was tracked.

String (ISO 8601 Date Time with Offset: YYYY-MM-ddTHH:mm:ssZ)

-

Customer Id ("cd")

user.customerId

Customized identifier for the tracked customer.

String

Example:

{

"USER_CATEGORIES_NUMERICVALUES_001_VALUE":  12345.0,

"USER_CUSTOMERID": "TestUser"

}

Global User Id

user.guid

Global, the unique identifier for the customer (only relevant if participating on Mapp's Cross Device Bridge).

String

May change within a session, CDB only.

User (Text) Categories

user.categories.textValues

Categories for the user if available.

Map<String, TextCategory>

May change within a session.

User (Numeric) Categories

user.categories.numericValues

Categories for the user if available.

Map<String, NumericCategory>

May change within a session.

(warning) Predefined URM Categories (e.g. Address, Email, etc)

n/a

n/a

n/a

Available in the future.

(warning) User Lifetime metrics (e.g. Lifetime Page Impressions etc)

n/a

n/a

n/a

Available in the future.

(warning) User Micro / Macro Status

n/a

n/a

n/a

Available in the future.

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.

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

User Id (URM Visitor Id)

(tick)

user_id

(tick)

getFullVisitors

urm_visitor_id

(tick)

User First Visit Timestamp

(tick)

user_timestamp

(tick)

n/a

n/a

(minus)

Customer Id ("cd")

(tick)

user_customerId

(tick)

getFullCustomer

customer_id

(tick)

Global User Id

(tick)

user_guid

(tick)

getFullVisitors

global_user_id

(tick)

User (Text) Categories

(tick)

user_categories_textValues

(tick)

n/a

n/a

(minus)

User (Numeric) Categories

(tick)

user_categories_numericValues

(tick)

n/a

n/a

(minus)

(warning) Predefined URM Categories (e.g. Address, Email, etc)

(minus)

n/a

(minus)

n/a

n/a

(minus)

(warning) User Lifetime metrics (e.g. Lifetime Page Impressions etc)

(minus)

n/a

(minus)

n/a

n/a

(minus)

(warning) User Micro / Macro Status

(minus)

n/a

(minus)

n/a

n/a

(minus)

  • Users (Smart Pixel) — how to send user / visitor identification data via the Smart Pixel.

  • Contents of Raw Data Tables — where user data appears in the Raw Data Export (see getFullVisitors and getFullCustomer).