SarutobiDocumentation

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-pageviewfalsepour n'envoyer que des pageviews manuels.
  • data-exclude — motifs glob séparés par des virgules, ignorés côté client.
  • data-enabledtrue pour collecter même en local.
  • data-debug — trace chaque event dans la console.

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.jsest 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.