Plateformes

Comment configurer Hotjar avec Cookiequiet

Le code de suivi de Hotjar dépose des cookies internes comme _hjSessionUser_{site_id} (365 jours) et _hjSession_{site_id} (30 minutes) et enregistre la façon dont les visiteurs utilisent la page : il relève donc de la catégorie mesure d’audience et ne doit se charger qu’après consentement. Marquez le code de suivi avec type="text/plain" et data-cq-category="analytics", ou déclenchez la balise Hotjar dans Google Tag Manager sur l’événement cq_consent quand cq_analytics vaut true. Hotjar n’a pas d’interrupteur de consentement propre à appeler.
Publié le 21 octobre 2026 · Par l’équipe Cookiequiet

Étapes

Copier le code de suiviDans Hotjar, ouvrez la page Sites, cliquez sur Install tracking code pour votre site et copiez le code. Il est propre au site et porte son identifiant Hotjar.
Le coller sous la balise CookiequietHotjar recommande le head de chaque page. Collez le code dans le template de votre site, juste après la balise Cookiequiet.
Le marquerRemplacez la balise d’ouverture par <script type="text/plain" data-cq-category="analytics"> et laissez le code à l’intérieur inchangé.
Ou le déclencher depuis Google Tag ManagerUtilisez la balise Hotjar Tracking Code avec un déclencheur Événement personnalisé sur cq_consent où cq_analytics est égal à true, réglé pour se déclencher une fois par page.
Conditionner Identify et les événementsLes appels à hj('identify') ou hj('event') dans votre propre code ne doivent s’exécuter que lorsque la mesure d’audience est accordée, ou se trouver dans des scripts marqués de la même façon.
Tester avec Tout refuserDans une fenêtre de navigation privée, cliquez sur Tout refuser et vérifiez qu’aucun cookie _hj n’est déposé et qu’aucune requête ne part vers Hotjar. Acceptez tout, rechargez, et utilisez la vérification d’installation de Hotjar.

Que stocke Hotjar dans le navigateur du visiteur ?

La documentation de Hotjar liste les cookies et éléments de stockage qu’utilise son code de suivi, tous internes puisque le script s’exécute sur votre domaine. Parmi eux :

NomTypeDurée de vieFinalité
_hjSessionUser_{site_id}cookie365 joursConserve l’identifiant utilisateur Hotjar pour votre site, pour que les visites suivantes comptent comme le même utilisateur
_hjSession_{site_id}cookie30 minutes, prolongé en cas d’activitéRattache les requêtes à la session en cours
_hjUserAttributesHash, _hjHasCachedUserAttributescookies2 minutes, sessionSuivent les changements des attributs utilisateur
_hjUserAttributeslocal storagesans expirationAttributs envoyés via l’API Identify
_hjClosedSurveyInvites, _hjDonePolls, _hjMinimizedPollscookies365 joursÉtat des enquêtes

Les cookies de test (_hjCookieTest, _hjLocalStorageTest, _hjSessionStorageTest, _hjTLDTest) sont supprimés juste après avoir été déposés. Hotjar dépose ses cookies sur le domaine de premier niveau, ils couvrent donc chaque sous-domaine, et la documentation indique que cela ne peut pas être limité à un seul sous-domaine.

Au-delà des cookies, Hotjar collecte ce dont les heatmaps et les enregistrements ont besoin : clics, défilements, mouvements de souris et contenu de la page. Hotjar ne classe pas ses cookies à votre place : sa documentation invite les propriétaires de sites à demander à leur propre conseil comment les classer et s’il faut utiliser un outil de consentement. Dans Cookiequiet, Hotjar se range dans la catégorie mesure d’audience, et le scanner le nomme quand il trouve le code de suivi.

Comment ne charger Hotjar qu’après consentement ?

Option 1 : marquer le code de suivi. Hotjar recommande de placer le code dans le head de chaque page, via le template de votre site. Placez-le juste après la balise Cookiequiet et ne changez que la balise d’ouverture :

html
<script src="https://cookiequiet.com/cq.js" data-site="YOUR_SITE_KEY" data-consent-mode="1" data-auto-block="1" defer></script>
<script type="text/plain" data-cq-category="analytics">
/* code de suivi Hotjar de votre page Sites, inchangé */
</script>

Cookiequiet l’exécute quand la mesure d’audience est accordée : immédiatement lors des visites suivantes où le choix enregistré l’inclut, et au moment du clic quand le visiteur accepte pendant la visite. Jusque-là, rien ne se charge depuis Hotjar et aucun cookie _hj n’est déposé. Un seul code de suivi Hotjar peut s’exécuter sur une page : retirez donc toute copie qu’ajoute un plugin ou un réglage de plateforme. Le guide sur le blocage des scripts détaille le balisage.

Option 2 : Google Tag Manager. Hotjar documente trois façons d’installer via Tag Manager ; la balise Hotjar Tracking Code de la liste des modèles est la plus simple à placer derrière le consentement. Donnez-lui un déclencheur Événement personnalisé sur cq_consent, certains événements personnalisés, avec la condition cq_analytics equals true, et réglez les options de déclenchement des balises sur une fois par page : Cookiequiet pousse cq_consent à chaque chargement de page où un choix est enregistré et après chaque choix. Vous pouvez aussi ajouter analytics_storage sous « Require additional consent for tag to fire », que Cookiequiet accorde avec la catégorie mesure d’audience. Le guide Google Tag Manager met en place les variables.

Option 3 : le paquet npm. Dans une application qui utilise @hotjar/browser, n’appelez sa fonction init qu’une fois la mesure d’audience accordée, par exemple dans un écouteur de l’événement cq:consent que Cookiequiet émet sur window, avec les catégories accordées dans detail.categories.

Le bloqueur automatique classe aussi l’hôte du script Hotjar sous mesure d’audience : une copie injectée par un plugin ou un gestionnaire de balises est donc retenue jusqu’au consentement. Un code de suivi écrit en dur dans le HTML sans marquage s’exécute avant que Cookiequiet puisse l’arrêter.

Hotjar a-t-il sa propre API de consentement ?

La documentation du code de suivi de Hotjar ne décrit aucune commande de consentement. La fonction hj() accepte des appels comme identify, event et stateChange, dont aucun ne met la collecte en pause. Pour respecter un refus, il faut ne pas charger le script. Côté visiteurs, Hotjar gère une page Do Not Track où chacun peut demander à Hotjar de cesser de traiter ses données sur tous les sites qui l’utilisent.

Et les applications monopages ?

Hotjar détecte par défaut les changements d’URL dans les applications monopages : il doit donc se charger une fois par chargement complet de page, pas à chaque route. Son guide Tag Manager prévient que les déclencheurs de changement d’historique entrent en conflit avec cette détection. Un déclencheur cq_consent se déclenche aux chargements complets et lors des choix, ce qui correspond. Si vous envoyez hj('stateChange', url) à la main, protégez-le avec la même vérification du consentement. Les guides des frameworks, comme React, montrent comment lire le choix dans les composants.

Points propres à l’UE

  • Les enregistrements de session capturent ce que les visiteurs voient sur la page. Hotjar masque par défaut les frappes au clavier et vous permet de masquer du texte, des images et d’autres éléments avec ses réglages de suppression ; vérifiez-les avant de collecter des données, car la suppression a lieu dans le navigateur et ne peut pas s’appliquer une fois la session envoyée.
  • _hjSessionUser dure 365 jours. Le tableau des cookies de votre bandeau et votre politique cookies doivent le lister avec cette durée de vie, que le scanner renseigne.
  • Les attributs de l’API Identify sont des données personnelles sur des utilisateurs connectés. Ne les envoyez qu’après consentement, et mentionnez Hotjar comme sous-traitant dans votre politique de confidentialité.

Comment tester ?

  1. Ouvrez le site dans une fenêtre de navigation privée et cliquez sur Tout refuser. Dans les outils de développement, aucun cookie commençant par _hj n’existe et l’onglet réseau ne montre aucune requête vers Hotjar.
  2. Effacez les cookies, cliquez sur Tout accepter, rechargez : _hjSessionUser_ et _hjSession_ apparaissent.
  3. Dans Hotjar, la page Sites confirme l’installation après une visite.
  4. Consultez le registre des consentements dans le tableau de bord Cookiequiet.

Cookiequiet est gratuit pour un site, ciblage géographique compris ; Starter coûte 3 € par site et par mois, avec des pages vues illimitées.

Questions

Mesure d’audience. Il mesure et enregistre la façon dont les visiteurs utilisent vos pages et conserve un identifiant utilisateur pendant 365 jours. Il ne cible pas de publicités : marketing n’est donc pas la bonne catégorie, sauf si vous l’utilisez à des fins publicitaires.
Hotjar stocke un cookie d’identifiant utilisateur et enregistre des sessions, ce qui n’est pas strictement nécessaire pour afficher la page : les règles ePrivacy exigent donc un consentement préalable. Hotjar laisse lui-même la classification aux propriétaires de sites et à leur conseil.
Pas via les signaux du Consent Mode. Chargez-le depuis Tag Manager avec un déclencheur cq_consent, éventuellement avec analytics_storage comme vérification de consentement supplémentaire, ou marquez le code de suivi pour que Cookiequiet l’exécute après consentement.
En général, une seconde copie du code de suivi : un plugin WordPress, un réglage de plateforme ou une balise non marquée au-dessus de la balise Cookiequiet. Retirez la copie en trop et ne gardez que la version marquée.

Mettez un bandeau discret sur votre site dès aujourd’hui

Gratuit pour un site avec toutes les fonctions essentielles, sans carte ni période d’essai qui expire. Passez un site en Starter pour €3 par mois pour le mettre à vos couleurs par IA sans la mention Cookiequiet, ou en Pro pour €9 pour le concevoir avec l’agent IA.