Custom dimensions make it possible to split data (such as users, sessions, devices, and
countries) in the Dashboard by additional
dimensions specific to the application. They are available in many Localytics
Dashboard reports.
If you're not sure what custom dimensions to tag, here are a few recommendations.
- Age (10,18,24,35,56)
- Gender (male, female)
- Logged In Status (signed in, not signed in)
- Merchant Type (buyer, seller)
- Net Promoter Score (neutral, positive, negative)
- Number of Friends (1,5,10,100)
- Pirated (yes, no)
- Push Notifications (on, off)
- Registration Status (unregistered, email, facebook)
- Shopper Type (never bought, bought few times, bought many times)
- Subscription Type (free, trial, paid)
The number of available custom dimensions varies based on your Localytics account level.
| Account level |
Number of dimensions |
| Enterprise |
10 |
| Professional |
1 |
Custom Dimensions are set using the setCustomDimension API and take two input
arguments:
- the number of the dimension (0 - 9)
- a string value
Choose custom dimensions carefully, because too many dimensions will render your data
meaningless. Broad customer segments and important key metrics worth tracking make great custom
dimensions. Do not record anything as a custom dimension which has more than a few
predefined values.
Once data is being passed, go to the Admin panel in each app and give the Custom Dimension a
display name. You cannot rename a custom dimension after it has been set, so be sure to
validate the data before naming. This display name won't appear in the S3 bucket JSON logs.
Note:
If a session is uploaded with a custom dimension value not set, the value will appear as
‘unknown’ in the UI. Be sure to set a default value before the first session is opened. However,
you must set the default value after the Localytics on-device database has been
created.