Consentl sur Ghost

Ajoutez Consentl à Ghost via l’injection de code, ou dans le thème pour un chargeur vraiment en premier dans <head>, et voyez ce que Consentl ne bloque pas.

Chargeur en premier dans <head>

Selon la méthode

Pourquoi la méthode A suffit généralement. Ghost rend l’injection de code de l’en-tête du site à la fin de {{ghost_head}}. Presque tous les scripts que Ghost génère avant elle sont différés (Portal, recherche, barre d’annonce, ressources des cartes, compteurs de commentaires, attribution des membres, statistiques web de Ghost) : un chargeur Consentl synchrone s’exécute donc tout de même avant eux. S’exécuter en premier ne signifie pas que Consentl les bloque : ce sont les scripts propres à Ghost, et Consentl ne les bloque pas (voir Limites). Les exceptions sont Stripe.js (uniquement lorsque les abonnements payants sont activés) et tout <script> que votre thème place au-dessus de {{ghost_head}}.

Votre clé du site Consentl se trouve sur la page Configuration de votre site dans le tableau de bord. Ajoutez le nom d’hôte de la publication dans le champ Domaines ; www. et le domaine nu comptent comme le même site : il est donc inutile d’ajouter www. séparément.

Ce que couvre votre forfait Consentl

• Free : bannière, journal des consentements et blocage manuel uniquement.
• Pro : ajoute Google Consent Mode v2.
• Business : ajoute le blocage automatique des traceurs connus et les règles de blocage que vous ajoutez dans le tableau de bord.

Avec Free et Pro, seules les balises que vous marquez manuellement sont bloquées.

A. Injection de code

1. Ghost Admin → Settings → Code injection (dans Ghost 5 et 6, sous Advanced ; cliquez sur Open).

2. Dans Site header, collez le chargeur en première ligne :

   <script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=en"></script>

   Si le site utilise aussi le modèle GTM de Consentl, ajoutez &gcm=ext à l’URL afin que seul le modèle envoie les commandes Consent Mode.

3. Save.

4. Vérifiez si votre thème comporte des balises <script> au-dessus de {{ghost_head}} dans default.hbs. Si elles chargent des traceurs, utilisez la méthode B.

B. Thème (réellement en premier)

1. Téléchargez votre thème : Settings → Site → Theme → Change theme → Installed, puis téléchargez le thème actif depuis son menu.

2. Dans default.hbs, collez le chargeur juste après <meta charset="utf-8"> :

   <head>
       <meta charset="utf-8">
       <script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l={{@site.locale}}"></script>

3. Compressez le thème en zip et téléversez-le. Retirez la version par injection de code si vous l’aviez ajoutée.

Compléments

• Lien « Paramètres des cookies » : ajoutez un élément de navigation (Settings → Site → Navigation, navigation secondaire) avec l’URL #consentl. Les liens dont l’URL se termine par #consentl ou #consentl-preferences, ainsi que tout élément portant l’attribut data-consentl-open, ouvrent les préférences.

• Déclaration relative aux cookies : ajoutez une carte HTML à votre page de politique relative aux cookies :

  <div data-consentl-declaration data-api="https://api.consentl.com" data-key="SITE_KEY" data-locale="en"></div>
  <script src="https://api.consentl.com/v1/blocks.js" defer></script>

  Utilisez plutôt data-consentl-request ou data-consentl-withdrawal pour le formulaire de demande relative aux données personnelles ou le formulaire de rétractation UE. Le formulaire de rétractation nécessite le forfait Pro ou supérieur et doit être activé dans le tableau de bord ; sinon, il reste vide.

• L’injection de code par article ou par tag s’exécute après l’en-tête du site ; rien n’est nécessaire à cet endroit.

Vérifier le fonctionnement

Ouvrez la publication dans une fenêtre de navigation privée : la bannière apparaît. Affichez le code source pour voir où se trouve le chargeur.

La région du visiteur est déterminée à partir de son adresse IP : Consentl recherche le pays en mémoire à chaque affichage de page (rien n’est enregistré) et applique la règle correspondante de votre tableau de bord. Les États américains ne sont pas distingués : les visiteurs américains reçoivent votre règle pour l’ensemble des États-Unis ou, à défaut, votre première règle d’État américain. Un pays inconnu reçoit votre règle pour les régions inconnues (opt-in par défaut).

Limites

• L’attribution des membres enregistre l’historique de navigation avant le consentement. Lorsque le suivi de la source des membres de Ghost est activé, member-attribution.min.js conserve les pages consultées par un visiteur dans sessionStorage (ghost-history) dès le premier affichage de page, afin qu’une inscription ultérieure puisse être attribuée. Consentl ne le bloque pas. Désactivez le suivi de la source des membres (dans les paramètres d’analyse de Ghost Admin ; le libellé du réglage ressemble à « Member sources » / « track member sources », vérifiez le libellé actuel dans votre version de Ghost), ou considérez-le comme votre propre décision juridique et décrivez-le dans votre politique relative aux cookies.

• Les statistiques web de Ghost (Tinybird, ghost-stats) fonctionnent sans cookies et sont chargées par Ghost lui-même ; le blocage automatique de Consentl ne les couvre pas. Désactivez-les sous Settings → Analytics si votre analyse juridique exige un consentement.

• Stripe.js est nécessaire pour les abonnements payants et est strictement nécessaire aux paiements ; il n’est pas bloqué.

• Portal (inscription et connexion des membres) n’est pas bloqué. Nous n’avons pas pu confirmer à partir de la documentation de Ghost quels cookies ou quel stockage il utilise. Vérifiez dans DevTools → Application (Cookies, Local Storage, Session Storage) lors d’une nouvelle visite et après connexion, et répertoriez ce que vous trouvez dans votre déclaration relative aux cookies.

• Balises codées en dur. Un <script src>, un pixel <img> ou une <iframe> écrit dans l’injection de code, le thème ou une carte HTML est récupéré par le navigateur avant qu’un script ne puisse l’arrêter, même lorsque Consentl l’empêche de s’exécuter. Marquez manuellement ces balises et supprimez les pixels <noscript> :

  <script type="text/plain" data-consentl="marketing" src="https://ads.example.com/tag.js"></script>
  <iframe data-consentl="marketing" data-src="https://www.youtube-nocookie.com/embed/ID" title="Video"></iframe>
  <img data-consentl="marketing" data-src="https://tracker.example.com/pixel.gif" alt="" width="1" height="1">

  Les balises chargées par du code (GTM, le chargeur JavaScript d’un pixel) sont bloquées sans requête lorsque le blocage automatique est activé (à partir du forfait Business).

• Ghost(Pro) Starter ne permet pas de téléverser des thèmes personnalisés : seule la méthode A est donc disponible.

Guides associés

• Tout site web (extrait de code)
• Google Tag Manager
• Framer

Vous êtes bloqué ? Écrivez à support@consentl.com — nous répondons en anglais les jours ouvrables.