Custom user properties
About user properties
Set custom user properties to identify static or slowly changing attributes of your users, such as "spender=true", "profession=engineer", or "favorite_team=Real Madrid". User properties are effectively sticky event parameters that are automatically logged when you call
logEvent. After you create and register user-property values, you can use them to filter your reports. For example, you can see how the game-play habits of spenders differ from non-spenders.
Each Analytics property can have up to 25 uniquely named (case-sensitive) user properties.
The summary table lists the user properties that you set in your Analytics tracking code and then register in the Analytics interface.
Set and register a user property
You set user properties in your Analytics tracking code.
For information about calling
setUserProperty (Android) and
setUserPropertyString (iOS), refer to the developer documentation. For information on how to set user properties for web, refer to User properties.
In order to apply a user property as a report filter, you need to register it in the Analytics interface. Filtering is possible on data received from the day of registration onwards. To register a new user property:
- In Analytics, navigate to the reports for your App + Web property.
- In the left pane, click User Properties.
- Click NEW USER PROPERTY.
- Enter a name and description for the user property, then click CREATE.
Limits and guidelines
Learn more about the limits and guidelines you need to observe when collecting user data.
Learn more about automatically collected user properties.