Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/vemetric/vemetric/llms.txt

Use this file to discover all available pages before exploring further.

Overview

User Journeys in Vemetric allow you to dive deep into individual user behavior, tracking their complete interaction history with your website. This feature is essential for understanding how specific users navigate your site, what actions they take, and when they’re most active.

Users List

The Users page displays all visitors to your website with key information at a glance:

User Information Display

Each user entry shows:
  • Online status - Green indicator for currently active users
  • User avatar - Gravatar or custom avatar if available
  • Display name - Custom name or identifier (email, username, etc.)
  • Country - Geographic location with flag icon
  • Last seen - Timestamp of most recent activity
Users are identified by the identifier you provide when tracking events. This could be an email, username, user ID, or any unique identifier from your system.

Sorting Users

Click the sort button to organize users by different criteria:
Sort by most recent activity (default). Shows who visited your site most recently.

Event-Based Sorting

When sorting by a custom event:
  1. Click the sort dropdown
  2. Select “Custom event”
  3. Choose the event name from your tracked events
  4. Users who never triggered that event show “Never” as the timestamp
  5. Users are ordered by most recent event occurrence
Use event-based sorting to find users who recently completed important actions, like “Purchase Completed” or “Sign Up Form Submitted”.

Searching Users

The search functionality helps you find specific users:
  • Search by display name or identifier
  • Results filter in real-time as you type
  • Combine search with filters for precise user segments
  • Case-insensitive matching

Filtering Users

Apply filters to segment your user base:
1

Click Add Filter

Open the filter menu to select filter criteria
2

Choose Filter Type

Select from events, geographic data, device types, browsers, operating systems, or pages visited
3

Configure Filter

Set conditions like “event is” or “country is not”
4

View Results

The user list updates to show only matching users

Common Filter Use Cases

Filter by country or city to see users from particular geographic regions. Useful for understanding regional behavior patterns.
Filter by device type to see only mobile or tablet users. Helps analyze mobile-specific user experiences.
Filter by a specific event to find users who have (or haven’t) used a particular feature.
Filter by browser type to identify users who might experience browser-specific issues.

Individual User Profile

Click any user to view their complete profile and activity history.

User Profile Header

The profile header displays:
  • User avatar and display name
  • Online status indicator
  • Latest device information (browser, OS, device type)
  • Country location
  • User identifier

Activity Heatmap

Visual representation of user activity over time:
  • Shows up to 6 months of historical activity
  • Each day is color-coded by event count
  • Darker colors indicate more activity
  • Hover over any day to see exact event counts
  • Helps identify usage patterns and engagement frequency
The activity heatmap uses GitHub-style visualization, making it easy to spot active periods at a glance.

Funnel Progress

If you have funnels configured, see this user’s progress:
  • Which funnels the user has started
  • Completed steps in each funnel
  • Step where the user stopped (if incomplete)
  • Funnel completion status
Use funnel progress to understand where individual users drop off in conversion flows, enabling targeted support or re-engagement.

Event Timeline

The timeline shows every action the user has taken:

Session Grouping

Events are organized by user sessions:
  • Sessions group related events within a time window
  • Each session shows start time and duration
  • Session boundaries marked with visual separators
  • Multiple sessions displayed chronologically

Event Details

Each event in the timeline includes:
  • Event name - The action that was triggered
  • Timestamp - Exact date and time
  • Page information - Which page the event occurred on
  • Event properties - Custom data attached to the event
  • Device information - Browser, OS, and device type

Event Properties

Expand any event to see its properties:
{
  "button_text": "Add to Cart",
  "product_id": "12345",
  "product_name": "Premium Widget",
  "price": 49.99,
  "currency": "USD"
}
Properties provide context about what the user was doing and help you understand their intent.

Filtering Timeline

Narrow down the timeline by:
  • Event type - Show only specific events
  • Date range - Focus on a particular time period
  • Session - View events from a single session

Real-Time Updates

The Users page updates automatically:
  • New users appear as they visit your site
  • Online status indicators update in real-time
  • “Last seen” timestamps refresh automatically
  • New events appear in user timelines as they happen
On the free plan, user history is limited to the last 30 days. Upgrade to a paid plan for up to 90 days of history.

Pagination

Navigate through your user list:
  • 50 users per page
  • Previous/Next buttons to move between pages
  • Page number indicator
  • Pagination state persists with filters and search

Use Cases

Debug User Issues

When a user reports a problem, view their event timeline to see exactly what they did and where the issue occurred.

Identify Power Users

Sort by activity or event count to find your most engaged users. Reach out for feedback or testimonials.

Track Conversions

Use funnel progress to see which users completed key conversion flows and which ones dropped off.

Geographic Analysis

Filter by location to understand behavior patterns in different regions or markets.

Device-Specific Behavior

Compare how users on different devices interact with your site to optimize experiences.

Re-engagement

Sort by last seen to identify inactive users who might benefit from re-engagement campaigns.

Best Practices

1

Use meaningful identifiers

Set user identifiers to recognizable values (email, username) rather than random IDs for easier identification.
2

Track important events

Implement event tracking for key user actions to build comprehensive user journeys.
3

Review regularly

Check user behavior patterns weekly to spot trends and opportunities.
4

Combine with filters

Use filters to segment users and discover insights about specific user groups.

Privacy Considerations

Vemetric respects user privacy:
  • You control what data is collected via your event tracking implementation
  • User identifiers can be anonymized or pseudonymized
  • No sensitive data is collected automatically
  • All data storage complies with privacy regulations

Next Steps

Custom Events

Learn how to track events to build detailed user journeys

Funnels

Create conversion funnels to track user progress

Filtering

Master filtering to segment your users effectively

Real-Time Analytics

Monitor user activity as it happens