# Track the player actions that matter

> Send named events and scalar properties from your game and website. Follow launches, tutorial steps, level completes and purchases in one pipeline.

Canonical URL: https://manalens.dev/features/custom-events

Send named events and scalar properties from your game and your website. Follow launches, tutorial steps, level completes and purchases through the same pipeline.

[How to install](https://manalens.dev/docs/install)

## Define an event contract

Name events after completed actions, such as signup_completed or report_exported. Keep names stable and put varying context in properties. Supported values are strings, numbers, booleans, and null; nested objects are not part of the current browser contract.

Track actions after initializing the SDK

```
analytics.track('signup_completed', { plan: 'starter', method: 'email' });
analytics.track('purchase_completed', { revenue: 49, currency: 'USD' });
```

## Explore activity and trends

Search and filter the activity feed by event and request context. Use top events and date-ranged time series to inspect changes, then build ordered funnels or save a chart.

## Keep your properties intentional

Avoid passwords, form contents, access tokens, and unnecessary personal data. The SDK removes full page URL queries, but a property you explicitly send is still data you chose to collect.

## Keep event volume understandable

Accepted page and track events drive the reports. Plans are priced by monthly active users (MAU), not by events.

## Frequently asked questions

**Are pageviews automatic?**

Yes. By default the SDK sends the first page view, a page view when pushState or replaceState changes the path, and a page view after back and forward, when the router has changed the title. For a framework with its own page-load event, such as Astro View Transitions, set data-auto-pageviews="false" and call page() on that event.

**Can I attach a user ID?**

Call identify after login. Subsequent events carry the explicit user ID alongside the persistent anonymous ID.

**Can properties contain arbitrary objects?**

Use scalar properties. The current browser SDK does not support nested objects or arrays as event properties.

## Explore next

- [Install the SDK](https://manalens.dev/docs/install)
- [Game tracking plan](https://manalens.dev/blog/game-tracking-plan-first-events)
- [Funnels](https://manalens.dev/features/funnels)

Implementation reviewed 2026-11-18.
