Guide de dépannage
Solutions aux problèmes courants de CookieBeam. Si vous ne trouvez pas votre réponse, envoyez un e-mail à [email protected]
Saut rapide :
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. Ouvrez le mode prévisualisation de GTM
- 2. Cherchez la balise « CookieBeam Consent » dans la liste
- 3. Vérifiez qu'elle indique « Tags Fired » (Balises déclenchées)
- 4. Si elle ne se déclenche pas, vérifiez la configuration du déclencheur
- 5. Utilisez le déclencheur « Consent Initialization - All Pages »
Balise déclenchée mais bannière absente
- 1. Ouvrez la console du navigateur (F12)
- 2. Cherchez le chargement du script CookieBeam
- 3. Vérifiez si l'ID de la bannière est correct dans le code de la balise GTM
- 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. Ouvrez chaque balise GA4/Google Ads dans GTM
- 2. Allez dans Paramètres avancés → Paramètres de consentement
- 3. Activez « Exiger un consentement supplémentaire pour le déclenchement de la balise »
- 4. Pour GA4 : sélectionnez « Analytics Storage »
- 5. Pour Google Ads : sélectionnez « Ad Storage » et « Analytics Storage »
- 6. Enregistrez et publiez
S'assurer que CookieBeam se charge en premier
- 1. La balise CookieBeam doit utiliser le déclencheur « Consent Initialization »
- 2. Cela se déclenche AVANT toutes les autres balises
- 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. Allez dans Tableau de bord CookieBeam → Paramètres de bannière
- 2. Activez « Google Consent Mode v2 »
- 3. Enregistrez les modifications
- 4. Dans GA4, vérifiez le rapport Temps réel pour les signaux de consentement
- 5. Vous devriez voir « granted » (accordé) ou « denied » (refusé) pour analytics_storage
Vérifier la configuration GA4
- 1. Dans GTM, ouvrez votre balise de configuration GA4
- 2. Vérifiez qu'elle est configurée pour utiliser le Consent Mode
- 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. Ouvrez la console du navigateur (F12)
- 2. Tapez : window.dataLayer
- 3. Cherchez les événements « consent »
- 4. Vous devriez voir des événements d'update lors de l'acceptation/refus
- 5. Format : event "consent", consent_update ...
Problèmes de performance
La bannière se charge lentement
Optimiser le chargement
- 1. Vérifiez que le script a l'attribut « defer »
- 2. Utilisez la version CDN (cdn.cookiebeam.com) et non l'auto-hébergée
- 3. Vérifiez la vitesse de votre connexion internet
- 4. La bannière devrait se charger en < 500ms sur une bonne connexion
La bannière bloque le chargement de la page
Chargement asynchrone
- 1. Utilisez toujours l'attribut defer ou async sur la balise script
- 2. Correct : script src="..." defer
- 3. Ne chargez jamais de manière synchrone dans le head
Débogage avancé
Pour les développeurs : utilisez ces commandes de console pour déboguer CookieBeam
Vérifier si CookieBeam est chargé :
window.CookieBeam !== undefinedObtenir l'état actuel du consentement :
CookieBeam.getConsent()Vérifier le dataLayer (GTM) :
window.dataLayerForcer 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
[email protected]
Réponse sous 24 heures
❓ FAQ
Questions fréquentes
Réponses rapides
📚 Centre d'apprentissage
Guides & tutoriels
Documentation approfondie
📊 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 !