Configuration

Takt se configure de deux façons équivalentes : par attributs data-* sur la balise du snippet (CDN), ou par options de init() (npm). Les deux pilotent les mêmes réglages.

Options data-* (snippet)

Détail des réglages

• data-domain : toujours le renseigner explicitement. Sans lui, Takt déduit le domaine de location.hostname, ce qui casse l’agrégation si ton site répond sur plusieurs hôtes (www, préprod, domaine de test).
• data-script-origin / data-endpoint : par défaut, les events partent vers https://taktlytics.com/api/event. data-script-origin remplace l’origine dont l’endpoint est dérivé ({origin}/api/event) quand tu sers Takt depuis ton propre domaine ; data-endpoint fixe l’URL complète et l’emporte sur data-script-origin. Pour un proxy first-party servi sur la même origine que ta page, passe explicitement data-endpoint="/api/event". Voir Proxy first-party.
• Captures automatiques (clics sortants, téléchargements, événements déclarés en HTML et 404) ne font pas partie du snippet minimal : ils vivent dans le bundle takt.auto.js et s’activent via data-auto (voir plus bas).
• data-exclude-localhost : activé par défaut. Passe "false" pour mesurer aussi localhost et les IP privées.
• data-enabled="false" est un coupe-circuit total : aucun écouteur n’est attaché et rien n’est jamais envoyé.
• Vie privée & échantillonnage : le snippet respecte Do Not Track et Global Privacy Control (en-tête Sec-GPC / navigator.globalPrivacyControl) et strippe la query string par défaut. Ajuste-les sur la balise : data-respect-dnt="false" (désactive le garde-fou DNT côté client ; les en-têtes DNT et GPC restent rejetés à l’ingestion), data-sample-rate="0.5" (n’envoie qu’une fraction des events), data-track-query (garde toute la query + le hash), data-query-params="utm_source,utm_medium" (ne garde qu’une allowlist). Mêmes sémantiques que les options npm ci-dessous.

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

Captures automatiques (data-auto)

Le snippet minimal takt.js ne mesure que les pages vues. Les captures automatiques (clics sortants, téléchargements, événements déclarés en HTML et 404) vivent dans le bundle takt.auto.js et sont toutes opt-in via l’attribut data-auto, qui prend une liste séparée par des virgules.

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

Options init() (npm)

En version npm, ces mêmes réglages se passent en objet à init() (en camelCase pour les booléens) :

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

init({
  domain: 'exemple.fr',   // requis en pratique
  outbound: true,         // suit les liens sortants
  files: true,            // suit les téléchargements
  excludeLocalhost: true, // défaut
  respectDnt: true        // défaut
})

init() crée une instance partagée, déclenche un pageview automatique et câble la navigation SPA. Appelle-le une seule fois, au démarrage de l’application.

Sans endpoint ni scriptOrigin, les events partent vers https://taktlytics.com/api/event. Passe endpoint: '/api/event' si tu proxifies Takt sur la même origine que ta page, ou scriptOrigin: 'https://exemple.fr/_takt' pour dériver l’endpoint d’une autre origine.

Options avancées

Elles ajustent la vie privée, l’échantillonnage et l’autocapture. enabled, sampleRate, trackQuery et queryParams ont aussi une forme snippet data-* (ci-dessus), et tagged / notFound une forme data-auto ; redactRoutes a une forme data-redact-routes sur takt.auto.js ; debug, scrubUrl, exclude, routeTemplates et routeTemplate sont réservés à npm (le snippet minimal ≤ 1 kB ne les embarque pas).

Par défaut, la query string et le hash sont strippés de toutes les URLs avant l’envoi. trackQuery/queryParams/scrubUrl (npm) ou data-track-query/data-query-params (snippet) permettent de l’ajuster. Voir Vie privée.

Le chemin, lui, part en clair : /verify/abc123 transmet le jeton. redactRoutes remplace le chemin des routes listées par leur motif, et routeTemplates envoie toutes les pages sous forme de gabarit, au prix des statistiques par page d’un site public. Le snippet minimal takt.js ne les gère pas, et takt.auto.js ne propose que redactRoutes, via data-redact-routes. Voir Masquage de routes.