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.

Summary table

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

Set

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.

Register

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:

1. In Analytics, navigate to the reports for your App + Web property.
2. In the left pane, click User Properties.
3. Click NEW USER PROPERTY.
4. 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.

Related resources

Learn more about automatically collected user properties.