Autocapture Metrics

Comprehensive guide to Statsig's autocapture functionality for web analytics, including automatically captured events, metadata attributes, and configuration options.

The JavaScript, React, and Angular SDKs support autocapture, which automatically captures events and their attributes without requiring you to manually instrument your code.

Attributes captured

Common metadata (on all events)

Statsig automatically captures comprehensive metadata with each autocapture event to provide rich context for analysis:

To filter events, you can use the eventFilterFunc option when initializing the Statsig client.
To sanitize events and their metadata, listen for the pre_logs_flushed client event and modify the event object before Statsig sends it. (Refer to Client Event Emitter for more details.)

Page and environment metadata

Property	Description
`metadata.title`	Page title from `<title>` tag
`metadata.current_url`	Full current URL
`metadata.hostname`	Domain name of the current page
`metadata.pathname`	Path portion of the URL
`metadata.user_agent`	Browser user agent string (truncated to 200 chars)
`metadata.locale`	Browser language setting
`metadata.timezone`	User's timezone
`metadata.timezone_offset`	Timezone offset in minutes
`metadata.timestamp`	Event timestamp in milliseconds

Screen and viewport data

Property	Description
`metadata.screen_width`	Screen width in pixels
`metadata.screen_height`	Screen height in pixels
`metadata.viewport_width`	Browser viewport width in pixels
`metadata.viewport_height`	Browser viewport height in pixels

Network information

Property	Description
`metadata.effective_connection_type`	Connection speed estimate
`metadata.rtt_ms`	Round-trip time in milliseconds
`metadata.downlink_mbps`	Download speed in Mbps
`metadata.save_data`	Whether user has data saver enabled

Referrer and traffic source data

Property	Description
`metadata.referrer`	Full referrer URL
`metadata.referrer_domain`	Domain of the referrer
`metadata.referrer_path`	Path of the referrer URL
`metadata.searchEngine`	Detected search engine
`metadata.searchQuery`	Search query from referrer

Campaign and marketing attribution

Statsig automatically captures 25+ marketing attribution parameters including:

Property	Description
`metadata.utm_source`	UTM source parameter
`metadata.utm_medium`	UTM medium parameter
`metadata.utm_campaign`	UTM campaign parameter
`metadata.utm_term`	UTM term parameter
`metadata.utm_content`	UTM content parameter
`metadata.utm_id`	UTM ID parameter
`metadata.gclid`	Google Click ID
`metadata.fbclid`	Facebook Click ID
`metadata.msclkid`	Microsoft Bing Click ID
`metadata.ttclid`	TikTok Click ID
`metadata.li_fat_id`	LinkedIn Click ID
`metadata.epik`	Pinterest Click ID

Additional platform IDs captured:

gclsrc, wbraid, gad_source (Google)
dclid (DoubleClick)
irclid (Impact)
igshid (Instagram)
_kx (Klaviyo)
mc_cid, mc_eid (Mailchimp)
qclid (Quora)
rdt_cid (Reddit)
sccid (Snapchat)
ttc, ttc_id (TikTok)
twclid (Twitter)

Action events (click, form submit, etc.)

Property	Description
`tagName`	The HTML tag of the clicked element
`classList`	The list of CSS classes on the clicked element
`class`	The class attribute of the clicked element
`id`	The ID attribute of the clicked element
`ariaLabel`	The aria-label attribute of the clicked element
`selector`	A CSS selector that uniquely identifies the clicked element

Depending on the event element, the following properties may be captured:

action
method
formName
formId
href
content
inputName
textContent
selectedText ...and more

Page view events

PageViewStart:

Property	Description
`last_page_view_url`	The URL of the last page view

PageViewEnd:

Property	Description
`page_view_length`	The length of the page view in milliseconds
`lastScrollY`	The last scroll position in pixels
`maxScrollY`	The maximum scroll position reached during the page view in pixels
`lastScrollPercentage`	The last scroll percentage (0-100) of the page
`maxScrollPercentage`	The maximum scroll percentage reached during the page view (0-100)
`scrollDepth`	The scroll depth percentage (0-100) - deprecated, use maxScrollPercentage instead
`dueToInactivity`	Whether the page view ended due to inactivity

Dead click events

Property	Description
`scrollTimeout`	Boolean indicating if a scroll timeout occurred
`selectionChangeTimeout`	Boolean indicating if a selection change timeout occurred
`mutationTimeout`	Boolean indicating if a mutation timeout occurred
`absoluteTimeout`	Boolean indicating if an absolute timeout occurred
`scrollDelayMs`	The number of milliseconds to wait before considering a scroll event as a dead click
`selectionChangeDelayMs`	The number of milliseconds to wait before considering a selection change event as a dead click
`mutationDelayMs`	The number of milliseconds to wait before considering a mutation event as a dead click
`absoluteDelayMs`	The number of milliseconds to wait before considering an absolute timeout event as a dead click

Rage click events

Property	Description
`x`	The x-coordinate of the rage click
`y`	The y-coordinate of the rage click
`timestamp`	The timestamp of the rage click in milliseconds

Web vitals events

Property	Description
`name`	The name of the web vital ('CLS', 'FCP', 'LCP', 'TTFB')
`value`	The current measurement value (e.g., milliseconds for LCP, FCP, etc.; a numeric score for CLS)
`delta`	The change from the previously reported value, used to calculate cumulative values over time
`id`	The ID of the web vital event

Console log events

Property	Description
`status`	The status of the console log ('debug', 'info', 'warn', 'error')
`log_level`	The level of the console log ('debug', 'info', 'log', 'warn', 'error')
`payload`	The payload of the console log (array of strings)
`timestamp`	The timestamp of the console log in milliseconds (epoch time)
`trace`	A stack trace (if available) showing where in the code the console log was triggered (array of strings)
`source`	The source of the console log ('js-auto-capture')

Query parameters

All URL query parameters are automatically captured as individual metadata fields with their parameter names as keys.

Was this helpful?