takt

Extensions automatiques

Le bundle takt.auto.js mesure quatre comportements courants sans une ligne de code : clics sortants, téléchargements de fichiers, erreurs 404 et événements déclarés en HTML. Tu actives uniquement ce dont tu as besoin via l’attribut data-auto.

Installation

Remplace takt.js par takt.auto.js et liste les extensions voulues dans data-auto :

<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>
Sans data-auto, takt.auto.js se comporte exactement comme takt.js : un pageview, rien de plus. Chaque extension est opt-in. Si tu ne veux que les pages vues, garde takt.js (< 1 Ko).

Les quatre extensions

Valeur data-autoÉvénement envoyéPropriété
outboundOutbound Link: Clickurl (href absolu)
downloadsFile Downloadurl (href absolu)
404404path (chemin de la page)
taggedlibre (voir ci-dessous)via data-takt-prop-*

Clics sortants & téléchargements

Tout clic sur un lien <a href> est analysé : un lien vers un autre domaine émet Outbound Link: Click, un lien pointant vers un fichier connu émet File Download. Les clics molette / nouvel onglet sont couverts, et l’envoi est garanti même quand la navigation quitte la page.

Liste d’extensions par défaut : pdf, xlsx, docx, pptx, csv, zip, gz, rar, 7z, dmg, exe, apk, mp3, mp4, wav, mov, avi, mkv, txt. Surcharge-la avec data-downloads-ext :

<script defer src="…/takt.auto.js" data-domain="exemple.fr"
  data-auto="downloads" data-downloads-ext="pdf,csv,epub"></script>

Tagged events (événements en HTML)

Ajoute data-takt-event à n’importe quel élément cliquable pour envoyer un événement nommé, sans JavaScript. Les attributs data-takt-prop-<clé> deviennent des propriétés.

<button data-takt-event="Cta" data-takt-prop-zone="hero">
  Démarrer
</button>

Le nom réservé pageview est refusé, comme avec window.takt(...).

Les valeurs data-takt-prop-* sont envoyées telles quelles. N'y place jamais de donnée personnelle (email, identifiant, nom) : réserve-les à des libellés non identifiants (zone, variante, catégorie).

Erreurs 404

La détection a lieu au chargement de la page, de façon hybride :

  • Code HTTP réel via la Navigation Timing API (Chrome/Edge récents) — zéro configuration sur une vraie page 404.
  • Repli par marqueur, pour Firefox/Safari et les pages d’erreur servies en HTTP 200 (rendues côté serveur) : ajoute data-takt-404 sur le <body> ou une balise <meta name="takt:404"> dans le <head> de ta page d’erreur.
<body data-takt-404>
  …ta page 404…
</body>

L’événement 404 (propriété path) n’est envoyé qu’une fois, au chargement.

La détection n'a lieu qu'au chargement initial. Pour une SPA dont la page « introuvable » est rendue après une navigation côté client, émets l'événement toi-même : window.takt('404', { props: { path: location.pathname } }).

Où retrouver ces données

Ce sont des événements nommés ordinaires : ils apparaissent dans les répartitions par propriété d’événement et peuvent servir de cible d’objectif. Aucune configuration de tableau de bord supplémentaire.

Et ensuite