Skip to main content
Refining Events
Simon avatar
Written by Simon
Updated over a week ago

Overview

The "Refine events" feature allows users to add custom event properties to their custom events for more detailed analysis and insights. By refining events with specific properties and values, users can filter sessions, create metrics, and add funnel steps that provide granular details about user interactions. This guide will walk you through how to use this feature and highlight future plans to extend its capabilities.

The Refine Event feature currently works only for custom events with added custom properties. Custom events are available in the Pro plan. See how to add Custom Events


A guide to using Refine events:

  1. Navigate to Filters:

    • Go to session filters, create metrics or add funnel steps.

  2. Choose a Custom Event:

    • In the Event filters section, select a custom event from the dropdown menu. For instance, you might have a custom event labeled "Signup."


  3. Refine Event Properties:

    • Click on the "Refine Event" button next to your selected custom event.

    • In the refinement options, you can add properties and specify their values. For example, if your custom event is "Signup," you might have a property called "from" with values like "Header," "Hero," and "Footer."


  4. Filter Sessions:

    • After refining your custom event with specific properties and values, you can filter sessions to analyze user behavior based on these refined criteria. For example, you can filter the sessions in which a user has signed up by clicking on the "Signup" button in the Header.

  5. Create Metrics:

    • Use the refined custom events to create detailed metrics that provide insights into specific user actions. For instance, you can create a metric to measure how many users signed up from the "Hero" section.

  6. Add Funnel Steps:

    • Incorporate refined events into your funnel analysis to understand user journeys better. For example, add a funnel step to track users who signed up from the "Footer" and then completed a purchase.


Adding Properties to Events

You can pass up to 50 properties with every event to better understand your visitors’ behavior. These properties can include price, quantity, URL, product name, plan name, and more. 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
});


This flexibility allows you to capture a wide range of data points to enrich your event tracking and analysis. Read more about Custom Events

Future Plans

We plan to extend the "Refine Events" feature to include properties for any event, not just custom events. This enhancement will allow for even greater flexibility and detail in event analysis. Users will be able to refine standard events, such as "Clicked" event and "Visited URL" event, with specific properties. These properties may include the URL where the event occurred, referrer URL, city, country, time on page active, device type, and many others.

Conclusion

The "Refine Events" feature is a powerful tool for gaining detailed insights into user behavior by adding and analyzing event properties. Whether you're filtering sessions, creating metrics, or adding funnel steps, this feature enhances your ability to understand and optimize user interactions. Keep an eye out for future updates that will further expand these capabilities to all events, providing even more comprehensive analytical options.

Did this answer your question?