Installation
Après avoir créé votre site et publié le bandeau dans le tableau de bord, copiez la ligne indiquée dans l’onglet « Installation ». Elle ressemble à ceci :
<script src="https://votre-serveur/s/VOTRE-IDENTIFIANT.js"></script>
Placez-la en tout premier dans le <head> de chaque page, avant
vos autres scripts :
<head>
<meta charset="utf-8">
<script src="https://votre-serveur/s/VOTRE-IDENTIFIANT.js"></script>
<!-- vos autres scripts ensuite -->
</head>
Chargez le script de façon synchrone, sans async ni defer : c’est
ce qui lui permet de bloquer les traceurs avant qu’ils ne s’exécutent. Il est léger et mis en
cache par le navigateur.
Le script contient à la fois le bandeau et votre configuration publiée. Quand vous publiez une modification dans le tableau de bord, elle s’applique sur votre site en quelques minutes, sans toucher au code.
Bloquer les traceurs
Blocage automatique
Les services déclarés dans « Cookies et services » sont reconnus à partir de l’adresse de leurs scripts et iframes (136 services connus dans le catalogue). Ils sont retenus tant que le visiteur n’a pas accepté la catégorie correspondante, puis exécutés sans rechargement de la page. Vous n’avez rien à modifier dans votre code pour Google Analytics, Meta Pixel, Hotjar, LinkedIn, TikTok et les autres outils courants.
Blocage manuel
Pour un script que le catalogue ne connaît pas, remplacez son type par
text/plain et indiquez sa catégorie avec data-cm-category :
<!-- Exécuté seulement après acceptation de la mesure d’audience -->
<script type="text/plain" data-cm-category="analytics"
src="https://cdn.exemple.com/tracker.js"></script>
<!-- Fonctionne aussi pour un script en ligne -->
<script type="text/plain" data-cm-category="marketing">
console.log('marketing accepté');
</script>
Les catégories disponibles sont preferences, analytics et
marketing (la catégorie necessary est toujours active).
Vidéos et iframes
Remplacez src par data-cm-src : l’iframe est remplacée par un encart
explicatif, avec un bouton pour l’autoriser, jusqu’à l’acceptation de la catégorie.
<iframe data-cm-src="https://www.youtube.com/embed/ID"
data-cm-category="marketing" data-cm-service="youtube"
width="560" height="315"></iframe> Lien « Gérer les cookies »
Le RGPD impose de pouvoir modifier son choix à tout moment. En plus du bouton flottant, ajoutez un lien dans votre pied de page :
<!-- Ouvre le centre de préférences -->
<a href="#optooki">Gérer les cookies</a>
<!-- Ou sur n’importe quel élément -->
<button type="button" data-cm-open>Gérer les cookies</button>
<!-- Réaffiche le bandeau plutôt que les préférences -->
<button type="button" data-cm-open="banner">Revoir le bandeau</button> Liste des cookies
Dans votre politique cookies, un élément avec l’attribut data-cm-cookie-list
affiche le tableau des services et cookies déclarés, par catégorie. Il reste à jour à chaque publication.
<div data-cm-cookie-list></div> Google Tag Manager et Consent Mode v2
Le Consent Mode v2 est actif par défaut. Le script envoie l’état par défaut (tout refusé)
avant vos balises Google, puis les quatre signaux ad_storage,
analytics_storage, ad_user_data et
ad_personalization à chaque choix.
Avec Google Tag Manager, placez simplement le script Optooki avant le conteneur :
<script src="https://votre-serveur/s/VOTRE-IDENTIFIANT.js"></script>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){ /* … */ })(window,document,'script','dataLayer','GTM-XXXX');</script>
À chaque choix, l’événement optooki_consent est aussi poussé dans le
dataLayer, avec l’état de chaque catégorie dans la variable
optooki. Utilisez-le comme déclencheur pour les balises qui ne gèrent pas le
Consent Mode.
Avec le modèle Optooki pour Google Tag Manager
Si vous ne pouvez pas modifier le code du site, ajoutez la balise « Optooki - Bandeau de consentement (CMP) » depuis la galerie de modèles de Google Tag Manager. Collez l’URL du serveur et l’identifiant du site, puis choisissez le déclencheur « Consent Initialization - All Pages ». La balise pose l’état par défaut (tout refusé) avant toutes les autres, puis charge le bandeau, qui transmet chaque choix aux balises Google.
Chargé par Google Tag Manager, le bandeau arrive après les scripts écrits directement dans
le code du site : il ne peut donc pas les bloquer. Il règle les balises de votre conteneur
(Consent Mode et déclencheur optooki_consent). Pour bloquer aussi les scripts
du site, placez plutôt la ligne Optooki en haut du <head>.
API JavaScript
Le script expose l’objet window.Optooki :
Optooki.showPreferences(); // ouvrir le centre de préférences
Optooki.show(); // réafficher le bandeau
Optooki.hasConsent('analytics'); // true ou false
Optooki.getConsent(); // { id, choices, action, timestamp… }
Optooki.acceptAll();
Optooki.rejectAll();
Optooki.setConsent({ analytics: true });
Optooki.reset(); // oublier le choix
// Réagir aux changements
Optooki.on('consent', (state) => { /* … */ });
window.addEventListener('optooki:consent', (event) => event.detail);
Les événements disponibles sont ready, consent, show
et hide.
WordPress
Le plugin Optooki ajoute le script au bon endroit, bloque les traceurs WordPress courants et partage le consentement avec WP Consent API. Voir la page du plugin.
PrestaShop
Le module Optooki fonctionne avec PrestaShop 1.7, 8 et 9. Dans Modules → Gestionnaire de
modules, cliquez sur « Installer un module » et déposez l’archive optooki.zip,
puis ouvrez « Configurer » et collez l’URL du serveur et l’identifiant du site, que vous
trouvez dans l’onglet Installation du tableau de bord. Le bouton « Tester la connexion »
vérifie que tout est en place.
Le module place le script tout en haut de chaque page de la boutique, retient Google
Analytics, Meta, Hotjar, Clarity, LinkedIn et TikTok ainsi que les vidéos YouTube et Vimeo
des fiches produits et des pages CMS, et ajoute un lien « Gérer mes cookies » en pied de
page. Dans une page CMS, [optooki_cookie_list] affiche la liste des cookies et
[optooki_preferences] un bouton qui rouvre les préférences.
Joomla
Le plugin Optooki fonctionne avec Joomla 4.4, 5 et 6. Installez l’archive
plg_system_optooki.zip depuis Système → Installer → Extensions, puis ouvrez Système
→ Gérer → Plugins, « Système - Optooki » : activez-le, collez l’URL du serveur et l’identifiant
du site, et testez la connexion.
Le bandeau est placé en tête de chaque page du site public, et les scripts Google Analytics,
Meta, Hotjar, Clarity, LinkedIn et TikTok ainsi que les vidéos YouTube et Vimeo sont retenus
jusqu’au consentement. Dans vos articles, [optooki_preferences] affiche un bouton
« Gérer mes cookies » et [optooki_cookie_list] la liste des cookies ; dans un menu,
un élément de type URL vers #optooki rouvre les préférences.
Drupal
Le module Optooki fonctionne avec Drupal 10.3 et plus, et Drupal 11. Décompressez
optooki.zip dans web/modules/custom/, activez le module dans
Extensions, puis ouvrez Configuration → Système → Optooki pour coller l’URL du serveur et
l’identifiant du site et tester la connexion.
Le bandeau est placé en tête de chaque page du site public, y compris les pages servies par
le cache de Drupal, et les traceurs connus ainsi que les vidéos YouTube et Vimeo sont
retenus jusqu’au consentement. Placez le bloc « Gérer mes cookies (Optooki) » dans le pied
de page, et utilisez [optooki_preferences] et [optooki_cookie_list] dans vos contenus. L’interface est traduite en français.
Shopify
L’application Optooki ne demande aucun accès aux produits, clients ou commandes de la boutique. Une fois installée, ouvrez Boutique en ligne → Thèmes → Personnaliser → Intégrations d’applications, activez « Bandeau cookies Optooki » et collez l’URL du serveur et l’identifiant du site. Dans Paramètres → Confidentialité des clients, désactivez la bannière de Shopify pour n’afficher qu’un seul bandeau.
Le bandeau se charge au début de chaque page, avant les autres scripts. Le choix du visiteur
est transmis à l’API Customer Privacy de Shopify : les statistiques de Shopify et les pixels
des applications (Meta, Google & YouTube, TikTok…) le respectent, jusqu’au paiement. Les
blocs « Liste des cookies » et « Bouton Gérer mes cookies » s’ajoutent à vos pages depuis
l’éditeur de thème, et un lien de menu vers #optooki rouvre les préférences.
Wix
L’application Optooki ne lit ni les contacts, ni les commandes, ni les membres du site. Une fois installée, ouvrez Applications → Optooki dans le tableau de bord Wix, collez l’URL du serveur et l’identifiant du site, testez la connexion puis activez le bandeau. Dans Paramètres → Confidentialité et cookies, désactivez la bannière de Wix pour n’afficher qu’un seul bandeau.
Le domaine du site, dans Optooki, doit être l’adresse publique du site Wix : votre domaine
personnalisé, ou nom.wixsite.com pour une adresse Wix gratuite. Le choix du visiteur
est transmis à la politique de consentement de Wix : ses statistiques, ses intégrations marketing
et les autres applications le respectent, et rien n’est déposé avant le choix. Un lien de menu
vers #optooki rouvre les préférences.
Squarespace
Squarespace n’accepte pas d’application pour ce rôle : la ligne Optooki se colle dans l’injection de code du site, disponible à partir de la formule Core (ex-Business).
- Ouvrez Site web → Outils du site web → Injection de code, et collez la ligne Optooki tout en haut de la zone « En-tête », avant tout autre code.
- Enregistrez. Le bandeau apparaît sur toutes les pages publiées.
- Dans les réglages de cookies de Squarespace, désactivez sa bannière de cookies pour n’afficher qu’un seul bandeau.
-
Pour le lien « Gérer les cookies », ajoutez un bloc Code dans le pied de page avec
<a href="#optooki">Gérer les cookies</a>.
Squarespace insère ses propres scripts avant l’injection de code : ses statistiques intégrées ne passent pas par Optooki. Le scanner les détecte et les ajoute à votre liste de cookies.
Webflow
Le code personnalisé demande une formule de site payante. Ouvrez les réglages du site, onglet Code personnalisé, et collez la ligne Optooki tout en haut de la zone « Head code ». Publiez ensuite le site : le code personnalisé ne s’applique qu’à la version publiée, pas dans le Designer.
Pour le lien « Gérer les cookies », ajoutez dans le pied de page un lien dont l’adresse est #optooki, ou un élément Embed contenant
<button type="button" data-cm-open>Gérer les cookies</button>. La
liste des cookies s’ajoute de la même façon, dans un Embed, sur votre page de politique de
cookies : <div data-cm-cookie-list></div>.
Les vidéos YouTube et Vimeo ajoutées avec l’élément Vidéo de Webflow sont des iframes : pour
les retenir jusqu’au consentement, utilisez plutôt un Embed avec
data-cm-src (voir Vidéos et iframes).
Questions techniques
Mon site utilise une Content Security Policy
Autorisez le domaine de votre serveur Optooki dans script-src (chargement du script)
et dans connect-src (enregistrement des preuves de consentement). Rien à ajouter
dans style-src sur les navigateurs actuels : le bandeau passe par des feuilles de
style construites, que la CSP ne bloque pas, donc sans 'unsafe-inline'.
Si votre politique repose sur des nonces, posez le nonce sur la balise du bandeau (nonce="…", ou data-cm-nonce="…" si vous ne pouvez pas poser l’attribut). Il est repris par
les scripts que le bandeau réactive après le consentement et par la feuille de style de repli
des navigateurs anciens.
Le bandeau ne s’affiche pas sur une autre adresse de mon site
Le bandeau n’est servi qu’au domaine déclaré du site, à ses sous-domaines et à ses domaines supplémentaires ; seules les preuves envoyées depuis ces adresses sont enregistrées. Un autre site qui reprendrait votre balise n’obtient donc ni bandeau ni preuves, et ne consomme pas votre quota. La console du navigateur indique le domaine refusé.
Pour une deuxième adresse du même site (boutique.com à côté de
boutique.fr), une préproduction ou l’adresse de prévisualisation d’une boutique
Shopify (ma-boutique.myshopify.com), ajoutez-la dans Réglages → Domaines
supplémentaires, jusqu’à trois par site, sans supplément. Les adresses de développement (localhost, 127.0.0.1, .local, .test) affichent toujours le
bandeau, sans enregistrer de preuves.
J’utilise une extension de cache ou d’optimisation
Excluez le script Optooki des options qui diffèrent, retardent ou regroupent le JavaScript : il doit rester le premier script de la page.
Mon site est une application monopage (React, Vue…)
Ajoutez le script dans le <head> de votre fichier HTML principal. Le bandeau
reste en place pendant la navigation et l’API JavaScript vous permet de réagir au consentement.
Partager le choix entre sous-domaines
Dans les réglages du site, indiquez un domaine de cookie (par exemple
.exemple.fr) : le choix vaut alors pour tous les sous-domaines.
Masquer le bandeau sur certaines pages
Les réglages du site permettent de lister des chemins (pages de politique de confidentialité, mentions légales) sur lesquels le bandeau ne s’ouvre pas automatiquement.