> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SDK Analytics
> Récupérez les analyses de visiteurs dans votre tableau de bord Komerza avec notre script analytics léger
## Aperçu
Le SDK Analytics de Komerza vous permet de suivre le comportement des visiteurs sur votre site web personnalisé et de visualiser les analyses directement dans votre tableau de bord Komerza. Avec un seul tag de script, vous obtiendrez des informations complètes sur les visiteurs, notamment les pages vues, les sessions utilisateurs, le suivi des conversions, et plus encore.
Accédez aux analyses de visiteurs dans le tableau de bord Komerza
## Fonctionnalités
Gestion automatique du consentement aux cookies avec cookies essentiels/optionnels
Incluez simplement le script avec votre ID de boutique - aucune configuration
complexe requise
Consultez les données des visiteurs instantanément dans votre tableau de bord
Komerza
Respecte la vie privée des utilisateurs avec un consentement transparent aux cookies et l'isolation Shadow DOM
## Démarrage rapide
### Intégration en un seul script
Ajoutez le script analytics à vos pages HTML avec votre ID de boutique :
```html theme={null}
Ma boutique
Bienvenue dans ma boutique
```
Remplacez `your-store-id` par votre véritable ID de boutique Komerza depuis
votre tableau de bord. Le script analytics gère automatiquement la conformité
RGPD en affichant un avis de consentement aux cookies aux visiteurs.
## Flux de consentement aux cookies
Lors de la première visite d'un visiteur sur votre site :
1. **Affichage de page immédiat** : Une vue de page IP uniquement est enregistrée immédiatement (conforme RGPD)
2. **Affichage de l'avis de cookies** : Un avis conforme au RGPD apparaît en bas à droite
3. **Minuterie de 20 secondes** : Sans réponse, le suivi « Requis uniquement » s'active automatiquement
4. **Choix de l'utilisateur** : Le visiteur peut choisir « Requis uniquement » ou « Tout accepter » à tout moment
5. **Stockage des préférences** : Le choix est mémorisé pour les visites futures (expiration du cookie après 1 heure)
* ID de visiteur aléatoire (non profilé)
* Type d'appareil et nom du navigateur
* Informations de référent
* Suivi de session (expiration après 1 heure)
* Pas de suivi inter-sessions
* Empreinte du navigateur pour un ID de visiteur stable
* Suivi analytics complet
* Informations améliorées sur le comportement des utilisateurs
* Suivi des conversions et des objectifs
* Métriques de performance détaillées
* Suivi inter-sessions
## Exemples d'implémentation
### Site Web de base
```html theme={null}
Ma boutique en ligne
Bienvenue dans ma boutique
Découvrez des produits incroyables...
```
### Intégration React/SPA
Pour les applications monopages, ajoutez le script une seule fois dans votre fichier HTML principal :
```html theme={null}
Ma boutique React
```
## Contrôle manuel du consentement
Si vous souhaitez contrôler le consentement par programmation (par exemple, bannière de cookies personnalisée) :
```html theme={null}
```
## Fonctionnalités de confidentialité
* **ID de visiteurs aléatoires** : Le suivi requis uniquement utilise des ID crypto-aléatoires (non profilés)
* **Expiration courte** : Tous les cookies expirent après 1 heure
* **Pas de suivi inter-domaines** : Les cookies sont spécifiques au site
* **Anonymisation des IP** : Les pages vues essentielles sont IP uniquement, sans ID de visiteur
## Politique de sécurité du contenu (CSP)
Pour les sites avec des en-têtes CSP, ajoutez ce qui suit à votre configuration CSP :
```http theme={null}
Content-Security-Policy:
script-src 'self' https://cdn.komerza.com;
connect-src 'self' https://m-api.komerza.com;
```
Le script analytics ne nécessite pas d'intégration de nonce CSP car il se
charge depuis un CDN de confiance. Cependant, assurez-vous que
`https://cdn.komerza.com` est dans votre directive `script-src`, et
`https://m-api.komerza.com` dans votre directive `connect-src`.
## Consulter vos analyses
Une fois le script installé et les visiteurs arrivant sur votre site :
1. **Connexion au tableau de bord** : Visitez [dashboard.komerza.com](https://dashboard.komerza.com)
2. **Accédez aux analyses de visiteurs** : Cliquez sur la section « Visiteurs »
3. **Consultez les informations** : Consultez les données de visiteurs en temps réel et historiques
4. **Suivez les performances** : Surveillez les taux de conversion et le comportement des utilisateurs
## Compatibilité avec les bloqueurs de publicités
Le script analytics utilise le nom de fichier `ka.min.js` qui est moins susceptible d'être bloqué par les bloqueurs de publicités comparé aux noms de fichiers contenant « analytics » ou « tracking ». Cependant, certains bloqueurs agressifs peuvent toujours bloquer les requêtes analytics.
## Assistance
Accédez à vos analyses de visiteurs et rapports