Une Content Security Policy bloque votre balise de suivi quand l’adresse de la balise manque dans la liste des sources autorisées par votre site. Le navigateur refuse alors de charger le script ou de le laisser envoyer des données. Pour corriger, ajoutez l’hôte de la balise aux deux directives script-src et connect-src, ou servez la balise depuis votre propre domaine.
Ce qu’est une Content Security Policy
Une Content Security Policy, ou CSP, est une liste de règles qu’un site envoie au navigateur avec chaque page. Ces règles disent d’où la page peut charger des scripts, des images, des polices et d’autres ressources, et où elle peut envoyer des données. Le navigateur les applique et refuse tout ce qui ne figure pas sur la liste.
Le but est la protection. Si un attaquant parvient à injecter un script dans votre page, une bonne politique empêche le navigateur de l’exécuter ou d’envoyer des données volées vers le serveur de l’attaquant. Les sites qui gèrent des paiements ou des connexions ont souvent une politique stricte, et certaines extensions de sécurité ou certains hébergeurs en ajoutent une pour vous.
La politique arrive en général sous la forme d’un en-tête de réponse :
Content-Security-Policy: default-src 'self'; script-src 'self'; connect-src 'self'
Chaque partie séparée par un point-virgule est une directive. La valeur 'self' désigne le domaine du site lui-même. Cet exemple dit : ne charger des scripts que depuis ce site, et n’envoyer des données qu’à ce site.
Les deux directives qui comptent pour une balise
Une balise de suivi fait deux choses, et chacune dépend d’une directive différente.
| Directive | Ce qu’elle contrôle | Ce qui se passe quand l’hôte de la balise manque |
|---|---|---|
script-src | D’où les scripts peuvent être chargés | Le fichier de la balise ne se charge jamais. Rien ne s’exécute. |
connect-src | Où les scripts peuvent envoyer des requêtes | La balise se charge et s’exécute, mais ses événements ne quittent jamais le navigateur. |
Si une politique n’a pas de script-src ou de connect-src propre, le navigateur se rabat sur default-src pour ce type de ressource.
Deux détails liés sont utiles à connaître. Certaines balises envoient leurs données en demandant une minuscule image, et ces requêtes relèvent de img-src. Une politique stricte bloque aussi les scripts en ligne, c’est-à-dire écrits directement dans la page, sauf si elle les autorise avec un nonce ou une empreinte (hash). Un nonce est un code à usage unique que le serveur ajoute à la fois à la politique et à la balise script. Un extrait de code collé est un script en ligne : il peut donc être bloqué avant même d’essayer de charger le fichier de la balise.
Pourquoi la panne est silencieuse
Quand le navigateur bloque une balise, les visiteurs ne voient rien d’anormal. La page s’affiche bien. La commande fonctionne. Elle arrive dans votre boutique. Le seul signe se trouve dans la console de développement du navigateur, que les visiteurs n’ouvrent jamais et que les propriétaires de site ouvrent rarement.
Le second cas est le plus difficile à repérer. Quand script-src autorise la balise mais que connect-src ne l’autorise pas, la balise est présente sur la page et semble installée. Un coup d’œil au code source de la page le confirme. Elle s’exécute, elle construit chaque événement, et chaque requête qu’elle tente d’envoyer est refusée.
En général, on s’en rend compte devant un tableau de bord sans aucun événement, ou une plateforme publicitaire qui n’annonce aucune conversion pour une campagne qui vend pourtant.
Comment le diagnostiquer dans la console du navigateur
- Ouvrez votre site dans un navigateur sur ordinateur.
- Ouvrez les outils de développement. Dans la plupart des navigateurs, c’est la touche F12, ou un clic droit sur la page puis Inspecter.
- Choisissez l’onglet Console et rechargez la page.
- Cherchez les messages en rouge qui mentionnent Content Security Policy.
Un script bloqué produit un message de ce type. La formulation exacte varie selon le navigateur et sa langue.
Refused to load the script 'https://tags.example.net/tag.js' because it violates
the following Content Security Policy directive: "script-src 'self'".
Une requête bloquée produit un message de ce type :
Refused to connect to 'https://collect.example.net/event' because it violates
the following Content Security Policy directive: "connect-src 'self'".
Le message indique l’adresse refusée et la directive qui l’a refusée. Ces deux informations suffisent pour corriger.
Refaites ensuite la vérification sur les pages qui comptent le plus. Ajoutez un produit au panier, passez la commande et allez jusqu’à la page de remerciement, console ouverte. Les pages de commande ont parfois une politique plus stricte que le reste du site : une balise peut fonctionner sur la page d’accueil et échouer précisément là où l’achat a lieu.
Pour lire la politique elle-même, ouvrez l’onglet Réseau, rechargez, cliquez sur la première requête de la liste, qui est la page, et cherchez Content-Security-Policy dans les en-têtes de réponse. Certains sites placent plutôt la politique dans une balise meta de l’en-tête de la page.
Première solution : ajouter l’hôte aux deux directives
Ajoutez l’adresse d’où la balise est chargée à script-src, et l’adresse où elle envoie ses événements à connect-src. Il s’agit parfois du même hôte, parfois de deux hôtes différents. Les messages de la console vous disent lequel est lequel.
Content-Security-Policy: default-src 'self';
script-src 'self' https://tags.example.net;
connect-src 'self' https://collect.example.net
Quelques conseils pour que tout se passe bien :
- Ajoutez les deux. Corriger
script-srcseul transforme la première panne en la seconde. - Si votre balise charge dans le navigateur les scripts des plateformes publicitaires, chacune de ces plateformes a des hôtes qui demandent le même traitement. Leur documentation les liste.
- Trouvez où la politique est définie avant de la modifier. Elle peut se trouver dans la configuration de votre serveur, votre CDN, une extension de sécurité ou le code de votre application. Si deux endroits définissent une politique, le navigateur applique les deux, et c’est la plus stricte qui l’emporte.
- Gardez une politique serrée. Ajoutez uniquement les hôtes dont vous avez besoin. Évitez les jokers comme
*, qui suppriment la protection pour laquelle la politique a été écrite. - Après la modification, rechargez la page console ouverte, et vérifiez que les messages rouges ont disparu et que les événements arrivent.
Pour tester une modification sans risque, les navigateurs acceptent aussi un en-tête Content-Security-Policy-Report-Only. Il signale ce qu’une politique bloquerait, sans rien bloquer.
Seconde solution : servir la balise depuis votre domaine
L’autre approche consiste à rendre la balise propriétaire (first-party). Le fichier du script est servi depuis le domaine de votre site, et la balise envoie ses événements à une adresse de votre domaine, qui les transmet ensuite depuis le serveur.
Pour le navigateur, le script comme ses requêtes relèvent désormais de 'self'. Une politique stricte qui n’autorise que le domaine du site les autorise déjà. Vous n’avez pas du tout à modifier la politique, et elle reste aussi stricte qu’avant.
Cette approche a un second avantage. Les requêtes vers votre propre domaine sont moins souvent arrêtées par les bloqueurs de publicité, qui fonctionnent avec des listes d’adresses de suivi tierces connues. Elle se combine naturellement avec le suivi côté serveur, où le serveur transmet chaque événement aux plateformes publicitaires.
Il faut pour cela quelque chose sur votre serveur qui serve le fichier et transmette les événements. C’est pourquoi cette solution passe en général par une extension ou un petit morceau de code serveur.
Le rôle de Tagbreeze
L’extension WordPress de Tagbreeze peut servir la balise depuis le domaine de votre site, qu’une Content Security Policy stricte autorise déjà. Tagbreeze vous prévient aussi par e-mail quand un site cesse d’envoyer des événements : un changement de politique qui bloque la balise ne passe pas inaperçu pendant des semaines.
En bref
- Une Content Security Policy indique au navigateur depuis quelles sources une page peut charger des ressources, et vers où elle peut envoyer des données.
script-srcpeut empêcher la balise de se charger.connect-srcpeut empêcher ses événements de partir. Aucune des deux n’affiche d’erreur aux visiteurs.- La console du navigateur nomme l’adresse bloquée et la directive en cause. Vérifiez aussi les pages de commande.
- Ajoutez les hôtes de la balise aux deux directives, ou servez la balise depuis votre propre domaine pour que la politique existante la couvre déjà.
Pour les autres causes d’événements perdus, voir pourquoi les plateformes publicitaires manquent des conversions.