Users
User Identification
Users represent each unique person who visits your solution.
When a person visits your website or mobile app, an anonymous user is created with a unique and temporary identifier.
This identifier is then saved so that the user is recognized on their future visits through the following methods:
- Web: cookies
- Android: SharedPreferences
- iOS: Keychain
When the identify function is called (at the time of login), the user, who was previously anonymous, becomes identified with the information you provide. A unique id must be provided.
All the information collected about a user when they are anonymous will be associated with their account once they log in.
This information can be viewed in the Audience section of Told.
If you call the reset function (at the time of logout), a new anonymous user will be created, and the current session will use this new identifier.
Information Stored During Identification
When the identify function is called, several pieces of information are recorded. Some of these are common to all users:
| TRAIT | TYPE | DESCRIPTION |
|---|---|---|
| id | String | Unique ID in your database for a user. |
| name | String | User's name. |
| createdAt | Date | Account creation date. Segment recommends date strings in ISO-8601 format. |
| String | User's email address. | |
| firstName | String | User's first name. |
| lastName | String | User's last name. |
| username | String | Username. |
| website | String | Group’s website. |
| phone | String | Group’s phone number. |
| address | Object | Group’s postal address (may include city, country, postalCode, state, or street). |
| avatar | String | URL of the user's avatar image. |
| description | String | Description of the user, such as their personal biography. |
| language | String | User's language (locale), without the region, e.g., "en" for English. |
Name
The user's name can be provided via the name field, or by concatenating the firstName and lastName fields, or from the username field.
Language
The default language is typically that of the user's web browser or mobile phone. If specified during the identify function call, it will override the default value.
Solicitation
Solicitation refers to the number of times a user sees a Told appear.
Sessions
The number of sessions refers to how many times a user visits your website or mobile app, with a 30-minute interval between each visit.
Import
You can import your users from your database in JSON or CSV format.
Each data entry must include a mandatory id field.
When importing users, you can add a groups field, which contains a list of company IDs to which the user belongs.
If the passed company does not exist, it will be created.