takt

FAQ & dépannage

Les questions les plus fréquentes, et comment diagnostiquer un problème de mesure.

Je ne vois aucune donnée

Dans l’ordre, vérifie :

  1. Tu testes en local. localhost et les IP privées sont exclus par défaut. Teste sur un domaine public, ou désactive le garde-fou (data-exclude-localhost="false").
  2. Do Not Track est actif dans ton navigateur. Désactive-le, ou teste dans un autre navigateur.
  3. Tu as fait opt-out. Vérifie localStorage.getItem('takt_ignore') — s’il vaut '1', fais localStorage.removeItem('takt_ignore') (ou optIn() en npm).
  4. Le data-domain ne correspond pas à celui de ton tableau de bord. Les events arrivent mais sont rattachés à un autre site.
  5. Le script ne charge pas. Onglet Réseau → cherche takt.js (statut 200) puis les POST vers /api/event.
Test rapide depuis la console : window.takt('debug_test'). Si tu vois un POST /api/event partir, l'intégration fonctionne.

Un bloqueur de pub peut-il empêcher la mesure ?

Oui. Certaines listes bloquent les scripts d’analytics. Comme Takt n’utilise ni cookie ni donnée personnelle, tu peux auto-héberger le script ou le servir depuis ton propre domaine via data-endpoint pour réduire le blocage.

Ma SPA ne compte qu’une seule page vue

init() (et le snippet) suivent la navigation via l’History API (pushState/popstate), ce qui couvre la quasi-totalité des routeurs. Le nom pageview étant réservé, le global window.takt('pageview') est ignoré : il n’y a rien à câbler côté snippet.

En intégration npm, si tu dois forcer une page vue (routeur exotique), utilise la fonction dédiée :

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

pageview()

Faut-il une bannière de consentement ?

Takt ne dépose pas de cookie et ne traite pas de donnée personnelle, ce qui évite la bannière dans la plupart des cas. Vérifie toujours ta situation légale : tu restes responsable de la conformité de ton site.

Le script ralentit-il mes pages ?

Non. Il pèse ≈ 2,5 kB gzip, se charge en defer (jamais bloquant) et n’exécute aucun travail lourd. Aucun impact mesurable sur le Largest Contentful Paint.

Puis-je épingler une version ?

Oui, dans l’URL du CDN : @vskstudio/[email protected]/dist/takt.js. Recommandé en production pour éviter toute surprise lors d’une mise à jour.

Toujours bloqué ?

Le code du SDK est public : tu peux l’inspecter et ouvrir une issue sur GitHub.