| Select platform: | iOS+ Android Web Flutter Unity C++ |
User properties are attributes you define to describe segments of your user base, such as language preference or geographic location. These can be used to define audiences for your app. This guide shows you how to set user properties in your app.
Analytics automatically logs some user properties; you don't need to add any code to enable them. If you need to collect additional data, you can set up to 25 different user properties per project. Note that user property names are case-sensitive and that setting two user properties whose names differ only in case results in two distinct user properties being logged.
You can't use a small set of user property names reserved by Google:
- Age
- Gender
- Interest
Before you begin
Make sure that you've set up your project and can access Analytics as described in Get Started with Analytics for C++.
Set user properties
You can set Analytics user properties to describe the users of your app. You can analyze behaviors of various user segments by applying these properties as filters to your reports.
Set a user property as follows:
In the Firebase console, go to Analytics.
Register the property.
In your app's codebase, set a user property using the
SetUserProperty()method. You can use the name and value of your choosing for each property.
The following example shows adding a hypothetical favorite food property, which
assigns the value in the string mFavoriteFood to the active user:
SetUserProperty("favorite_food", mFavoriteFood);
In the Firebase console, you can access this data from the Analytics > Custom Definitions page. This page shows a list of user properties that you have defined for your app. You can use these properties in comparisons on many of the reports available in Google Analytics. Read more about the dashboard.