> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Track clicks, sign-ups, and purchases with custom events

> Custom events measure the actions that matter on your site, such as clicks, scrolls, sign-ups, and purchases. Learn how to send them and read the report.

Page views tell you who came. Custom events tell you what they did. In Radar, a custom event is an action you decide to measure: a click on a button, a sign-up, a form sent, a purchase.

## What you can track

* **Clicks** on your buttons, links, and interactive elements.
* **Scrolling**: how far your visitors scroll on each page.
* **Sign-ups and submissions**: sign-ups to your app and forms sent on your site.
* **Conversion per event**: the conversion rate tied to each event you track.

## Send an event from your site

You manage your events from the Custom Events block on the Radar overview. To record an action that happens in your own code, your developer calls `visitors.track` with the name of the event, and any details worth keeping:

```javascript theme={null}
visitors.track("signup", {
  plan: "pro",
});
```

Pick short, stable names such as `signup` or `add_to_cart`, and keep them the same over time. The report groups events by name.

> [!TIP]
>
> The step-by-step guide for developers is in the documentation inside your Radar dashboard, under custom event tracking.

## Read the events report

Each line of the report is one event:

| Column | What it means |
| - | - |
| Event name | The name you gave the event. |
| People | The number of different visitors who triggered it. |
| Events | The total number of times it was triggered. One visitor can trigger the same event several times. |

If Events is much higher than People, the same visitors repeat the action. If the two are close, each visitor does it about once.

## Good to know

* Custom events are the building blocks of [funnels](https://docs.taap.it/help/radar/features/funnels.md).
* A custom event can carry a visitor's email, which identifies them. See [identify visitors](https://docs.taap.it/help/radar/features/identify-visitors.md).
* Custom events depend on your plan, and every event counts toward your monthly events. See [taap.it/pricing](https://taap.it/pricing).

No event showing up at all? First [check your installation](https://docs.taap.it/help/radar/check-your-installation.md): the Radar script has to be on the right site, and page views have to arrive. If page views arrive and your events do not, contact support from the chat in your dashboard or at [support@taap.it](mailto:support@taap.it).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.