Sans bundler

Pour un site statique, un CMS, ou tout ce qui n'a pas d'étape de build : une balise à coller avant la fermeture du <head>.

index.html

<script defer src="https://sarutobi.ascencia.re/s.js"
        data-site="st_live_8f3a1c9d2e4b6071"></script>

Attributs

data-site — la clé du site. Obligatoire.
data-host — instance de collecte, si vous en hébergez une autre.
data-auto-pageview — false pour n'envoyer que des pageviews manuels.
data-exclude — motifs glob séparés par des virgules, ignorés côté client.
data-enabled — true pour collecter même en local.
data-debug — trace chaque event dans la console.
data-autocapture — écoute les éléments marqués data-sarutobi, sans instrumentation JavaScript. Avec la valeur extended, décrit aussi les clics et soumissions sur les éléments interactifs non marqués. Désactivé par défaut.

Autocapture structuré

Avec data-autocapture, un élément portant data-sarutobi envoie un event de ce nom quand on le clique — ou quand le formulaire est soumis. Les attributsdata-sarutobi-* deviennent ses propriétés.

<button data-sarutobi="export_clique" data-sarutobi-format="png">
  Exporter
</button>

Rien d'autre n'est collecté : ni le texte de l'élément, ni la valeur d'un champ, ni les attributs que vous n'avez pas préfixés. Pour exclure une zone entière, posezdata-sarutobi-private sur un parent — il l'emporte sur tout marquage situé en dessous.

Events métier

Le script expose window.sarutobi une fois chargé.

<button onclick="sarutobi.capture('devis_demande', { formule: 'pro' })">
  Demander un devis
</button>

Cache

/s.js est mis en cache une heure seulement. C'est court, et c'est voulu : on doit pouvoir corriger un défaut de collecte sans attendre une semaine que les caches des visiteurs expirent.

Repli sans JavaScript

Pour un <noscript> ou une newsletter, un pixel accepte les mêmes champs en query string.

<noscript>
  <img src="https://sarutobi.ascencia.re/api/collect?k=st_live_8f3a1c9d2e4b6071&t=pageview&u=https%3A%2F%2Fexemple.fr%2F"
       alt="" width="1" height="1" />
</noscript>

Ce n'est pas le chemin nominal : sans JavaScript, ni la durée de visite, ni les Web Vitals, ni les erreurs ne remontent.