Consentl

Consentl op Ghost

Voeg Consentl toe aan Ghost met code injection, of in het thema zodat de loader echt als eerste in <head> staat, en zie welke Ghost-functies het niet tegenhoudt.

Loader als eerste in <head>
Hangt af van de methode
Methode Als eerste in <head>? Abonnement
A. Code injection Nee: bij het einde van <head> (binnen {{ghost_head}}) Alle abonnementen en self-hosted
B. Thema default.hbs Ja Ghost(Pro) Publisher of hoger (eigen thema's), of self-hosted

Waarom methode A meestal volstaat. Ghost rendert de code injection voor de siteheader aan het einde van {{ghost_head}}. Bijna elk script dat Ghost daarvóór uitvoert, is uitgesteld (Portal, zoeken, aankondigingsbalk, card-assets, aantallen reacties, ledenattributie, Ghost-webanalyse), dus een synchrone Consentl-loader wordt nog steeds vóór die scripts uitgevoerd. Als eerste worden uitgevoerd betekent niet dat Consentl ze tegenhoudt: het zijn de eigen scripts van Ghost, en Consentl blokkeert ze niet (zie Beperkingen). De uitzonderingen zijn Stripe.js (alleen als betaalde lidmaatschappen aan staan) en elk <script> dat uw thema boven {{ghost_head}} plaatst.

Uw Consentl-sitesleutel staat op de pagina Installatie van uw site in het dashboard. Voeg de hostnaam van de publicatie toe in het veld Domeinen; www. en het kale domein tellen als dezelfde site, dus u hoeft www. niet apart toe te voegen.

Wat uw Consentl-plan omvat

  • Free: alleen banner, toestemmingslogboek en handmatige blokkering.
  • Pro: voegt Google Consent Mode v2 toe.
  • Business: voegt automatische blokkering van bekende trackers toe en de blokkeerregels die u in het dashboard toevoegt.

Bij Free en Pro worden alleen tags tegengehouden die u handmatig markeert.

A. Code injection

  1. Ghost Admin → Settings → Code injection (in Ghost 5 en 6 onder Advanced; klik op Open).

  2. Plak de loader in Site header als eerste regel:

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

    Als de site ook het GTM-sjabloon van Consentl gebruikt, voeg dan &gcm=ext toe aan de URL, zodat alleen het sjabloon Consent Mode-opdrachten verstuurt.

  3. Save.

  4. Controleer of uw thema in default.hbs <script>-tags boven {{ghost_head}} heeft. Als die trackers laden, gebruik dan methode B.

B. Thema (echt als eerste)

  1. Download uw thema: Settings → Site → Theme → Change theme → Installed, en download daarna het actieve thema via het menu ervan.

  2. Plak in default.hbs de loader direct na <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. Zip het thema en upload het. Verwijder de versie in code injection als u die had toegevoegd.

Extra's

  • Link naar cookie-instellingen: voeg een navigatie-item toe (Settings → Site → Navigation, secundaire navigatie) met de URL #consentl. Links waarvan de URL eindigt op #consentl of #consentl-preferences, en elk element met het attribuut data-consentl-open, openen de voorkeuren.

  • Cookieverklaring: voeg een HTML card toe aan de pagina met uw cookiebeleid:

    <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>

    Gebruik in plaats daarvan data-consentl-request of data-consentl-withdrawal voor het formulier voor privacyverzoeken of het EU-herroepingsformulier. Het herroepingsformulier vereist het plan Pro of hoger en moet in het dashboard worden ingeschakeld; anders blijft het leeg.

  • Code injection per bericht of per tag wordt na de siteheader uitgevoerd; daar is niets nodig.

Controleren of het werkt

Open de publicatie in een privévenster: de banner verschijnt. Bekijk de bron om te zien waar de loader staat.

De regio van de bezoeker wordt afgeleid uit het IP-adres: Consentl zoekt bij elke paginaweergave het land op in het geheugen (er wordt niets opgeslagen) en past uw regel daarvoor uit het dashboard toe. Amerikaanse staten worden niet van elkaar onderscheiden: bezoekers uit de VS krijgen uw regel voor de hele VS of, als die er niet is, uw eerste regel voor een Amerikaanse staat. Voor een onbekend land geldt uw regel voor onbekende regio's (standaard opt-in).

Beperkingen

  • Ledenattributie slaat de surfgeschiedenis op vóór de toestemming. Wanneer het bijhouden van ledenbronnen in Ghost aan staat, bewaart member-attribution.min.js de pagina's die een bezoeker heeft bekeken in sessionStorage (ghost-history) vanaf de eerste paginaweergave, zodat een latere aanmelding kan worden toegeschreven. Consentl houdt dat niet tegen. Schakel het bijhouden van ledenbronnen uit (in de analyse-instellingen van Ghost Admin; de instelling heet ongeveer "Member sources" / "track member sources", controleer het actuele label in uw Ghost-versie), of beschouw het als uw eigen juridische beslissing en beschrijf het in uw cookiebeleid.

  • Ghost-webanalyse (Tinybird, ghost-stats) is cookieloos en wordt door Ghost zelf geladen; de automatische blokkering van Consentl dekt die niet. Schakel haar uit onder Settings → Analytics als uw juridische beoordeling toestemming vereist.

  • Stripe.js is nodig voor betaalde lidmaatschappen en is strikt noodzakelijk voor betalingen; het wordt niet geblokkeerd.

  • Portal (aanmelden en inloggen van leden) wordt niet geblokkeerd. We konden in de documentatie van Ghost niet bevestigen welke cookies of opslag het gebruikt. Controleer in DevTools → Application (Cookies, Local Storage, Session Storage) bij een nieuw bezoek en na het inloggen, en vermeld wat u vindt in uw cookieverklaring.

  • Vaste tags. Een <script src>, <img>-pixel of <iframe> die in code injection, het thema of een HTML card staat, wordt door de browser opgehaald voordat een script hem kan tegenhouden, ook als Consentl voorkomt dat hij wordt uitgevoerd. Markeer zulke tags handmatig en verwijder <noscript>-pixels:

    <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">

    Tags die door code worden geladen (GTM, de JavaScript-loader van een pixel), worden zonder verzoek tegengehouden wanneer automatische blokkering aan staat (plan Business en hoger).

  • Ghost(Pro) Starter kan geen eigen thema's uploaden, dus alleen methode A is beschikbaar.

Vastgelopen? Schrijf naar support@consentl.com — wij antwoorden op werkdagen in het Engels.