This article explains what Track Events are and how to configure them in Novus. Track Events help you monitor specific user interactions and conversion points in your app.

What is a Track Event

A Track Event logs a key action in your app that isn't automatically captured by standard page or feature tracking. You can use Track Events to record interactions like form submissions, purchases, subscription upgrades, and important state changes.

Each Track Event includes a name, a description, the associated Product Area, and suggested metadata to give you more context about the action.

Why Track Events matter

Track Events give you deep visibility into custom business logic and critical user flows. By tracking specific conversion events and errors, you can analyze user behavior more accurately and make informed decisions to improve your product.

How Track Events work

Novus scans your codebase to identify important actions that should be tracked. It then presents a list of these potential Track Events. Because Track Events require specific code changes to work, Novus automatically generates the necessary instrumentation code and creates a Pull Request for your development team to review and merge.

Set up Track Events

You can review and enable Track Events directly from your settings.

1. Go to Admin from the left navigation menu.
2. Select Track Events to view the list of detected events.
3. Review the event details, including the description, Product Area, and status.
4. Use the toggle next to each event to select the ones you want to track.
5. Select the sync option to finalize your choices. Novus generates the required code changes.
6. Work with your development team to review and merge the generated Pull Request. Once your development team merges the changes, Novus begins tracking these events.

Analyze track event metrics

Once a Track Event is fully instrumented and tracking, you can view its performance metrics and break down usage by custom properties.

1. Select a tracked event to open its details panel.
2. Review the top-level metrics, such as total event counts and the number of unique visitors and accounts.