Event Types Reference

Complete list of all event types tracked by Pipetrace.

Pipetrace automatically tracks many event types without any configuration. You can also fire custom events using the JavaScript API.

All Event Types

Event TypeDescriptionAuto
pageview
Fired when a user visits a pageAuto
page_exit
Fired when user leaves a page (includes engagement data)Auto
scroll
Fired at 25%, 50%, 75%, and 100% scroll milestonesAuto
outbound_click
Fired when user clicks a link to another domainAuto
file_download
Fired when user clicks a download link (pdf, zip, etc.)Auto
form_start
Fired when user focuses on a form fieldAuto
form_submit
Fired when user submits a formAuto
rage_click
Fired when user clicks rapidly in the same area (frustration signal)Auto
dead_click
Fired when user clicks on non-interactive element (UX issue)Auto
js_error
Fired when a JavaScript error occursAuto
custom
Fired via pipetrace.track()Manual
goal
Fired via pipetrace.goal()Manual
revenue
Fired via pipetrace.revenue()Manual
identify
Fired via pipetrace.identify()Manual

Automatic Event Details

pageview

Fired when a user visits a page

All base fields

page_exit

Fired when user leaves a page (includes engagement data)

time_on_pagescroll_depthengagement_scoreis_bounceweb_vitals_*

scroll

Fired at 25%, 50%, 75%, and 100% scroll milestones

event_depth (25 | 50 | 75 | 100)

outbound_click

Fired when user clicks a link to another domain

event_urlevent_hostnameevent_text

file_download

Fired when user clicks a download link (pdf, zip, etc.)

event_urlevent_filenameevent_extension

form_start

Fired when user focuses on a form field

event_form_idevent_form_nameevent_form_action

form_submit

Fired when user submits a form

event_form_idevent_form_nameevent_time_to_submitevent_fields_filled

rage_click

Fired when user clicks rapidly in the same area (frustration signal)

event_xevent_yevent_element

dead_click

Fired when user clicks on non-interactive element (UX issue)

event_xevent_yevent_elementevent_expected

js_error

Fired when a JavaScript error occurs

event_messageevent_filenameevent_linenoevent_colnoevent_stack

JavaScript API

Use the global pipetrace object to fire custom events:

pipetrace.track(name, properties)

Track a custom event with optional properties.

// Track a button click
pipetrace.track('button_click', {
  button_id: 'cta-signup',
  button_text: 'Start Free Trial'
});

// Track a video play
pipetrace.track('video_play', {
  video_id: 'intro-video',
  duration: 120
});

pipetrace.goal(name, value)

Track a goal or conversion with optional numeric value.

// Track a signup
pipetrace.goal('signup');

// Track a subscription with value
pipetrace.goal('subscription', 29.99);

pipetrace.revenue(amount, currency, orderId)

Track revenue from a purchase.

// Track a purchase
pipetrace.revenue(99.99, 'USD', 'order-12345');

// Track with default currency (USD)
pipetrace.revenue(49.99);

pipetrace.identify(userId, traits)

Associate the current visitor with a user ID (optional, for logged-in users).

// Identify a logged-in user
pipetrace.identify('user-123', {
  plan: 'pro',
  company: 'Acme Inc'
});

Privacy Note: User identification is optional and opt-in. Only use this if you need to tie analytics to user accounts.

Debug Methods

These methods are useful for debugging in development:

// Get current Web Vitals values
pipetrace.getWebVitals();
// Returns: { lcp: 1234, fid: 12, inp: 89, cls: 0.05, fcp: 890, ttfb: 150 }

// Check event queue status
pipetrace.getQueueStatus();
// Returns: { pending: 0, processing: false }