Skip to main content

Goals & Conversions

Goals let you measure how effectively your site converts visitors into customers, leads, or engaged users. Define which custom events represent conversions, and TraceLog tracks completion rates, trends, and breakdowns automatically.

Plan requirement

Goals & Conversions requires the GROWTH plan or above.

How It Works​

Goals are built on top of custom events. You send events from your site using tracelog.event(), then classify them in the Event Catalog.

Step 1: Send Custom Events​

Track meaningful actions from your application:

tracelog.event('purchase_completed', {
  orderId: 'ORD-789',
  total: 149.99,
  currency: 'USD'
});

Step 2: Classify Events​

  1. Go to the Events page in your project dashboard
  2. Find your event in the list
  3. Set its semantic type to Conversion or Goal
  4. Optionally mark one event as the Primary Conversion -- this becomes the default metric across your dashboard

Step 3: Analyze​

Once configured, goal data appears in the Goals section of your dashboard.

Available Analytics​

  • Completion rate -- percentage of sessions that triggered the goal event
  • Trend over time -- daily/weekly goal completions with comparison to previous periods
  • Breakdown by source -- which traffic sources drive the most conversions
  • Breakdown by device -- conversion rates across desktop, mobile, and tablet
  • Breakdown by country -- geographic conversion performance
  • Visitor type -- new vs. returning visitor conversion rates

Cohort Analysis​

Compare goal completion between visitor segments:

  • New visitors -- first-time visitors who completed the goal
  • Returning visitors -- repeat visitors who completed the goal

This helps you understand whether your conversion funnel works better for acquisition or retention.

Revenue Tracking​

If your conversion event includes a value or amount field, you can configure Revenue Tracking in Project Settings > Revenue to see financial impact across issues and analytics.

tip

Use semantic event names like purchase_completed rather than generic names like click. Descriptive names make your Event Catalog and analytics dashboards much easier to read.