User Properties

User Properties allow you to label your users based on preferences, behaviors or attributes unique to your app.

User Property Types

User Properties may be either Standard or Custom.

Notes on User Properties:

  • Flurry User Properties are case insensitive.
    • For example: Values “news,” “News,” and “NEWS” will be treated as a single value.

  • Flurry User Properties are captured on the device-level
    • If your app uses UserID, User Properties are not applied to multiple devices with the same UserID

  • As with Flurry Events, Flurry terms prohibit the inclusion of Personally Identifiable Information in User Properties

Custom User Properties

An app can have up to 50 User Properties. An app can have up to 500 Values. These values may be evenly distributed across keys or may be weighted toward only one or a few.

Character limits

  • User Property: Maximum 40 characters

  • User Property Description (set in Flurry admin): Maximum 150 characters

  • User Property Value=Maximum 40 characters

Allowed Characters and Reserved strings

User Properties may be alphanumeric with no special characters allowed. The string “Flurry.” is reserved for Standard User Properties.

Standard User Properties

For Standard User Properties, Flurry includes five standard User Properties. These do not count against the limits specified in the Custom User Properties section. Unlike Custom User Properties, you do not need to create these in Admin in order to use in reporting.

Property Name

Values

Flurry.CurrencyPreference

Currency code is a three letter ISO 4217 currency code

Flurry.Purchaser

True/False

Flurry.RegisteredUser

True/False

Flurry.Subscriber

True/False

Flurry.PushEnabled

True/False

Note that Flurry.PushEnabled will be set to True/False automatically if users opt to enable/disable push notifications.

Client-Side API

The user properties state is on the server, and the SDK is a pass thru agent for client state change requests. There are 4 groups of operations (set, add, remove, flag).

  • For (set, add), the fist parameter is a key, and the second parameter can be either a value, or a list of values.

  • For (remove), the first parameter is a key, and the second parameter can be either a value, a list of values, or omitted to remove all values.

  • For (flag), the first parameter is a key and there is no second parameter.

Set

Sets and replaces (if any exist) the value(s) for the property.

Add

Adds a User Property value(s). Adding values already included in the state has no effect and does not error.

Remove

Removes a specific User Property value(s) or removes all values. Removing values not already included in the state has no effect and does not error.

Flag

Exactly set, or replace if any previously exists, any value for the property to a single true state Implies that value is boolean and should only be flagged and cleared.

iOS

Use the following to set user properties on iOS:

Android

For Android, these methods are all under the nested class FlurryAgent.UserProperties:

Creation

A Custom User property must be created in the UI in order to view that User Property in reporting. A User Property may be created for an app in Admin > User Properties.

IMG1

  1. Select the App for the user property

  2. Click the Create User Property button

  3. Assign a Name for the User Property (case insensitive, but must be unique and must match the value set in the client)

  4. Assign a Description for the user property (optional)

  5. Click Save

Values set by your integration for User Properties already created will automatically be available for reporting. You can have up to 500 custom values. A counter on the admin page indicates how many exist. Standard User Property values don’t count against the limit.

Reporting

Once a User Property has been set by the client side API and created in Admin, you can start using User Properties in Reporting. The primary ways to use User Properties are in Breakouts and Filters. These can only be applied to a single app, and can be applied in these dashboards:

  • App Summary (Filters only)

  • App Activity

  • Active Devices

  • Retention

  • Revenue

  • Audience dashboards

  • Event Summary (Filters only)

  • Event Details

  • Parameter Trend (Filters only)

  • Parameter Distribution (Filters only)

Breakouts

To break out by a user property, select only a single app brick and fine the User Property option in the Breakout dropdown:

IMG2

Filters

To filter your reporting by one or more User Properties, use Filters. IMG3

  1. Click Add Filter

  2. Click “+ User Properties” to search User Properties

  3. Select the User Property values you want included

  4. Click “Apply” or “Save and Apply”