User properties
1. User properties overview
Properties are individual fields to be captured for a customer. For example, name, phone number, gender, email address and more. There are several predefined fields that you can use to capture a user's data. You can also create custom properties if required.
A customer is identified with a unique identifier userId
. This can be any unique identifier such as mobile number, email adress, or any other identifier. However, you can set only one property for the userId
for your org.
This is enabled only for https://cloud.yellow.ai
We store three types of data about your users:
- System user properties (a default set of data that we capture about your users).
- Custom user properties (data you send us about your users).
- Events (data that records specific activities of users).
1.1 System user properties
The following properties are enabled by default. You can see these in User 360.
Property Name | Data Type | Description |
---|---|---|
userId | string | Unique identifier for a user NOTE: This can be passed |
firstName | string | The first name of the user |
lastName | string | Last name of the user |
gender | string | Gender of the user |
country | string | Identifies based on the location of the user’s IP address |
city | string | Identifies based on the location of the user’s IP address |
ip | string | Fetches from the user’s browser |
latitude | number | Identifies from the location of the user’s IP address |
longitude | number | Identifies from the location of the user’s IP address |
language | string | Preferred language of the user |
timezone | string | Identifies based on the location of user's IP address |
Email address of the user | ||
phone | phone | Phone number of the user with country code |
lastChannel | string | Recent channel (set up on yellow.ai) where the user had an active session You can update this property to cover touch-points/channels outside yellow.ai. |
dob | date | Date of birth of the user. |
lastSession | dateTime | timestamp of the last time the user had an active session on one of the channels set up on yellow.ai NOTE: You can update this property to cover touch-points/channels outside yellow.ai |
emailOptin | boolean | Subscription status of the user to emails. The value is true if a user has subscribed to your emails, else it is false |
smsOptin | boolean | Subscription status of the user to SMS. The value is true if a user has subscribed to your SMS, else it is false |
whatsAppOptin | boolean | WhatsApp subscription status of the user. This is true if a user has subscribed to your WhatsApp messages, else it is false . |
createdAt | dateTime | Timestamp of when the user record was created |
updatedAt | dateTime | Timestamp of when the user record was recently updated |
tags | list | List of groups associated to the user. You can add tags to users manually. |
1.3 User ID (userId) as a property
userId
is a unique property in the users schema and is used to identify a user.
You need to set a userId (a unique user identifier) for every user that you create, to be able to recognise them as the same user on multiple touch-points. If userId
is the same as email, you might want to pass it both as userId
and email address.
Passing the userId for your users will allow you to identify them on multiple touch-points, which will further allow you to:

- Offer personalised engagement across multiple touch-points/channels
- Enrich the profile of that user with the data collected from multiple touch-points/channels
You can use userId
to identify a user and use it to capture add/update user data, capture data through bot conversation.
No two users can have the same userId
You can customise the fields or information that you want to capture for your users and set the order in which you want the fields to appear on the UI.
1.5 Tag as a user property
A tag is a label used to categorise users based on certain characteristics or attributes. These labels can be used to segment customers into different groups for targeted marketing, sales, or customer service efforts. Some examples of customer labels include High-value, New customer, Inactive, or campaign responders.
A user can have more than one tag.
2. Manage user properties
You can add the System properties that you want to capture for your users. If required, you can also create your own property (custom property) that you want to capture.
2.1 Add user property
To section explains how you can add a system property To add an existing user property to your User 360 module, follow these steps:
- On the User 360 page, click User properties.
In the left panel, you can see the user schema, which includes all the system and custom properties along with their data types.
Select the property that you want to include. You can see all the selected properties on the right.
2.2 Create custom user property
Custom properties store additional information specific to your users. For example, you might want to store details such as the number of times they have visited your pricing page, what their department is, and their preferred product.
To create new user properties with your preferred label name and datatype, follow these steps:
On the User 360 page, click User properties.
In Property name, enter a name for the property.
In Property type, choose the data type of the property.
The table lists the different datatypes supported for user properties.
Data Type | Description |
---|---|
string | Stores String data |
number | Stores positive or negative integer, or a decimal number |
time | Stores time in hh:mm:ss format |
date | Stores date in YYYY-MM-DD format |
datetime | Stores date and time in YYYY-MM-DD hh:mm:ss format |
list | Stores an array of String values |
boolean | Stores true or false |
phone | Stores phone numbers with country code and validates the format by checking country code and number of digits |
url | Stores URL and validates the format for the same |
Stores email and validates the format for the same |
To add more properties, click New property.
Click Save.
Currently, you cannot modify or delete a custom property once created.
2.3 Order user properties
You can set the order in which user properties has to appear on the interface.
To set the order:
On the User 360 page, click User properties.
On the right pane, drag a property to the required position.
3. Create prsonalised conversations with user properties
If you’ve built a bot on yellow.ai, you can use the Conversational Studio to create hyper-personalised conversations based on user properties.
While these user properties are accessible in all the nodes of Studio, we’ll cover some of them with-in this document, to show you how you can create the right conversion for the right set of users.
For more details, see Using Builder to capture user data through conversations.
All user properties are accessible in nodes under “User properties”.
You can improve the engagement rates by creating personalised content. To do this, in your Message Nodes, you can can access user properties by clicking on the variable dropdown and selecting any User Property, or my simply accessing it using {{user.propertyName}}.
