--- title: "Guide de dépannage | CookieBeam" description: "Dépannage des problèmes courants de CookieBeam. Solutions pour la bannière non affichée, problèmes de mode de consentement, intégration GTM, et plus." url: "https://cookiebeam.com/fr/troubleshooting" lang: "fr" image: "https://cookiebeam.com/opengraph-image.png?v=20261016" --- # Guide de dépannage Solutions aux problèmes courants de CookieBeam. Si vous ne trouvez pas votre réponse, envoyez un e-mail à [support@cookiebeam.com](mailto:support@cookiebeam.com) ## Saut rapide : Problèmes d'affichage de la bannière Problèmes Google Tag Manager Problèmes Consent Mode v2 Problèmes d'analyse des cookies Problèmes de performance ## Problèmes d'affichage de la bannière ### La bannière ne s'affiche pas sur mon site #### Vérifier si le script est chargé 1. 1. Ouvrez votre site dans Chrome 2. 2. Appuyez sur F12 pour ouvrir les outils de développement 3. 3. Allez dans l'onglet « Network » (Réseau) 4. 4. Actualisez la page 5. 5. Recherchez « cookiebeam » dans le filtre 6. 6. Si vous voyez un statut 200, le script est chargé avec succès #### Vérifier l'ID de la bannière 1. 1. Allez sur votre tableau de bord CookieBeam 2. 2. Cliquez sur votre bannière → Onglet Installation 3. 3. Copiez votre ID de bannière 4. 4. Vérifiez qu'il correspond à l'ID dans le code de votre site 5. 5. Erreur courante : utiliser le mauvais ID ou laisser l'espace réservé « YOUR-BANNER-ID » #### Vérifier les erreurs JavaScript 1. 1. Ouvrez les Chrome DevTools (F12) 2. 2. Allez dans l'onglet « Console » 3. 3. Cherchez les messages d'erreur en rouge 4. 4. Si vous voyez « CookieBeam is not defined », le script ne se charge pas 5. 5. Chargez le script de la bannière de manière synchrone en tant que premier élément dans l'en-tête de la page, sans async ni defer. #### Vider le cache 1. 1. Faites un rafraîchissement forcé : Ctrl+Shift+R (Windows) ou Cmd+Shift+R (Mac) 2. 2. Ou videz complètement le cache du navigateur 3. 3. Testez en mode navigation privée ### La bannière s'affiche sur ordinateur mais pas sur mobile #### Vérifier les paramètres responsifs 1. 1. Allez dans Design de bannière → Mise en page 2. 2. Vérifiez que « Mobile Responsive » est activé 3. 3. Testez différentes tailles d'écran dans les DevTools (F12 → Barre d'outils des appareils) 4. 4. Vérifiez s'il y a des conflits CSS sur mobile ### La bannière s'affiche mais semble cassée/sans style #### Conflit CSS 1. 1. Le CSS de votre site peut écraser les styles de la bannière 2. 2. Ajoutez la priorité !important dans le CSS personnalisé de CookieBeam 3. 3. Ou augmentez la spécificité CSS dans les paramètres de la bannière 4. 4. Vérifiez la console du navigateur pour les erreurs CSS ### La bannière s'affiche à chaque visite (choix non mémorisé) #### Problèmes de stockage des cookies 1. 1. Vérifiez si votre navigateur bloque les cookies tiers 2. 2. Vérifiez que localStorage est activé (requis pour stocker le consentement) 3. 3. Vérifiez si vous êtes en mode privé/incognito (les cookies ne persistent pas) 4. 4. Vérifiez qu'aucun autre script ne supprime le cookie de consentement ## Problèmes Google Tag Manager ### La bannière ne se déclenche pas en mode prévisualisation GTM #### Vérifier la configuration des balises 1. 1. Ouvrez le mode prévisualisation de GTM 2. 2. Cherchez la balise « CookieBeam Consent » dans la liste 3. 3. Vérifiez qu'elle indique « Tags Fired » (Balises déclenchées) 4. 4. Si elle ne se déclenche pas, vérifiez la configuration du déclencheur 5. 5. Utilisez le déclencheur « Consent Initialization - All Pages » #### Balise déclenchée mais bannière absente 1. 1. Ouvrez la console du navigateur (F12) 2. 2. Cherchez le chargement du script CookieBeam 3. 3. Vérifiez si l'ID de la bannière est correct dans le code de la balise GTM 4. 4. Vérifiez que l'URL du script est : https://cdn.cookiebeam.com/banner/... ### D'autres balises se déclenchent sans consentement #### Configurer les exigences de consentement 1. 1. Ouvrez chaque balise GA4/Google Ads dans GTM 2. 2. Allez dans Paramètres avancés → Paramètres de consentement 3. 3. Activez « Exiger un consentement supplémentaire pour le déclenchement de la balise » 4. 4. Pour GA4 : sélectionnez « Analytics Storage » 5. 5. Pour Google Ads : sélectionnez « Ad Storage » et « Analytics Storage » 6. 6. Enregistrez et publiez #### S'assurer que CookieBeam se charge en premier 1. 1. La balise CookieBeam doit utiliser le déclencheur « Consent Initialization » 2. 2. Cela se déclenche AVANT toutes les autres balises 3. 3. Les autres balises marketing doivent avoir des exigences de consentement ## Problèmes Consent Mode v2 ### Google Analytics ne reçoit pas les signaux de consentement #### Activer le Consent Mode v2 1. 1. Allez dans Tableau de bord CookieBeam → Paramètres de bannière 2. 2. Activez « Google Consent Mode v2 » 3. 3. Enregistrez les modifications 4. 4. Dans GA4, vérifiez le rapport Temps réel pour les signaux de consentement 5. 5. Vous devriez voir « granted » (accordé) ou « denied » (refusé) pour analytics_storage #### Vérifier la configuration GA4 1. 1. Dans GTM, ouvrez votre balise de configuration GA4 2. 2. Vérifiez qu'elle est configurée pour utiliser le Consent Mode 3. 3. Dans GA4 Admin → Collecte de données → Le statut du mode consentement doit être « Observé » ### Les signaux du Consent Mode ne se mettent pas à jour #### Vérifier le dataLayer 1. 1. Ouvrez la console du navigateur (F12) 2. 2. Tapez : window.dataLayer 3. 3. Cherchez les événements « consent » 4. 4. Vous devriez voir des événements d'update lors de l'acceptation/refus 5. 5. Format : event "consent", consent_update ... ## Problèmes d'analyse des cookies ### Le scanner de cookies ne détecte pas tous les cookies #### Plusieurs méthodes d'analyse 1. 1. Essayez les méthodes d'analyse automatique et manuelle 2. 2. Analyse manuelle : visitez toutes les pages importantes avant de terminer l'analyse 3. 3. Certains cookies n'apparaissent qu'après des actions spécifiques (login, paiement, etc.) 4. 4. Les cookies tiers peuvent nécessiter une interaction de l'utilisateur pour apparaître ### Mauvaises catégories de cookies #### Catégorisation manuelle 1. 1. Allez dans Tableau de bord → Scanner de cookies → Résultats 2. 2. Cliquez sur le cookie mal catégorisé 3. 3. Changez la catégorie manuellement 4. 4. CookieBeam apprend de vos corrections ## Problèmes de performance ### La bannière se charge lentement #### Optimiser le chargement 1. 1. Conservez le chargeur synchrone et en première position dans l'en-tête de la page ; excluez-le des optimiseurs de scripts différés. 2. 2. Utilisez la version CDN (cdn.cookiebeam.com) et non l'auto-hébergée 3. 3. Vérifiez la vitesse de votre connexion internet 4. 4. La bannière devrait se charger en < 500ms sur une bonne connexion ### La bannière bloque le chargement de la page #### Chargeur synchrone 1. 1. N'ajoutez pas async ou defer au chargeur de la bannière. 2. 2. Utilisez l'URL canonique du chargeur depuis l'onglet d'installation de la bannière. 3. 3. Chargez de manière synchrone en tant que premier élément dans l'en-tête de la page, avant les traceurs. ## Débogage avancé Pour les développeurs : utilisez ces commandes de console pour déboguer CookieBeam ### Vérifier si CookieBeam est chargé : ``` window.CookieBeam !== undefined ``` ### Obtenir l'état actuel du consentement : ``` CookieBeam.getConsent() ``` ### Vérifier le dataLayer (GTM) : ``` window.dataLayer ``` ### Forcer l'affichage de la bannière (test) : ``` CookieBeam.show() ``` ### Réinitialiser le consentement (test) : ``` CookieBeam.reset() ``` ## Encore besoin d'aide ? Si vous n'avez pas trouvé de solution ici, nous sommes là pour vous ! [✉️ Support par e-mail support@cookiebeam.com Réponse sous 24 heures](mailto:support@cookiebeam.com) [❓ FAQ Questions fréquentes Réponses rapides](https://cookiebeam.com/guides) [📚 Centre d'apprentissage Guides & tutoriels Documentation approfondie](https://cookiebeam.com/guides) **📊 Lors du signalement d'un problème :** Incluez votre ID de navigateur (disponible dans le tableau de bord CookieBeam), la version de votre navigateur et les étapes pour reproduire le problème. Des captures d'écran aident aussi !