Event schema¶
timestamp_ms counts milliseconds since the SDK started on the page (performance.now(), 0.1 ms resolution); it
is not wall-clock time. x and y are viewport CSS pixels.
modality |
event_type |
Fields | Notes |
|---|---|---|---|
keystroke |
keydown |
key_code key_char field_id |
Auto-repeats are recorded but keep the first press as the hold start. |
keystroke |
keyup |
key_code key_char hold_ms field_id |
hold_ms = release minus the first press of that key. |
keystroke |
input |
field_len field_id |
Length of the field's value after a change (0 to 100,000). The value never leaves the page. |
mouse |
move |
x y button=0 |
At most one per 16 ms. |
mouse |
down, up |
x y button |
button: 1 left, 2 right, 3 middle, -1 other. |
mouse |
scroll |
x y sensor_x sensor_y |
x, y = pointer position; sensor_x, sensor_y = wheel delta. At most one per 16 ms. |
touch |
start, move, end, cancel |
x y pressure sensor_x sensor_y |
One event per changed touch point; sensor_x, sensor_y = contact radius; pressure only where the device reports force. Moves at most one per 16 ms. |
Keep personal data out of field ids
field_id is the focused element's id, else its name, else its tag name, truncated to 64 characters, and it
is sent as is. Keep personal data out of element ids and names on monitored pages.