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.

Default Fields

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.

urCapture.identify('uid', {
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.

basketValue: 44.99,  
basketItems: 10,
orderTotal: 10


Custom Fields

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.

age: 34,  
favoriteColor: blue,
previousOrders: 10

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.

Did this answer your question?