Skip to main content

Session Properties

Session Properties are another way to annotate the session. The difference between session properties and user personas is that the former are for items relating to the session or the device and not necessarily to the user. However, you are free to use both mechanisms interchangeably.

Here is an example of setting a session property:

Embrace.getInstance().addSessionProperty("launch type", "normal", permanent: false)
Limits on Properties
  • Property keys have a limit of 128 characters.
  • Property values have a limit of 1024 characters.
  • The default limit for session properties is 10. You can have up to 100 properties (the limit can be increased on Android SDK 5.14.2 or iOS SDK 5.16.1 and above). Reach out to support@embrace.io to increase this.

In the above, the "launch type" property is set with a value of "normal". This is to indicate normal launches by the user. When the app is launched via a push notification tap, you can set the value "push". This can help to understand issues that are hurting push notification adoption rates. For example, you could prioritize fixing the issues that affect customers that use push notifications, since they generally provide higher lifetime value.