Default Properties

Overview

Cryptique automatically captures a rich set of properties on every event. These properties require no additional code and are available for filtering, breakdowns, and analysis.

Property Categories

Identifiers

Core identifiers attached to every event:

Property	Type	Description
`team_id`	string	Your Cryptique team identifier
`session_id`	string	Current session identifier
`session_db_id`	string	Internal session database ID
`user_id`	string	User identifier (if identified)
`distinct_id`	string	Unique user identifier
`user_identity_id`	string	Internal user identity ID
`website_id`	string	Site identifier

Event Metadata

Information about the event itself:

Property	Type	Description
`event_type`	string	`auto`, `custom`, or `transaction`
`event_name`	string	Name of the event
`event_category`	string	Event category grouping
`timestamp`	datetime	When the event occurred (ISO 8601)

Location

Geographic information derived from IP address:

Property	Type	Description	Example
`country`	string	Country code (ISO 3166-1)	`"US"`, `"GB"`, `"DE"`
`city`	string	City name	`"San Francisco"`
`region`	string	State/province/region	`"California"`
`latitude`	number	Approximate latitude	`37.7749`
`longitude`	number	Approximate longitude	`-122.4194`
`timezone`	string	User’s timezone	`"America/Los_Angeles"`

Location is approximate and based on IP geolocation. Users on VPNs may show different locations.

Device & Browser

Client environment information:

Property	Type	Description	Example
`browser_name`	string	Browser name	`"Chrome"`, `"Firefox"`, `"Safari"`
`browser_version`	string	Browser version	`"120.0.0"`
`os`	string	Operating system	`"Windows"`, `"macOS"`, `"iOS"`
`os_version`	string	OS version	`"14.2"`
`device_type`	string	Device category	`"desktop"`, `"mobile"`, `"tablet"`
`language`	string	Browser language	`"en-US"`, `"es-ES"`

Screen & Viewport

Display information:

Property	Type	Description	Example
`screen_height`	number	Screen height in pixels	`1440`
`screen_width`	number	Screen width in pixels	`2560`
`viewport_height`	number	Browser viewport height	`900`
`viewport_width`	number	Browser viewport width	`1200`
`dpi`	number	Device pixel ratio	`2` (Retina), `1` (standard)

Page & URL

Current page information:

Property	Type	Description	Example
`current_url`	string	Full page URL	`"https://app.example.com/swap?token=ETH"`
`page_title`	string	Page title	`"Swap Tokens \| Example DEX"`
`uri`	string	URL pathname	`"/swap"`
`referrer`	string	Previous page URL	`"https://app.example.com/pools"`
`initial_referrer`	string	First referrer in session	`"https://google.com/..."`

UTM Parameters

Campaign tracking (parsed from URL or session):

Property	Type	Description	Example
`utm_source`	string	Traffic source	`"twitter"`, `"google"`
`utm_medium`	string	Marketing medium	`"cpc"`, `"social"`, `"email"`
`utm_campaign`	string	Campaign name	`"summer_launch"`
`utm_term`	string	Paid search term	`"defi swap"`
`utm_content`	string	Content variant	`"banner_a"`
`utm_id`	string	Campaign ID	`"camp_12345"`

UTM Behavior:

Parsed from URL on page load
Inherited from session if not in current URL
New UTM parameters start a new session

Web3 Properties

Blockchain-related properties:

Property	Type	Description	Example
`is_web3_user`	boolean	Has connected a wallet	`true`
`wallet_address`	string	Currently connected wallet	`"0x1234..."`

Event-Specific Properties

Auto events attach a payload in addition to the default properties above. Names and shapes differ per event_name.

For the full list of auto events, when they fire, and privacy notes, see Auto-Events.

Examples (current SDK)

element_click — includes viewport and page coordinates, document dimensions, and element metadata such as element_tag_name, element_id, element_class, element_name, element_text (truncated), element_category, and click_coordinates. page_scroll — includes scroll_depth, max_scroll_reached, scroll_position, scroll_x / scroll_y, and document width/height. form_submit — includes form_id, form_action, form_method, scroll/page context, and element metadata for the form (not field values). copy_action — includes text_length and coarse element info (not full clipboard contents). page_summary — large aggregate object: e.g. move_grid, hover_grid, field_dwells, viewport_element_dwells, exit_type, performance fields, and more. Wallet connection is not an auto-event in the SDK; use Cryptique.walletAddress() and custom Cryptique.track() calls if you want explicit wallet lifecycle events in the event stream.

Using Default Properties

In Filters

Filter events by any default property:

Events where:
- country = "US"
- AND device_type = "mobile"
- AND utm_source = "twitter"

In Breakdowns

Break down metrics by default properties:

Page Views by:
- browser_name → Chrome: 60%, Safari: 25%, Firefox: 15%
- device_type → desktop: 70%, mobile: 28%, tablet: 2%
- country → US: 40%, GB: 15%, DE: 10%, ...

In Cohorts

Create segments using default properties:

Cohort: Mobile Social Traffic
Criteria:
- device_type = "mobile"
- AND utm_medium = "social"

Overriding Default Properties

Some properties can be overridden when tracking events:

// Override location for server-side events
Cryptique.track('server_event', {
  country: 'GB',
  city: 'London'
});

// Override page info for SPA
Cryptique.track('virtual_page_view', {
  current_url: '/app/dashboard',
  page_title: 'Dashboard'
});

Only override properties when you have accurate alternative data. Most use cases don’t require overrides.

Privacy Considerations

Default properties are designed with privacy in mind:

Property	Privacy Note
Location	Approximate (city-level), not precise
IP Address	Not stored or exposed
Form values	Not captured (only form metadata)
Copy / selection	Auto events use length caps and truncated text where applicable; disable `text_selection` or `copy_action` if needed

See Privacy & Compliance for more details.

Next Steps

Auto-Events

Full auto event catalog

Events & Properties

Custom properties guide

Filters & Operators

Use properties in queries

INTRO

DATA IN

DATA MODEL

BEST PRACTICES

Default Properties

Overview

Property Categories

Identifiers

Event Metadata

Location

Device & Browser

Screen & Viewport

Page & URL

UTM Parameters

Web3 Properties

Event-Specific Properties

Examples (current SDK)

Using Default Properties

In Filters

In Breakdowns

In Cohorts

Overriding Default Properties

Privacy Considerations

Next Steps

Auto-Events

Events & Properties

Filters & Operators

​Overview

​Property Categories

​Identifiers

​Event Metadata

​Location

​Device & Browser

​Screen & Viewport

​Page & URL

​UTM Parameters

​Web3 Properties

​Event-Specific Properties

​Examples (current SDK)

​Using Default Properties

​In Filters

​In Breakdowns

​In Cohorts

​Overriding Default Properties

​Privacy Considerations

​Next Steps

Auto-Events

Events & Properties

Filters & Operators

Overview

Property Categories

Identifiers

Event Metadata

Location

Device & Browser

Screen & Viewport

Page & URL

UTM Parameters

Web3 Properties

Event-Specific Properties

Examples (current SDK)

Using Default Properties

In Filters

In Breakdowns

In Cohorts

Overriding Default Properties

Privacy Considerations

Next Steps