Installation du SDK Analytics
Integre le tracking analytics dans ton application en quelques lignes.
Prerequis
- Un compte Saasy avec le module Analytics active
- La cle d'integration (
appKey) de ton application, disponible dans Parametres > General
Mode 1 : Via le widget Feedback
Si tu utilises deja le widget Saasy Feedback, le SDK Analytics se charge automatiquement quand le module est active. Aucune configuration supplementaire n'est requise.
<script>
window.SaasyConfig = { embedKey: 'wgt_xxx', appKey: 'ik_xxx' };
</script>
<script async src="https://cdn.saasy.fr/widget.js"></script>Le widget detecte que le module Analytics est active et initialise le SDK en arriere-plan.
Mode 2 : Analytics seul (sans widget Feedback)
Si tu veux uniquement le tracking analytics sans le widget Feedback :
<script>
window.SaasyConfig = { appKey: 'ik_xxx' };
</script>
<script async src="https://cdn.saasy.fr/widget.js"></script>Le appKey correspond a la cle d'integration de ton app (prefixee ik_). Tu la trouves dans Parametres > General.
Configuration
La configuration du tracking se fait dans le dashboard Saasy, section Analytics > Configuration :
| Option | Defaut | Description |
|---|---|---|
trackPageViews | true | Suivi automatique des pages vues (SPA-compatible) |
trackClicks | true | Suivi des clics sur liens et boutons [data-track] |
trackForms | true | Suivi des soumissions de formulaires |
trackErrors | false | Capture des erreurs JavaScript et rejections non gerees |
trackWebVitals | false | Mesure des Core Web Vitals (LCP, FID, CLS, FCP, TTFB) |
respectDnt | true | Respecte le header Do Not Track du navigateur |
sessionTimeout | 30 | Timeout de session en minutes |
excludedPaths | [] | Chemins a exclure du tracking (ex: /admin) |
ipAnonymization | true | Anonymise les adresses IP |
Tracking automatique
Une fois installe, le SDK track automatiquement :
Pages vues
Chaque navigation declenche un evenement page_view. Le SDK est compatible SPA : il intercepte pushState, replaceState et popstate pour detecter les changements de route.
Clics
Les clics sur les elements <a href="..."> et <button data-track> sont traces automatiquement avec le texte, le tag et le href.
Formulaires
Les soumissions de formulaires (submit) sont tracees avec l'ID, le nom et l'action du formulaire.
Erreurs JavaScript
Si active, les erreurs non capturees et les unhandledrejection sont enregistrees.
Web Vitals
Si active, les Core Web Vitals sont mesures via PerformanceObserver :
| Metrique | Seuil "bon" | Seuil "a ameliorer" |
|---|---|---|
| LCP | ≤ 2500ms | ≤ 4000ms |
| FID | ≤ 100ms | ≤ 300ms |
| CLS | ≤ 0.1 | ≤ 0.25 |
| FCP | ≤ 1800ms | ≤ 3000ms |
| TTFB | ≤ 800ms | ≤ 1800ms |
Contexte enrichi
Chaque evenement est enrichi automatiquement avec :
- Page : URL, path, titre, referrer
- Device : type (desktop / tablet / mobile)
- Locale : langue du navigateur
- Timezone : fuseau horaire
- Ecran : largeur et hauteur
- UTM : parametres de campagne (
utm_source,utm_medium,utm_campaign,utm_term,utm_content)
Opt-out
Pour permettre a tes utilisateurs de desactiver le tracking :
window.Saasy.analytics.setOptOut(true);