Agreely
FR EN

Installation

Le tag unique

Collez ce tag en premier dans votre <head>, avant tout gestionnaire de balises ou script analytique :

<script
  src="https://cdn.agreely.ca/e/v1/loader.js"
  data-agreely="agr_pub_VOTRE_CLE"></script>

C'est tout. Placez ce tag en premier, avant tout autre script, et sans attribut async : le chargeur doit s'exécuter avant vos autres balises. Il est minuscule (environ 0,7 Ko compressé) et s'exécute immédiatement. Dès son exécution, il installe de façon synchrone le signal Consent Mode v2 en mode refus par défaut ainsi que la protection qui diffère les traceurs connus jusqu'au consentement ; il télécharge ensuite le module de la bannière de façon asynchrone, sans bloquer le rendu. C'est cet ordre (le chargeur d'abord, en synchrone) qui garantit qu'aucun traceur ni signal Google de non-consentement ne s'échappe pendant le chargement.

Intégrité des sous-ressources (SRI)

Le chargeur intègre par défaut le hachage sha384 du module de la bannière ; le script injecté porte les attributs integrity et crossorigin="anonymous" automatiquement. Vous n'avez donc pas besoin d'attribut supplémentaire sur le tag de base.

Pour les versions épinglées (URL de la forme /e/v1.2.3/loader.js), l'URL est immuable et le SRI est fixe - idéale si vous souhaitez contrôler la version exacte déployée :

<script
  src="https://cdn.agreely.ca/e/v1.2.3/loader.js"
  data-agreely="agr_pub_VOTRE_CLE"></script>

Nonce CSP

Si votre script-src est à base de nonce, passez-le via l'attribut data-nonce et le chargeur le transmettra au script du module injecté :

<script
  src="https://cdn.agreely.ca/e/v1/loader.js"
  data-agreely="agr_pub_VOTRE_CLE"
  data-nonce="abc123"></script>

Obtenir votre clé de site

  1. Connectez-vous à agreely.ca et accédez à Bannière de témoins (cookies) dans la navigation principale.
  2. Cliquez sur Nouveau site web et entrez votre domaine. Le site est créé sur le palier gratuit Découverte ; aucun paiement n'est demandé à cette étape (voir la tarification).
  3. Collez le tag d'installation ci-dessus dans votre <head>.
  4. De retour dans le tableau de bord, cliquez sur Vérifier l'installation. Agreely balaie la page, confirme que la balise data-agreely avec votre clé est bien présente, puis marque le domaine comme vérifié.
  5. Votre clé de site (agr_pub_...) est affichée à l'étape d'installation et toujours disponible dans les paramètres du site web.

Vérification par balise, pas par DNS. La vérification confirme simplement que la balise data-agreely est présente sur la page : vous installez le tag, vous cliquez sur Vérifier l'installation, et le balayeur d'Agreely constate la balise. Il n'y a aucun enregistrement DNS ni fichier TXT à publier. Voir aussi Vérification et sécurité.

La clé de site est un identifiant public, sans capacité. Elle ne permet que de lire la configuration publique et de soumettre un enregistrement de consentement limité par les règles de domaine et les limites de taux. Elle est sans danger dans le code HTML de la page.

Rotation de la clé

Pour faire tourner une clé, générez-en une nouvelle dans les paramètres du site web ; une période de grâce de 24 heures permet aux deux clés de fonctionner en parallèle pendant que vous déployez la mise à jour. Révoquez ensuite l'ancienne clé.

Réouverture de la bannière

Pour permettre aux visiteurs de revoir ou de modifier leurs préférences depuis n'importe quelle page, ajoutez un lien ou un bouton avec l'attribut data-agreely-open :

<a href="#" data-agreely-open>Gérer mes témoins (cookies)</a>

Ce lien doit rester visible et accessible au clavier sur chaque page, conformément à la Loi 25 (article 14 : le retrait du consentement doit être aussi facile que son octroi). Vous pouvez aussi l'appeler par programmation :

window.agreelyCookies.open();      // ouvre les préférences
window.agreelyCookies.refuseAll(); // refuse tout par programme
window.agreelyCookies.withdraw();  // retire le consentement actif

Note d'accessibilité. La couche de préférences (role="dialog", aria-modal="true") gère les pièges de foyer, la touche Échap et la restauration du foyer. La couche 1 (bannière principale) ne bloque ni le défilement ni la navigation afin que le consentement reste libre.