How do the Custom Events work?

Custom Event - what is it?

Custom events allow you to capture more data with every interaction your customers make with your website, according to your business needs. You decide how custom events are triggered (i.e., clicking a specific button or performing a set of predefined actions). Use Custom events as filters to search sessions that match your research criteria to make it more accurate.

How to pass Custom Event to LiveSession?

To pass Custom Events to LiveSession, call the __ls(“track”) function:

ls("track", "User Subscribed")

Where can I find Custom Events?

Custom Events are available on our filters list. You can find it under toggled search input.

Choose one or more Custom Events you passed to LiveSession and use them as a search term. All of the events you sent will be listed on a filters list. If you don’t see your events, please ensure you sent at least one custom event using our API.

The value of a custom event will be identical to its name:

You can pass up to 50 properties with every event to better understand your visitors’ behavior. Here’s an example of a code snippet:

__ls("track", "User Subscribed", {
  plan_str: "premium",
  seats_int: 1,
  total_float: 255.50,
  isPatron_bool: true
});

Custom events and their properties will be available on the session player’s timeline, on the right side of the screen:

If you want to send custom events, please refer to our technical documentation.