Docs/Events/Track your events

Track Custom Events

Overview

Custom events allow you to track specific user interactions and behaviors in your application. With Versatailor's analytics platform, you can implement custom event tracking to gather valuable insights about how users interact with your features.

Implementation

To track custom events, use the versatailor function available in the global window object. Here's a basic example:

window?.versatailor("submit_button_click", {
  description: "User clicked the submit button",
});

Event Dashboard

The custom events dashboard provides a comprehensive view of your tracked events, including:

  • Event name and description
  • Total event count
  • Unique users who triggered the event
  • User journey analysis

Event Metrics

Each event in the dashboard displays key metrics:

  • Count: Total number of times the event was triggered
  • Unique Users: Number of distinct users who triggered the event
  • Journey: Access to detailed user journey information

User Journey Analysis

For each custom event, you can analyze the user's journey to understand the context and flow of actions:

  • View all instances of a specific event
  • Analyze the sequence of actions before and after the event
  • Understand user behavior patterns

Best Practices

Naming Conventions

Use clear and consistent naming patterns for your events:

// Good examples
window?.versatailor("signup_form_submitted", { ... });
window?.versatailor("product_added_to_cart", { ... });

// Avoid
window?.versatailor("clicked", { ... }); // Too vague
window?.versatailor("btn_1_click", { ... }); // Not descriptive

Need help? Contact us for assistance.

Suggest features? We'd love your feedback