Identifying your users helps you find their session in the simplicityDX dashboard.
You should use the UR.identify on page loads to associate your custom data with the current user.
There are several default fields which we encourage you to use to get the most out of simplicityDX.
Identify UID. This should be a string that uniquely identifies the users on your site. It could be something like a customer ID, email address or username. Providing this field allows simplicityDX to link sessions together for this user across different devices & platforms.
Name. This should be the users name, this is used throughout simplicityDX to make sessions easier to find.
Email. This should be the users email address, this makes it easier to find sessions for a specific user by email address.
name: "John Appleseed",
email: "[email protected]",
Revenue & Conversion Fields
We also include several strings related to the users current purchase. These help simplicityDX AI to automatically build you conversion reports & alerting.
basketValue. This should be the current value of the user's cart on the current page provided as a float
totalItems. This should be the total number of items in the users cart on the current page provided as a integer
orderTotal. This field should be provided when a user has completed checkout - and provide their order total as a float. This field is used to track conversions.
You can also store any other data you like along with a pageview, which you can use in simplicityDX for building visualisations, searching or alerting.
It is important that when you use custom fields, you always send data in the same format. For example, if you first send a float value to simplicityDX for a given field, all following submissions must also be a float, or the data will be discarded.