# ClickClacks docs

> Install the ClickClacks tracker, send custom events, identify people, track from your servers, connect Claude or Codex over MCP, and see what is collected.

- Canonical URL: https://clickclacks.io/docs
- Section: Get started
- Last updated: 2026-10-17

Every docs page is also available as Markdown: add `.md` to its URL. The whole set is in one file at https://clickclacks.io/llms-full.txt, and an index at https://clickclacks.io/llms.txt.

## Get started

- [Quickstart](https://clickclacks.io/docs/quickstart.md): From a new project to your first insight in five minutes.

## Walkthroughs

- [All walkthroughs](https://clickclacks.io/docs/walkthroughs.md): One goal, from zero to an answered question.
- [Your first custom events](https://clickclacks.io/docs/walkthroughs/first-events.md): Install, name, send and check your first events.
- [Server-side with Node](https://clickclacks.io/docs/walkthroughs/node.md): Track from an Express API and a serverless function.
- [Server-side with Laravel](https://clickclacks.io/docs/walkthroughs/laravel.md): Track from a Laravel app with the PHP SDK.
- [One person, browser and backend](https://clickclacks.io/docs/walkthroughs/one-person.md): Identity stitching end to end, and its pitfalls.
- [Any language over HTTP](https://clickclacks.io/docs/walkthroughs/http.md): curl, dry runs, errors, strict mode and retries.
- [Where do signups drop off?](https://clickclacks.io/docs/walkthroughs/activation-funnel.md): An activation funnel, broken down, saved and on a board.
- [Are users coming back?](https://clickclacks.io/docs/walkthroughs/retention.md): Read a retention grid and compare cohorts.
- [Where do our best users come from?](https://clickclacks.io/docs/walkthroughs/acquisition.md): Referrers, UTM tags, channels and segments.
- [Design a tracking plan](https://clickclacks.io/docs/walkthroughs/tracking-plan.md): What to track, what to call it, and the hand-off.
- [Weekly reporting](https://clickclacks.io/docs/walkthroughs/weekly-reporting.md): A board, alerts and a Monday routine.

## Examples

- [All examples](https://clickclacks.io/docs/examples.md): Concrete questions, with the code and the clicks to answer them.
- [Marketing site](https://clickclacks.io/docs/examples/marketing-site.md): Book a demo, FAQs, pricing, links, video, scroll depth and 404s.
- [Forms and leads](https://clickclacks.io/docs/examples/forms.md): Form drop-off and newsletter sign-ups.
- [SaaS app](https://clickclacks.io/docs/examples/saas-app.md): Feature use, first-time use and in-app clicks.

## Tracking

- [Install the tracker](https://clickclacks.io/docs/install.md): One script tag, and where it goes in every framework.
- [Autocapture](https://clickclacks.io/docs/autocapture.md): Pageviews, clicks and scroll depth, and what is never captured.
- [Custom events](https://clickclacks.io/docs/events.md): Send your own events, with properties and good names.
- [Identify people](https://clickclacks.io/docs/identify.md): Tie a visitor to your user ID, and reset on sign-out.
- [Companies and groups](https://clickclacks.io/docs/groups.md): Count companies as well as people: the group call, traits and Count by.
- [Single-page apps](https://clickclacks.io/docs/single-page-apps.md): How route changes become pageviews.
- [Consent and opt-out](https://clickclacks.io/docs/consent.md): Opt-out and opt-in modes, consent banners and GPC.
- [Domains and identity](https://clickclacks.io/docs/domains.md): Allowed domains and one person across them.
- [Custom domain](https://clickclacks.io/docs/custom-domain.md): Serve the tracker from a subdomain of your own.
- [Heatmap capture](https://clickclacks.io/docs/heatmap-capture.md): How pages are captured, and how to mask them.
- [Debugging](https://clickclacks.io/docs/debugging.md): Check events arrive, and fix the usual problems.

## Server-side

- [Overview and keys](https://clickclacks.io/docs/server-side.md): Why send from your backend, and how server keys work.
- [Send events](https://clickclacks.io/docs/api.md): POST /api/v1/batch: batches, retries, limits and errors.
- [Identity from the server](https://clickclacks.io/docs/server-identity.md): Identify from your backend and join browser history.

## SDKs

- [Node.js](https://clickclacks.io/docs/node.md): @clickclacks/node for Node, serverless and Workers.
- [PHP and Laravel](https://clickclacks.io/docs/php.md): clickclacks/clickclacks-php, with a Laravel facade.
- [React Native and Expo](https://clickclacks.io/docs/mobile.md): @clickclacks/react-native for iOS and Android apps, and HTTP for native apps.
- [Any language](https://clickclacks.io/docs/http.md): curl, Python, Go and Ruby over plain HTTP.

## Integrations & AI

- [MCP server](https://clickclacks.io/docs/mcp.md): Ask your analytics from Claude, Codex or Cursor.

## Product guides

- [All product guides](https://clickclacks.io/docs/guides.md): How to read and use each report.
- [Recipes](https://clickclacks.io/docs/guides/recipes.md): Real questions, answered step by step.
- [Filters, dates and comparisons](https://clickclacks.io/docs/guides/filters.md): The filter bar on every ClickClacks report: date ranges and time zone, sources, segments, property filters, visit referrer and UTM, Compare and freshness.
- [Overview report](https://clickclacks.io/docs/guides/overview.md): Read the ClickClacks Overview: active people, pageviews, sessions, bounce rate and average duration, plus the top pages, referrers and countries.
- [Realtime](https://clickclacks.io/docs/guides/realtime.md): Use ClickClacks Realtime: people on your site right now, the live activity feed, active pages, where people arrive from, countries, and Compare to yesterday.
- [Heatmaps](https://clickclacks.io/docs/guides/heatmaps.md): Use ClickClacks heatmaps: page grouping, devices, click maps, scroll depth, elements, friction on the page, comparing two periods, and capture and masking.
- [Insights](https://clickclacks.io/docs/guides/insights.md): Build ClickClacks Insights: chart any event over time by counts, unique people, sessions or property math, split it by a breakdown, and combine with formulas.
- [Funnels](https://clickclacks.io/docs/guides/funnels.md): Build and read ClickClacks funnels: steps and step filters, conversion window, order and counting, the three result views, drop-off details and breakdowns.
- [Flows](https://clickclacks.io/docs/guides/flows.md): Use ClickClacks Flows to see the paths people take before and after any event: anchor, direction, steps, path window, sampling and turning a path into a funnel.
- [Retention](https://clickclacks.io/docs/guides/retention.md): Read ClickClacks retention: the retention definition, daily, weekly and monthly cohorts, the grid and curve, the two retained rules and minimum cohort size.
- [Friction](https://clickclacks.io/docs/guides/friction.md): How ClickClacks finds friction: rage clicks, dead clicks and abandoned retries detected every night, reading a finding, muting it, and measuring a fix.
- [Friction investigator](https://clickclacks.io/docs/guides/friction-investigator.md): Ask the ClickClacks friction investigator about a finding in plain language: what it can look at, how it cites evidence, question limits and good questions.
- [Alerts](https://clickclacks.io/docs/guides/alerts.md): Set up ClickClacks alerts: what you can watch, sensitivity, how the expected range is learned from the same weekday, email recipients, and muting an alert.
- [Experiments](https://clickclacks.io/docs/guides/experiments.md): Analyze A/B tests in ClickClacks: forward exposures from your flag tool, map variants, set a success metric and guardrails, and read always-valid intervals.
- [Boards](https://clickclacks.io/docs/guides/boards.md): Build ClickClacks boards: start from a template, add linked and standalone tiles, set board filters and defaults, arrange, annotate and drill into a tile.
- [Segments](https://clickclacks.io/docs/guides/segments.md): Build ClickClacks segments: behaviour and person-property conditions, sequences, live segments and snapshots, and comparing segments in funnels and retention.
- [Lexicon](https://clickclacks.io/docs/guides/lexicon.md): Keep ClickClacks data tidy with Lexicon: describe, tag, verify and hide events and properties, set property types, and merge duplicate event names.
- [People and profiles](https://clickclacks.io/docs/guides/people.md): Find people in ClickClacks, read a person’s profile and activity, see their identity across devices and domains, and merge or unmerge two records.
- [Events explorer](https://clickclacks.io/docs/guides/events.md): Query raw events in ClickClacks: pick an event and filters, choose columns, inspect a row, follow a live tail, export CSV and move with keyboard shortcuts.
- [Sources](https://clickclacks.io/docs/guides/sources.md): Add and run ClickClacks sources: websites, web apps, mobile apps and servers, installing the snippet, server keys, collection health and source settings.
- [Identity](https://clickclacks.io/docs/guides/identity.md): Keep one person as one person across your domains in ClickClacks: carrying identity between listed domains, the carry-over measure, and identify and merges.
- [Custom domain](https://clickclacks.io/docs/guides/custom-domain.md): Serve the ClickClacks tracker from a subdomain you own: pick a subdomain, add one CNAME record, follow the setup states, update your snippet and move sources.
- [Members and roles](https://clickclacks.io/docs/guides/members.md): Bring your team into ClickClacks: invite people, the Owner, Admin and Member roles, custom roles, suspending and removing members, and who can change settings.
- [Agencies](https://clickclacks.io/docs/guides/agencies.md): Run analytics for many clients in ClickClacks: the agency home, a project per client, switching projects, staff access, the alerts inbox and agency MCP keys.
- [Weekly digest](https://clickclacks.io/docs/guides/weekly-digest.md): The ClickClacks weekly digest: one email every Monday at 08:00 with each project’s visitors, biggest change, firing alerts and stopped sources.
- [Traces and model prices](https://clickclacks.io/docs/guides/traces.md): Track your AI agent runs in ClickClacks: send $agent_run and $agent_step events, read runs, steps, outcomes, durations and cost, and set model prices.

## Data & privacy

- [What’s collected](https://clickclacks.io/docs/privacy.md): What the tracker stores, sends and strips.
- [Retention and deletion](https://clickclacks.io/docs/data.md): IP addresses, retention, export, deletion, GDPR and what AI features send.

## Reference

- [Tracker API](https://clickclacks.io/docs/tracker-api.md): Every command and script attribute.
- [Events and properties](https://clickclacks.io/docs/properties.md): Every $ event and property, and what it means.
- [Limits](https://clickclacks.io/docs/limits.md): Every limit, in one table.
- [Glossary](https://clickclacks.io/docs/glossary.md): The words ClickClacks uses, defined.