Agreely Docs
FR EN

Dépannage

Témoins encore présents après un refus

Symptôme : après avoir cliqué sur "Tout refuser", certains témoins sont encore visibles dans les DevTools du navigateur.

Explication probable : ce sont des témoins httpOnly ou émis par votre serveur. JavaScript ne peut pas lire ni supprimer les témoins httpOnly. La bannière Agreely ne prétend pas pouvoir le faire.

Solution : lisez le témoin agreely_consent côté serveur et cessez d'émettre les témoins non essentiels avant que la réponse HTTP soit envoyée. Consultez le chapitre Côté serveur.

Si des témoins de tierce partie persistent après refus et qu'ils ne sont pas httpOnly, vérifiez que leurs balises de script sont bien converties au format type="text/plain" data-agreely-category="..." (voir Blocage de scripts). Consultez aussi le balayage d'application (voir Autovérification) pour identifier les contrevenants.

Erreur CSP dans la console

Symptôme : la console du navigateur affiche une erreur du type Refused to load script from 'https://cdn.agreely.ca/...' because it violates the Content Security Policy.

Solution : ajoutez les trois directives requises à votre Content-Security-Policy :

script-src  https://cdn.agreely.ca ;
connect-src https://cdn.agreely.ca ;
img-src     https://cdn.agreely.ca ;

Si vous utilisez une politique à base de nonce, passez votre nonce via data-nonce="..." sur le tag du chargeur (voir Installation).

Erreur connect-src spécifiquement : si le module de la bannière se charge mais que la récupération de la configuration échoue, vérifiez que connect-src inclut https://cdn.agreely.ca : la récupération de la configuration et l'envoi du consentement passent par connect-src.

Aucun style-src requis. Agreely n'émet aucun style inline ni élément <style> externe ; la directive style-src n'a pas besoin de mentions Agreely.

La bannière ne s'affiche pas

Vérifiez les points suivants dans l'ordre :

  1. Le tag est-il présent dans le <head> ? Ouvrez le code source de la page (Ctrl+U) et cherchez cdn.agreely.ca/e/v1/loader.js.
  2. Le site est-il vérifié et publié ? Dans l'application de la bannière, assurez-vous que la clé du tag est la clé courante du site (une clé renouvelée cesse de fonctionner 24 heures après), que le site est vérifié et qu'une version de la bannière est publiée (page Publication). Tant que ce n'est pas le cas, la réponse réseau à /e/v1/config/{clé} porte "active": false et la bannière n'affiche rien.
  3. Le domaine correspond-il ? Le consentement n'est accepté que depuis le domaine enregistré, ses sous-domaines et les origines de préproduction déclarées. Une autre origine n'empêche pas l'affichage, mais la soumission du consentement y est refusée (403, avec un avertissement dans la console).
  4. Le visiteur a-t-il déjà une décision en cours ? Si le témoin agreely_consent est présent et valide, la bannière ne réapparaît pas. Supprimez ce témoin pour tester de nouveau.
  5. Le chargeur est-il bloqué par un bloqueur de publicités ? Testez en désactivant les extensions de blocage ou en mode navigation privée.

Tester en environnement de mise en scène

  1. Ajoutez votre URL de mise en scène (ex. : https://staging.votredomaine.com) sous votre site > Réglages > Origines de préproduction.
  2. Déployez le même tag HTML (même clé de site) sur votre environnement de mise en scène.
  3. La bannière s'affiche et les soumissions de consentement sont acceptées depuis cette origine.
  4. Vous pouvez lancer un balayage d'application sur l'origine de mise en scène depuis le tableau de bord.

La bannière réapparaît à chaque visite

Cause probable : le témoin agreely_consent est bloqué, expiré ou supprimé.

  • Vérifiez que votre serveur n'émet pas un en-tête Clear-Site-Data ou ne supprime pas le témoin agreely_consent dans votre logique de session.
  • Vérifiez la durée de vie : 183 jours. Si votre SameSite ou votre politique de témoins est plus restrictive, le témoin peut être refusé.
  • Safari, comme certains navigateurs axés sur la vie privée, limite la durée de vie des témoins écrits par JavaScript (7 jours ou moins). Sur ces navigateurs, la bannière peut redemander le consentement avant la fin de la durée prévue (183 jours). La bannière réécrit le témoin à chaque visite, avec son échéance d'origine : une personne qui revient avant la limite du navigateur conserve son choix.
  • Sur http:// (non HTTPS), le témoin est émis sans le drapeau Secure mais reste fonctionnel. Le mode HTTPS est recommandé en production.

Signalement d'un problème

Si votre problème ne figure pas dans cette liste, écrivez à [email protected] en incluant votre clé de site, l'URL de la page concernée et une capture d'écran de la console DevTools.