Intégrer l'API de consentement Microsoft Clarity avec Pandectes

Microsoft Clarity est un outil d'analyse gratuit qui propose des cartes de chaleur et des enregistrements de sessions pour vous aider à comprendre le comportement des utilisateurs sur votre site web. Cependant, comme Clarity collecte des données comportementales, son utilisation dans l'UE nécessite le consentement préalable de l'utilisateur au titre du RGPD et de la directive ePrivacy.

Avec Pandectes, vous pouvez facilement intégrer Microsoft Clarity à votre boutique Shopify et vous assurer que la collecte de données ne démarre qu'après l'obtention d'un consentement valide de l'utilisateur.

Prérequis

Avant de commencer :

• Vous devez avoir un compte Microsoft Clarity.
• L'application Pandectes GDPR Compliance doit être installée et configurée sur votre boutique Shopify.
• Vérifiez que vous avez activé l'intégration Microsoft Clarity dans l'application.

Qu'est-ce que l'API de consentement Clarity ?

L'API de consentement Clarity vous permet de contrôler ce que Clarity peut suivre en fonction des choix de consentement de l'utilisateur. Cela vous aide à rester conforme au RGPD et à empêcher toute collecte de données non autorisée.
Clarity utilise deux types de consentement indépendants :

Chaque autorisation peut être accordée ou refusée indépendamment. Par exemple, un utilisateur peut accepter les analyses mais refuser la publicité. Pandectes respecte chaque choix et le communique séparément à Clarity.

Comment fonctionne l'intégration

Lorsque l'intégration est activée, Pandectes envoie des signaux de consentement à Clarity en fonction des choix de l'utilisateur. Cependant, aucun cookie n'est déposé et aucun suivi n'a lieu tant que le signal de consentement approprié n'a pas été reçu.
à Clarity séparément

La façon dont le script Clarity est chargé dépend de la présence ou non d'un Project ID dans les paramètres Pandectes :

• Avec un Project ID : Pandectes charge automatiquement le script Clarity le plus tôt possible pendant le chargement de la page, conformément à la recommandation officielle de Microsoft selon laquelle le script s'exécute quel que soit le statut de consentement, afin qu'aucun signal ne soit manqué.
• Sans Project ID : vous êtes responsable du chargement du script Clarity sur votre boutique. Pandectes enverra tout de même les signaux de consentement, mais le script doit être présent sur la page pour qu'ils prennent effet.

Voici ce qui se passe après que l'utilisateur a interagi avec la bannière de consentement :

1. Pandectes lit les choix de cookies de l'utilisateur.
2. Pour chaque catégorie acceptée, l'autorisation Clarity correspondante est définie sur "granted".
3. Pour chaque catégorie refusée, l'autorisation correspondante est définie sur "denied".
4. Pandectes appelle l'API de consentement Clarity avec les autorisations résolues.

Ce que fait Clarity sans consentement

Lorsque le consentement est refusé, Clarity ne s'arrête pas simplement : il passe en mode sans cookie, ce qui signifie :

• Aucun suivi entre les sessions n'a lieu.
• Les cookies qui nécessitent un consentement ne sont pas déposés (voir le tableau ci-dessous).
• Des données limitées et non identifiantes peuvent tout de même être collectées.

Cookies contrôlés par le consentement

Activer Consent Mode dans Clarity

Avant que Pandectes puisse communiquer le consentement à Clarity, vous devez vous assurer que Consent Mode est actif dans les paramètres de votre projet Clarity. Cela empêche Clarity de déposer des cookies avant la réception d'un signal de consentement valide.

Activer Consent Mode dans les paramètres Clarity

• Allez sur votre tableau de bord Microsoft Clarity.
• Accédez à Settings → Setup.
• Faites défiler vers le bas et désactivez l'option Cookies.
• Clarity confirmera que les cookies sont désactivés jusqu'à la réception du consentement.

Vérifier que le consentement fonctionne correctement

Après avoir configuré l'intégration, vous pouvez vérifier que Clarity reçoit correctement les signaux de consentement de Pandectes :

1. Ouvrez votre boutique dans un navigateur et ouvrez les Developer Tools (Ctrl+Shift+I / Cmd+Option+I).
2. Allez dans l'onglet Console.
3. Collez et exécutez ce qui suit :

clarity('metadata', (d, upgrade, consent) => {
    console.log('consentStatus:', consent);
}, false, true, true);

4. Si le consentement n'a pas été accordé, vous devriez voir :

{ "analytics_storage": "DENIED", "ad_storage": "DENIED" }

5. Après avoir accepté les cookies dans la bannière Pandectes, la sortie doit se mettre à jour pour refléter les choix de l'utilisateur.

Activer Microsoft Clarity dans Pandectes

Suivez ces étapes :

1. Connectez-vous à votre boutique Shopify et accédez à l'application Pandectes.
2. Allez dans Settings > Integrations.
3. Faites défiler jusqu'à Microsoft Clarity et cliquez sur Configure.

1. Activez le commutateur pour activer l'intégration.
2. (Facultatif) Collez votre Clarity Project ID si vous voulez que Pandectes charge le script Clarity à votre place. Si vous le laissez vide, vous devez charger le script sur votre boutique de façon indépendante.

Une fois activé, Pandectes va :

• Envoyer des signaux de consentement granulaires (analytics_Storage et ad_Storage) en fonction des choix réels de l'utilisateur.
• Empêcher l'écriture de tout cookie Clarity tant que le consentement correspondant n'est pas accordé.
• Charger automatiquement le script Clarity (uniquement lorsqu'un Project ID est fourni), le plus tôt possible pendant le chargement de la page afin qu'aucun signal de consentement ne soit manqué.

Remarques finales

Cette intégration est entièrement conforme et optimisée pour :

• Les boutiques Shopify qui vendent dans l'UE
• Les commerçants soumis au RGPD, au CCPA et à d'autres cadres de confidentialité
• Les boutiques qui recherchent un contrôle automatisé et granulaire du suivi par des tiers

Pour plus de détails, consultez la documentation officielle de Microsoft sur l'intégration d'un CMP avec Clarity.

Mis à jour le : 02/10/2026