Set User Properties

User properties are attributes you define to describe segments of your userbase, such as language preference or geographic location.

Analytics automatically logs some user properties; you don't need to add any code to enable them. If your app needs to collect additional data, you can set up to 25 different Analytics User Properties in your app. 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.

Before you begin

If this is your first time adding Analytics to your app, complete the following procedures:

Connect your app in the Firebase console

  1. Install the Firebase SDK.
  2. In the Firebase console, add your app to your Firebase project.

Add Analytics to your app

If you haven't already added Analytics to your app, in your Activity, intialize the com.google.firebase.analytics.FirebaseAnalytics object:

private FirebaseAnalytics mFirebaseAnalytics;

// ...

// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

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:

  1. Register the property in the Analytics page of the Firebase console.

  2. Add code to set an Analytics User Property with the setUserProperty() method.

The following example adds a hypothetical favorite food property, which assigns the value in mFavoriteFood to the active user:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

You can access this data as follows:

  1. In the Firebase console, open your project.
  2. Select Analytics from the menu to view the Analytics reporting dashboard.

The User Properties tab shows a list of user properties that you have defined for your app. You can use these properties as a filter on many of the reports available in Firebase Analytics. Read more about the Analytics reporting dashboard in the Firebase Help Center.

Send feedback about...

Need help? Visit our support page.