User

This type represents an individual, such as a customer, user, or anonymous visitor. It includes the profile, statistics, and other personal information.

The user profile has predefined properties that are common to all users.

In addition to the properties listed below, the user profile supports additional properties called custom attributes.

Properties

These are the predefined properties of the user profile:

id(optional)

string

The user's unique identifier provided by the application, such as a UUID or a username.

name(optional)

string

The name of the user as a combination of their first and last name, separated by a space. For instance, "John Doe".

This property is virtual, meaning it is not stored in the user profile. Instead, it is derived from the first and last name.

firstName(optional)

string

The first name of the user. For example, "John".

lastName(optional)

string

The last name of the user. For example, "Doe".

age(optional)

integer

The age of the user. For example, 30.

This property is virtual, meaning it is not stored in the user profile. Instead, it is derived from the birth date.

birthDate(optional)

Date

The birth date of the user. For example, 1990-01-01.

gender(optional)

Gender

The gender of the user.

email(optional)

string

The email address of the user. For example, "john@example.com".

alternateEmail(optional)

string

The alternate email address of the user, such as a work email address or a secondary email address.

phone(optional)

string

The phone number of the user. For example, "+1 555 555 5555".

alternatePhone(optional)

string

The alternate phone number of the user, such as a work phone number or a secondary phone number.

address

Address

The address of the user.

avatar(optional)

URI

The URL of the user's avatar image.

company(optional)

string

The company the user works for.

companyUrl(optional)

URI

The URL of the company the user works for.

jobTitle(optional)

string

The job title of the user.

interests

set<string>

The set of interests the user demonstrates, with no duplicates. For example, "ab testing", "analytics", "data science", etc.

activities

set<string>

The set of activities the user performs, with no duplicates. For example, "ab testing", "analytics", "data science", etc.

stats

UserStatistics

The aggregate statistics about the user.

<attribute>(optional)

primitive|collection<primitive>

A custom attribute, where /*<attribute>*/ is the name of the attribute.

You can access any custom attribute just like any other property. For example, if you have defined a custom property named plan, you can access it like this:

user's plan

If a custom attribute has the same name as a predefined one, it takes precedence and hides the predefined attribute without overwriting it. Removing the custom attribute exposes the predefined one again.

Gender

These are the possible values and what they represent: