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.
- 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.
|Flurry.CurrencyPreference||Currency code is a three letter ISO 4217 currency code|
Note that Flurry.PushEnabled will be set to True/False automatically if users opt to enable/disable push notifications.
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.
Sets and replaces (if any exist) the value(s) for the property.
Adds a User Property value(s). Adding values already included in the state has no effect and does not error.
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.
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.
Use following to set user properties in iOS:
For Android, these methods are all under the nested class FlurryAgent.UserProperties:
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 values. A counter on the admin page indicates how many exist. Standard User Property values don’t count against the limit.
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
- Audience dashboards
- Event Summary (Filters only)
- Event Details
- Parameter Trend (Filters only)
- Parameter Distribution (Filters only)
To break out by a user property, select only a single app brick and fine the User Property option in the Breakout dropdown:
- Click Add Filter
- Click “+ User Properties” to search User Properties
- Select the User Property values you want included
- Click “Apply” or “Save and Apply”