# Matomo
## Objectifs principaux du tracking
Ce document a pour objectif de fournir les connaissances de base pour la mise en place du tracking avec Matomo
* Comprendre le comportement des utilisateurs
* Mesurer la performance du site
* Aider à la prise de décision
* Améliorer l’expérience utilisateur
* Respecter les obligations légales (RGPD)
* *Optimiser les conversions*
## Architecture du tracking
### Outils
* Matomo Analytics
* JavaScript Tracker
* (Optionnel) Matomo Tag Manager
### Types de données collectées
* Données d'audience
* Données de navigation
* Données d'interaction
* Données de performance
* *Données de conversions (Goals)*
## Mise en place du tracking Matomo
Demander à l'administrateur la création d'un compte Matomo pour le produit. Il fournira :
* Le tracking code
* l'URL du serveur Matomo (MATOMO\_URL)
* l'identifiant du site de suivi dans Matomo (IDSITE)
### Ajout du tracking code
À intégrer sur toutes les pages du site, juste après la balise `` (ou dans la balise ``)
```html
```
### Éléments trackés par défaut avec le code tracking Matomo
| Catégorie | Tracké par défaut |
| ------------------------------------------------ | -------------------------------------- |
| Pages vues | ✅ |
| Sessions | ✅ |
| Sources de trafic | ✅ |
| Données techniques | ✅ |
| Localisation | ✅ |
| Temps passé | ✅ |
| Liens sortants / téléchargements | ✅(si enableLinkTracking() est présent) |
| Événements personnalisés (clics sur boutons) | ❌ |
| Formulaires (contenu, soumission) | ❌ |
| Données personnelles nominatives (nom, email...) | ❌ |
| User ID | ❌ |
| E-Commerce (objectifs, conversions) | ❌ |
## ✅ Configuration Matomo en mode « exempté de consentement » (CNIL)
La CNIL autorise l’utilisation de Matomo sans consentement sous conditions strictes. Dans la mesure ou les conditions sont respectées les produits DNUM pourrons opter pour cette configuration en exemptée de consentement, ci-dessous les critères;
### Conditions indispensables
* Anonymiser les adresses IP
* Désactiver User ID, E‑commerce, heatmaps, session recordings, cookies tiers et cross‑domain tracking
* Désactiver les fonctionnalités « Live »
* Ne collecter aucune donnée personnelle
* Limiter durée des cookies à 13 mois
* Conserver les données 25 mois maximum
* Informer l’utilisateur + fournir une page opt‑out
### 📄 Page d’opt‑out Matomo
Matomo fournit un module d’opt‑out permettant à l’utilisateur de désactiver la mesure d’audience. Selon la documentation Matomo, il faut intégrer l’iframe suivante :
```html
```
L’iframe affiche :
* Le statut actuel du suivi
* Un bouton permettant de le désactiver ou réactiver
Cette page doit être accessible depuis la politique de confidentialité.
Voici le [*guide*](https://www.cnil.fr/sites/cnil/files/atoms/files/matomo_analytics_-_exemption_-_guide_de_configuration.pdf) Matomo pour la configuration exemptée de consentement
Exemple d'une configuration opt-out [code su travail](https://code.travail.gouv.fr/politique-confidentialite)
## Plan de marquage (Measurement Plan)
Pour répondre à des besoins de mesure d’audience plus avancés ou ciblés, il peut être nécessaire de mettre en place un plan de marquage enrichi.
L’activation de ces fonctionnalités rend impossible l’utilisation du mode “exempté de consentement” défini par la CNIL
Dès lors, le produit devra se conformer pleinement aux obligations CNIL et RGPD, notamment :
* Passer en mode soumis au consentement,
* Mettre en place un bandeau de consentement conforme
* Ne déclencher le tracking Matomo qu’après obtention du consentement explicite de l’utilisateur.
### Conventions de nommage
| Élément | Règle |
| --------- | ------------------------------------------- |
| Catégorie | Fonctionnelle (`cta`, `form`, `navigation`) |
| Action | Verbe (`click`, `submit`, `scroll`) |
| Label | Élément précis (`contact_form`) |
| Valeur | Numérique (optionnelle) |
### Exemple de plan de marquage global
| Page | Interaction | Catégorie | Action | Label |
| -------- | ----------------- | ---------- | ------------- | ------------- |
| Accueil | Clic CTA | cta | click | hero\_button |
| Contact | Submit formulaire | form | submit | contact\_form |
| Blog | Scroll 75% | engagement | scroll | article |
| Global | Lien sortant | outbound | click | domain |
| Global | Téléchargement | download | click | file\_name |
| Produit | Add to cart | ecommerce | add\_to\_cart | product\_name |
| Checkout | Achat | ecommerce | purchase | order\_id |
### Implémentation techniques
Cette section décrit les événements personnalisés suivis avec Matomo afin de mesurer les interactions clés des utilisateurs.
### Clic sur un bouton (CTA)
**Objectif**\
Mesurer les clics sur les boutons d’appel à l’action.
**Catégorie** : `cta`\
**Action** : `click`\
**Label** : `signup_button`
```html
```
### Soumission de formulaire
**Objectif**\
Mesurer les soumissions de formulaire
```html
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://dnum-ministeres-sociaux.gitbook.io/ressources/concevoir/communs-numeriques/communs-matomo-tracking.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.