Installation rapide

Copiez ce code juste avant </head> :

<script src="https://votre-domaine.com/api/script/tk_VOTRE_ID"></script>

C'est tout ! Vos heatmaps et analytics commencent immédiatement.

Configuration

1. Allez dans Site → Webhooks
2. Entrez votre URL webhook (Zapier, Make.com, ou custom)
3. Choisissez vos événements : Anomalies, Rapports quotidiens, Insights
4. Sélectionnez le mode de confidentialité (Agrégé recommandé)
5. Testez avec le bouton "Tester"

Événements disponibles

{
  "event": "anomaly_detected",
  "timestamp": "2026-02-10T14:30:00Z",
  "anomaly": {
    "type": "js_error_spike",
    "severity": "critical",
    "deviation_percent": 598.4
  }
}

Modes de confidentialité

Validation signature HMAC

Tous les webhooks incluent un header X-Webhook-Signature. Validez-le pour garantir l'authenticité :

// PHP
$signature = $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'];
$payload = file_get_contents('php://input');
$secret = 'votre_webhook_secret';

$expected = hash_hmac('sha256', $payload, $secret);
if (!hash_equals($expected, $signature)) {
    die('Invalid signature');
}

Configuration en 3 étapes

Synchronisation automatique

L'Analyste synchronise automatiquement vos sources de trafic tous les jours à 7h.

Vous pouvez aussi déclencher une synchronisation manuelle :

• Depuis l'interface : bouton "Synchroniser maintenant"
• En ligne de commande : php artisan ga:sync-sources

Données importées

Vue d'ensemble

Le dashboard Traffic Sources combine le meilleur des deux mondes :

Métriques disponibles

Utilisation

1. Configurez d'abord GA4 (voir section précédente)
2. Attendez la première synchronisation (ou lancez manuellement)
3. Allez dans Site → Traffic Sources
4. Analysez quelle source génère le plus de frustration

Cas d'usage

Anonymisation complète

Conformité RGPD & Loi 25

L'Analyste respecte les réglementations les plus strictes :

Sécurité technique

HTTPS obligatoire

Toutes les communications utilisent TLS 1.3+ avec certificats valides.

Authentication HMAC

Le script dynamique utilise des tokens HMAC SHA-256 avec TTL 1h :

Token = base64(siteId | timestamp | hmac_sha256(siteId|timestamp, secret))
TTL = 3600 secondes
Origin validation = Referer + Origin headers

Rate Limiting

Protection contre les abus :

• API Tracking : 100 requêtes/min par site
• API Behavior : 60 requêtes/min par site
• Session Replay : 60 requêtes/min par session

Data Retention

Toutes les données sont automatiquement supprimées après 30 jours :

• Heatmap events
• Behavior events (rage/dead clicks, erreurs)
• Form analytics
• Session replays (fichiers + metadata)
• Custom events

Commande : php artisan events:cleanup (schedulée daily 1h)

Self-Hosting

L'Analyste peut être hébergé sur vos propres serveurs pour contrôle total :

• Laravel 11 (PHP 8.2+)
• MySQL/PostgreSQL
• Redis (optionnel pour cache)
• Code source disponible

Types de heatmaps

Visualisation

Les heatmaps s'affichent par-dessus une capture d'écran de votre page. Les couleurs indiquent l'intensité :

• Rouge : Zones très actives (80-100%)
• Orange : Zones actives (60-80%)
• Jaune : Zones moyennes (40-60%)
• Vert : Zones peu actives (20-40%)
• Bleu : Zones très peu actives (0-20%)

Utilisation

1. Allez dans Sites et cliquez sur un site
2. Cliquez sur Heatmaps dans la navigation
3. Sélectionnez une page dans la liste
4. Choisissez le type de heatmap (Click/Scroll/Hover)
5. Ajustez la période (7/14/30 jours)

Cas d'usage

• Optimiser les CTA : Vérifiez que vos boutons sont bien cliqués
• Détecter les zones mortes : Éléments cliquables ignorés
• Améliorer le layout : Placez le contenu important là où les gens regardent
• Mobile vs Desktop : Comparez le comportement par device

Configuration

Pour activer Session Replay :

1. Allez dans Sites → Éditer
2. Onglet Replay
3. Activez Session Replay
4. Réglez le taux d'échantillonnage (1-100%)
5. Durée max par session : 60-3600 secondes
6. Rétention : 1-90 jours

Fonctionnalités

Anonymisation

Les replays sont 100% anonymes :

• Tous les inputs sont masqués (***)
• Emails, téléphones automatiquement cachés
• IP hashées (impossible de retrouver)
• Session ID rotationnelle (30min max)
• Aucun cookie de tracking

Taux d'échantillonnage

Recommandations :

• 10-20% : Sites à fort trafic (10K+ sessions/jour)
• 50% : Sites moyens (1-10K sessions/jour)
• 100% : Sites à faible trafic ou debugging

Nettoyage automatique

La commande replay:cleanup s'exécute quotidiennement (4h) pour :

• Finaliser les replays "stale" (>30min)
• Supprimer les replays expirés (selon rétention)
• Nettoyer les dossiers vides

Types de comportements détectés

Score de frustration

Chaque session reçoit un score calculé ainsi :

Score = (rage_clicks × 3) + (dead_clicks × 2) + (js_errors × 1)

Interprétation :

• 0-5 : Session normale
• 6-15 : Frustration modérée
• 16+ : Frustration élevée

Dashboard Comportements

Accédez aux comportements via Site → Comportements.

Vous pouvez :

• Filtrer par type (rage/dead/error)
• Trier par score de frustration
• Voir la timeline d'une session
• Lancer le replay directement

Session Timeline

Cliquez sur une session pour voir la timeline complète avec :

• Timestamp de chaque événement
• Type d'événement (click/error/page change)
• Sélecteur CSS de l'élément
• Coordonnées x/y du clic
• Message d'erreur JS complet

Health Score

Chaque site reçoit un score de santé global (0-100) calculé à partir de :

• Taux de rage clicks
• Taux de dead clicks
• Taux d'erreurs JS
• Profondeur de scroll moyenne
• Temps moyen par session

Interprétation :

• 90-100 : Excellent
• 70-89 : Bon
• 50-69 : À améliorer
• 0-49 : Critique

Types d'insights

Configuration

Pour configurer les insights :

1. Allez dans Sites → Éditer
2. Onglet Analyse
3. Activez Smart Insights
4. Réglez la fréquence (quotidienne/hebdomadaire)
5. Ajustez les 3 seuils de détection

Actions disponibles

Pour chaque insight, vous pouvez :

• Résoudre : Marque comme corrigé (historisé)
• Ignorer : Ne plus afficher cet insight
• Snooze 7j : Reporter de 7 jours

Snapshots mensuels

L'Analyste crée automatiquement des snapshots mensuels avec :

• Health score du mois
• Évolution vs mois précédent (delta)
• Top 5 pages frustrantes
• Statistiques globales (sessions, clics, erreurs)

Commandes disponibles :

• php artisan insights:generate : Génère insights immédiatement
• php artisan insights:cleanup : Supprime insights résolus >90j

Créer un funnel

1. Allez dans Site → Funnels
2. Cliquez sur Créer un funnel
3. Donnez un nom (ex: "Parcours d'achat")
4. Ajoutez 2 à 10 étapes avec les URLs
5. Cliquez sur Créer

Exemple de funnel

Métriques calculées

Pour chaque étape, L'Analyste calcule :

• Taux de conversion global : % utilisateurs qui terminent
• Drop-off par étape : % d'abandons entre chaque étape
• Sessions uniques : Nombre de sessions passées par l'étape
• Temps moyen : Durée entre chaque étape

Regex et wildcards

Les URLs supportent les patterns :

• /products/.* : Tous les produits
• /blog/.*/comments : Pages de commentaires
• /checkout/step-[1-3] : Étapes 1 à 3

Cas d'usage

• E-commerce : Accueil → Produit → Panier → Paiement → Confirmation
• SaaS : Landing → Signup → Onboarding → Activation
• Blog : Accueil → Article → Inscription newsletter
• Formulaires : Étape 1 → Étape 2 → Étape 3 → Merci

Détection automatique

L'Analyste détecte automatiquement tous vos formulaires. Aucune configuration requise !

Événements trackés

Métriques par formulaire

• Taux de complétion : % soumissions vs. interactions
• Taux d'abandon : % abandons après focus
• Temps moyen : Durée focus → submit
• Champ problématique : Le plus abandonné

Métriques par champ

• Taux de remplissage : % champs remplis
• Temps passé : Durée focus → blur
• Refontes : Nombre de modifications
• Taux de correction : % users qui reviennent dessus

Anonymisation

L'Analyste respecte votre confidentialité :

• Aucune valeur n'est stockée
• Seulement metadata : field_name, field_type, interaction_type
• Durées agrégées
• Pas de keystroke logging

Exemple d'utilisation

Cas d'usage

• Inscription : Identifiez les champs trop complexes
• Checkout : Réduisez la friction au paiement
• Contact : Simplifiez les formulaires de contact
• Survey : Optimisez les questionnaires longs

Créer une alerte

1. Allez dans Site → Alertes
2. Cliquez sur Créer une alerte
3. Choisissez la métrique à surveiller
4. Définissez la condition (supérieur/inférieur)
5. Seuil numérique
6. Fenêtre de temps (5-60 minutes)
7. Canal de notification (email/webhook)

Métriques disponibles

Conditions et fenêtres

Vous pouvez définir :

• Condition : "supérieur à" ou "inférieur à"
• Seuil : Valeur numérique (ex: 10 pour 10 rage clicks)
• Fenêtre : Période d'évaluation (5/15/30/60 minutes)

Exemple d'alertes

Cooldown

Pour éviter le spam, chaque alerte a un cooldown de 60 minutes. Une fois déclenchée, elle ne se redéclenchera pas avant 1h même si la condition reste vraie.

Canaux de notification

• Email : Envoyé au propriétaire du site
• Webhook : Envoyé à l'URL configurée (Zapier, Slack, etc.)

Commande de vérification

La commande alerts:check s'exécute toutes les 5 minutes pour évaluer toutes les alertes actives.

API JavaScript

Après avoir installé le script de L'Analyste, utilisez window._ht_track() :

// Événement simple
window._ht_track('purchase_completed');

// Événement avec données
window._ht_track('add_to_cart', {
  product_id: 'SKU-12345',
  price: 49.99,
  currency: 'CAD',
  quantity: 2
});

// Événement d'erreur personnalisé
window._ht_track('api_error', {
  endpoint: '/api/products',
  status: 500,
  message: 'Internal Server Error'
});

Données stockées

Pour chaque custom event, L'Analyste stocke :

• event_name : Nom de l'événement
• event_data : Objet JSON avec vos données
• session_id : Session anonyme
• path : URL où l'événement s'est produit
• timestamp : Date/heure précise

Exemples d'utilisation

E-commerce

// Ajout au panier
window._ht_track('add_to_cart', { product: 'T-shirt XL', price: 29.99 });

// Achat
window._ht_track('purchase', { amount: 127.50, items: 3 });

// Abandon panier
window._ht_track('cart_abandoned', { cart_value: 89.99 });

SaaS

// Feature utilisée
window._ht_track('feature_used', { feature: 'export_pdf' });

// Upgrade plan
window._ht_track('plan_upgraded', { from: 'free', to: 'pro' });

// Onboarding complété
window._ht_track('onboarding_completed', { steps: 5, duration: 240 });

Médias

// Vidéo vue
window._ht_track('video_watched', { video_id: 'intro', percent: 87 });

// Article lu
window._ht_track('article_read', { article_id: 123, reading_time: 180 });

// Newsletter inscrit
window._ht_track('newsletter_signup', { source: 'footer' });

Dashboard Custom Events

Accédez aux custom events via Site → Custom Events.

Le dashboard affiche :

• Top 10 événements par volume
• Timeline des derniers événements
• Filtres par event_name et période
• Données JSON complètes pour chaque event

Anonymisation

L'Analyste valide automatiquement event_data et bloque tout PII :

• Emails détectés et rejetés
• Numéros de téléphone rejetés
• Numéros de carte bancaire rejetés
• Vos données métiers anonymes passent

Limites

• Rate limit : 100 événements/minute par site
• Taille max event_data : 10KB
• Rétention : 30 jours (comme tous les événements)

Authentification

Les points d'accès publics utilisent HMAC SHA-256 avec votre signing_secret.

// Format du jeton
Token = base64(siteId|timestamp|hmac_sha256)

// En-têtes requis
X-Site-Id: tk_xxxxx
X-Track-Token: {token_base64}
Origin: https://yourdomain.com

Points d'accès disponibles

POST /api/track

Envoie un événement de carte de chaleur (clic / survol).

{
  "site_id": "tk_xxxxx",
  "event_type": "click",
  "x": 450,
  "y": 320,
  "path": "/products/shoes",
  "selector": "button.add-to-cart",
  "viewport_width": 1920,
  "viewport_height": 1080,
  "device_type": "desktop"
}

POST /api/behavior

Envoie un événement de comportement (rage / dead / erreur).

{
  "site_id": "tk_xxxxx",
  "session_id": "sess_abc123",
  "type": "rage_click",
  "path": "/checkout",
  "selector": "button#submit-order",
  "x": 600,
  "y": 400,
  "metadata": {
    "clicks_count": 5,
    "duration_ms": 800
  }
}

POST /api/replay-events

Envoie des événements rrweb pour le rejeu de session.

{
  "site_id": "tk_xxxxx",
  "session_id": "sess_abc123",
  "events": [
    { "type": 2, "data": {...}, "timestamp": 1707580800000 },
    { "type": 3, "data": {...}, "timestamp": 1707580801000 }
  ]
}

POST /api/scroll

Envoie la profondeur de défilement maximale atteinte.

{
  "site_id": "tk_xxxxx",
  "session_id": "sess_abc123",
  "path": "/blog/article-123",
  "max_scroll_percent": 87,
  "viewport_height": 1080,
  "page_height": 4500
}

POST /api/form-events

Envoie des interactions avec les formulaires.

{
  "site_id": "tk_xxxxx",
  "session_id": "sess_abc123",
  "path": "/contact",
  "form_selector": "form#contact-form",
  "field_name": "email",
  "field_type": "email",
  "interaction_type": "blur",
  "time_spent_ms": 3200
}

POST /api/custom-events

Envoie des événements personnalisés.

{
  "site_id": "tk_xxxxx",
  "session_id": "sess_abc123",
  "path": "/checkout",
  "event_name": "purchase_completed",
  "event_data": {
    "amount": 127.50,
    "currency": "CAD",
    "items": 3
  }
}

Limites de débit

Codes de statut

• 200 OK : Événement enregistré avec succès
• 400 Bad Request : Données invalides ou information personnelle détectée
• 401 Unauthorized : Jeton HMAC invalide ou expiré
• 403 Forbidden : Origine non autorisée
• 429 Too Many Requests : Limite de débit dépassée
• 500 Internal Server Error : Erreur serveur

Exemple complet (cURL)

curl -X POST https://lanalyste.app/api/track \
  -H "Content-Type: application/json" \
  -H "X-Site-Id: tk_xxxxx" \
  -H "X-Track-Token: base64_token_here" \
  -H "Origin: https://yourdomain.com" \
  -d '{
    "site_id": "tk_xxxxx",
    "event_type": "click",
    "x": 450,
    "y": 320,
    "path": "/",
    "selector": "button.cta"
  }'

Questions fréquentes

Formats de domaine acceptés

Installation selon votre plateforme

<script src="https://votre-domaine.com/api/script/tk_xxxxx"></script>
</body>

Génération automatique

L'Analyste génère automatiquement des screenshots de vos pages pour afficher les heatmaps. Voici comment ça fonctionne :

Génération manuelle

Si vous avez modifié le design de votre site, vous pouvez forcer une régénération :

php artisan screenshot:capture --website-id=1 --path="/" --device=desktop

Bandeau de consentement

Collectez le consentement de vos visiteurs de manière conforme à la Loi 25 (Québec) avant d'activer le suivi.

Comment ça fonctionne

Le bandeau se charge avant le suivi et bloque tous les scripts d'analyse jusqu'au choix du visiteur :

1. Le visiteur arrive — le script de consentement se charge en premier.
2. Le bandeau s'affiche — avec les options que vous avez configurées.
3. Le visiteur choisit — tout accepter, tout refuser, ou personnaliser par catégorie.
4. Le choix est enregistré — dans le localStorage, et journalisé avec IP et horodatage.
5. Le suivi démarre, si consenti — les scripts d'analyse ne se lancent qu'en cas d'acceptation.

1. Activer le bandeau

1. Ouvrez votre site dans le tableau de bord.
2. Cliquez sur Consentement.
3. Cochez Activer le bandeau de consentement.
4. Configurez l'apparence et les textes.
5. Cliquez sur Enregistrer.

2. Personnaliser l'apparence

Un aperçu en direct est disponible pendant la configuration.

3. Configurer les catégories

4. Changer le script — étape obligatoire

<script src="https://lanalyste.app/api/script/tk_xxxxx"></script>

<script src="https://lanalyste.app/api/consent/tk_xxxxx"></script>

• Gardez le même identifiant tk_xxxxx — seul le chemin change.
• Le nouveau script gère le consentement automatiquement.
• Si le bandeau est désactivé, son comportement est identique à celui de l'ancien script.

5. Consulter les statistiques

Le bouton Statistiques de la page de configuration donne accès au taux d'acceptation sur les 30 derniers jours, réparti entre « tout accepté », « tout refusé » et « personnalisé », ainsi qu'au détail par catégorie. Les journaux sont exportables en CSV pour un audit.

Vérifier le consentement depuis vos scripts

// Vérifier si le visiteur a consenti au marketing
if (window.hasConsent && window.hasConsent('marketing')) {
    // Charger vos scripts marketing ici
}

// Réagir dès que le choix est connu
window.addEventListener('consentReady', function (event) {
    const consent = event.detail;
    // { essential: true, analytics: true, marketing: false }
});

Questions fréquentes

Facturation

Un seul tarif, sans palier : 30 $ CAD par site actif et par mois.

Comment ça marche

1. Créez autant de sites que vous voulez — il n'y a aucune limite.
2. Vous ne payez que les sites actifs — 30 $ CAD par mois et par site.
3. L'abonnement s'ajuste seul — activer ou désactiver un site met le montant à jour.
4. 30 jours d'essai gratuit — pour tout nouveau compte.

Exemples

• 1 site actif = 30 $ CAD par mois
• 5 sites actifs = 150 $ CAD par mois
• 10 sites actifs = 300 $ CAD par mois

Votre moyen de paiement

Votre carte est enregistrée à la création de votre premier site, au cours de l'accompagnement initial. Aucun montant n'est débité pendant les 30 jours d'essai. À l'issue de l'essai, la facturation démarre automatiquement selon le nombre de sites actifs.

Gérer votre abonnement

Depuis la page Facturation, vous pouvez mettre à jour votre carte, consulter et télécharger vos factures, ou résilier. Tout passe par le portail sécurisé de Stripe : nous ne conservons jamais votre numéro de carte.