UsageSection titled Usage
Custom variables are additional information on the screen, the user or the session, sent within screenviews.
For example, they can include information on the current layout of a screen, like dark or light mode.
LimitsSection titled Limits
On the server sideSection titled On the server side
- It is possible to save up to 20 distinct custom variables per screenview. If more are received, only the first 20 custom variables, based on their
indexvalue, will be kept.
indexvalue of custom variable is used to determine which custom variable to be kept. Only
indexvalue between 1 and 20 will be taken into account.
On the SDK sideSection titled On the SDK side
- Every custom variable is composed of
- If you are using the same
indextwice in a single screen only the first (
value) pair associated with the
indexwill be kept.
- In case
name(max. 512 characters) or
value(max. 255 characters) maximum characters length is reached, the SDK will automatically trim the exceeding characters.
valueare empty, the SDK will instead send the literal string
- Use a consistent
indexfor a given variable within an application - for instance, if the “screen layout” is collected with an
indexof 3, use the slot 3 for this information on every screen of the application.
Defining custom variablesSection titled Defining custom variables
To define and send a custom variable, you need to use the following implementation: