Configuration

Takt is configured in two equivalent ways: via data-* attributes on the snippet tag (CDN), or via init() options (npm). Both drive the same settings.

data-* options (snippet)

Settings in detail

• data-domain — always set it explicitly. Without it, Takt infers the domain from location.hostname, which breaks aggregation if your site responds on several hosts (www, staging, test domain).
• data-script-origin / data-endpoint — by default, events are posted to https://taktlytics.com/api/event. data-script-origin replaces the origin the endpoint is derived from ({origin}/api/event) when you serve Takt from your own domain; data-endpoint sets the full URL and wins over data-script-origin. For a first-party proxy served on the same origin as your page, pass data-endpoint="/api/event" explicitly. See First-party proxy.
• Automatic capture — outbound clicks, downloads, HTML-declared events and 404s are not part of the minimal snippet: they live in the takt.auto.js bundle and are enabled through data-auto (see below).
• data-exclude-localhost — enabled by default. Pass "false" to also measure localhost and private IPs.
• data-enabled="false" — total kill-switch: no listener is attached and nothing is ever sent.
• Privacy & sampling — the snippet respects Do Not Track and Global Privacy Control (Sec-GPC header / navigator.globalPrivacyControl) and strips the query string by default. Tune these on the tag itself: data-respect-dnt="false" (opt out of the client-side DNT guard; the GPC signal stays enforced at ingestion), data-sample-rate="0.5" (send a fraction of events), data-track-query (keep the full query + hash), data-query-params="utm_source,utm_medium" (keep only an allowlist). Same semantics as the npm options below.

<script
  defer
  src="https://cdn.jsdelivr.net/npm/@vskstudio/takt-core/dist/takt.js"
  data-domain="example.com"
  data-query-params="utm_source,utm_medium"
></script>

Automatic capture (data-auto)

The minimal takt.js snippet only measures pageviews. Automatic capture — outbound clicks, downloads, HTML-declared events and 404s — lives in the takt.auto.js bundle and is entirely opt-in through the data-auto attribute, which takes a comma-separated list.

<script
  defer
  src="https://cdn.jsdelivr.net/npm/@vskstudio/takt-core/dist/takt.auto.js"
  data-domain="example.com"
  data-auto="outbound,downloads,tagged,404"
></script>

init() options (npm)

In the npm version, these same settings are passed as an object to init() (in camelCase for booleans):

import { init } from '@vskstudio/takt-core'

init({
  domain: 'example.com',  // required in practice
  outbound: true,         // tracks outbound links
  files: true,            // tracks downloads
  excludeLocalhost: true, // default
  respectDnt: true        // default
})

init() creates a shared instance, fires an automatic pageview and wires up SPA navigation. Call it only once, at application startup.

With neither endpoint nor scriptOrigin, events are posted to https://taktlytics.com/api/event. Pass endpoint: '/api/event' if you proxy Takt on the same origin as your page, or scriptOrigin: 'https://example.com/_takt' to derive the endpoint from another origin.

Advanced options

These tune privacy, sampling and autocapture. enabled, sampleRate, trackQuery and queryParams also have a snippet data-* form (above), and tagged / notFound a data-auto form; debug, scrubUrl and exclude are npm-only (the ≤ 1 kB minimal snippet does not carry them).

By default, the query string and hash are stripped from every URL before sending. trackQuery/queryParams/scrubUrl (npm) or data-track-query/data-query-params (snippet) tune it. See Privacy.