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 User Properties 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 them 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
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 managed on Flurry with the Flurry SDK passing client state change requests. There are 4 groups of operations (set, add, remove, flag).
For (set, add), the first 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.
Select the App for the user property
Click the Create User Property button
Assign a Name for the User Property (case insensitive, but must be unique and must match the value set in the client)
Assign a Description for the user property (optional)
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 User Property 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:
Filters¶
To filter your reporting by one or more User Properties, use Filters.
Click Add Filter
Click “+ User Properties” to search User Properties
Select the User Property values you want included
Click “Apply” or “Save and Apply”