# Autocapture Metrics

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](https://docs.statsig.com/client/javascript-sdk#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 |

Statsig may capture the following properties depending on the event element:

* `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

Statsig automatically captures all URL query parameters as individual metadata fields with their parameter names as keys.