Interface TrackingEventBase

Common envelope fields present on every event.

interface TrackingEventBase {
    customerId?: string;
    eventId?: string;
    sessionId?: string;
    ts?: number;
    visitorId: string;
}

Properties

customerId?: string

Opaque customer id when the visitor is signed in.

eventId?: string

Client-generated UUID. Enables downstream dedup — reuse on retries.

sessionId?: string

Rolling session id (30 min inactivity window).

ts?: number

Client timestamp (ms epoch). Accepted within ±48h of receipt.

visitorId: string

Pseudonymous visitor id (first-party cookie). Required.