Events

See custom events in Clics: Overview and AI Analytics Events cards, Event filter, Sessions timeline, and Pro access.

Custom events are actions you send with track() beyond automatic pageviews. There is no Events tab in the project nav: volume shows on Overview (and AI Analytics) as an Events card.

Send an event

import { track } from "@clicsdev/tracker";

track("signup", { plan: "pro" });
track("purchase", { amount: 49, currency: "USD" });

Full setup, properties, and SPA notes: Custom Events.

Where to see them

Place	What you get
Overview → Events card	Top event names with VISITORS (unique) and TOTAL (firings) for the date range
AI Analytics → Events card	Same card, scoped to the selected AI provider
Overview → Filter → Event	Scope KPIs and breakdowns to a specific event name
Sessions → Activity	Per-visit timeline with event name, path, and properties

Expand the card when there are more than a few rows. Empty (allowed): No data for this period.

The Overview card ranks by event name only, it does not break down by property. Inspect properties on a single visit under Sessions.

Plan requirement

The Events volume card is a Pro feature. Without it:

Title: No custom events
Body mentions upgrading to Pro
Upgrade to Pro → Settings → Billing
Learn more → this page

Creating an Event goal under Configure is not gated the same way: only the Events card is.

Event goals and funnels

Goal: Configure → Goals → type Custom event → exact event name. See Goals.
Funnel step: add an Event filter on a step. See Funnels.

Custom Events: install and track() API
Dashboard Overview
Goals
Sessions
AI Analytics