Consentl su Ghost

Aggiunga Consentl a Ghost con la code injection, o nel tema per un loader davvero primo nel <head>, e veda quali funzionalità di Ghost Consentl non trattiene.

Loader per primo nel <head>
Dipende dal metodo
Metodo Per primo nel <head>? Piano
A. Code injection No: verso la fine del <head> (all'interno di {{ghost_head}}) Tutti i piani e self-hosted
B. default.hbs del tema Sì Ghost(Pro) Publisher o superiore (temi personalizzati), oppure self-hosted

Perché il metodo A di solito è sufficiente. Ghost genera la code injection dell'header del sito alla fine di {{ghost_head}}. Quasi tutti gli script che Ghost emette prima di essa sono differiti (Portal, ricerca, barra degli annunci, risorse delle card, conteggio dei commenti, attribuzione dei membri, statistiche web di Ghost), quindi un loader Consentl sincrono viene comunque eseguito prima di essi. Essere eseguito per primo non significa che Consentl li trattenga: sono script di Ghost stesso e Consentl non li blocca (veda Limitazioni). Le eccezioni sono Stripe.js (solo quando le iscrizioni a pagamento sono attive) e qualsiasi <script> che il suo tema colloca sopra {{ghost_head}}.

La sua chiave del sito Consentl si trova nella pagina Configurazione del suo sito nel pannello di controllo. Aggiunga il nome host della pubblicazione nel campo Domini; www. e il dominio senza www contano come lo stesso sito, quindi non è necessario aggiungere www. separatamente.

Che cosa copre il suo piano Consentl

  • Free: solo banner, registro dei consensi e blocco manuale.
  • Pro: aggiunge Google Consent Mode v2.
  • Business: aggiunge il blocco automatico dei tracker noti e le regole di blocco che aggiunge nel pannello di controllo.

Con Free e Pro vengono trattenuti solo i tag che contrassegna manualmente.

A. Code injection

  1. Ghost Admin → Settings → Code injection (in Ghost 5 e 6 in Advanced; faccia clic su Open).

  2. In Site header, incolli il loader come prima riga:

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

    Se il sito usa anche il modello Consentl per GTM, aggiunga &gcm=ext all'URL, così solo il modello invia i comandi di Consent Mode.

  3. Save.

  4. Controlli se il suo tema ha tag <script> sopra {{ghost_head}} in default.hbs. Se caricano tracker, usi il metodo B.

B. Tema (davvero per primo)

  1. Scarichi il suo tema: Settings → Site → Theme → Change theme → Installed, poi scarichi il tema attivo dal suo menu.

  2. In default.hbs, incolli il loader subito dopo <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. Comprima il tema in uno zip e lo carichi. Rimuova la versione nella code injection, se l'aveva aggiunta.

Extra

  • Link alle impostazioni dei cookie: aggiunga una voce di navigazione (Settings → Site → Navigation, navigazione secondaria) con l'URL #consentl. I link il cui URL termina con #consentl o #consentl-preferences, e qualsiasi elemento con l'attributo data-consentl-open, aprono le preferenze.

  • Dichiarazione dei cookie: aggiunga una HTML card alla pagina dell'informativa sui cookie:

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

    Usi invece data-consentl-request o data-consentl-withdrawal per il modulo per le richieste sui dati personali o per il modulo di recesso UE. Il modulo di recesso richiede il piano Pro o superiore e deve essere attivato nel pannello di controllo; altrimenti resta vuoto.

  • La code injection per singolo post o tag viene eseguita dopo l'header del sito; lì non serve nulla.

Verificare che funzioni

Apra la pubblicazione in una finestra privata: il banner compare. Visualizzi il sorgente per vedere dove si trova il loader.

La regione del visitatore viene ricavata dal suo indirizzo IP: Consentl individua il Paese in memoria a ogni visualizzazione di pagina (senza memorizzare nulla) e applica la regola del pannello di controllo per quel Paese. Gli Stati USA non vengono distinti: i visitatori statunitensi ricevono la sua regola per l'intero territorio USA oppure, in sua assenza, la sua prima regola per uno Stato USA. Un Paese sconosciuto riceve la sua regola per le regioni sconosciute (opt-in per impostazione predefinita).

Limitazioni

  • L'attribuzione dei membri memorizza la cronologia di navigazione prima del consenso. Quando il tracciamento della provenienza dei membri di Ghost è attivo, member-attribution.min.js conserva le pagine visualizzate da un visitatore in sessionStorage (ghost-history) dalla prima visualizzazione di pagina, in modo che una successiva iscrizione possa essere attribuita. Consentl non lo trattiene. Disattivi il tracciamento della provenienza dei membri (nelle impostazioni delle statistiche di Ghost Admin; l'impostazione ha un'etichetta simile a "Member sources" / "track member sources", verifichi l'etichetta attuale nella sua versione di Ghost), oppure lo consideri una sua decisione giuridica e lo descriva nella sua informativa sui cookie.

  • Le statistiche web di Ghost (Tinybird, ghost-stats) non usano cookie e sono caricate da Ghost stesso; il blocco automatico di Consentl non le copre. Le disattivi in Settings → Analytics se la sua valutazione giuridica richiede il consenso.

  • Stripe.js è necessario per le iscrizioni a pagamento ed è strettamente necessario per i pagamenti; non viene bloccato.

  • Portal (iscrizione e accesso dei membri) non viene bloccato. Non abbiamo potuto confermare dalla documentazione di Ghost quali cookie o archiviazione utilizzi. Controlli in DevTools → Application (Cookies, Local Storage, Session Storage) a una nuova visita e dopo l'accesso, ed elenchi ciò che trova nella sua dichiarazione dei cookie.

  • Tag inseriti nel codice. Uno <script src>, un pixel <img> o un <iframe> scritto nella code injection, nel tema o in una HTML card viene recuperato dal browser prima che qualsiasi script possa fermarlo, anche quando Consentl ne impedisce l'esecuzione. Contrassegni manualmente tali tag e rimuova i pixel in <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">

    I tag caricati dal codice (GTM, il loader JavaScript di un pixel) vengono trattenuti senza alcuna richiesta quando il blocco automatico è attivo (dal piano Business in su).

  • Ghost(Pro) Starter non consente di caricare temi personalizzati, quindi è disponibile solo il metodo A.

Serve aiuto? Scriva a support@consentl.com: rispondiamo in inglese nei giorni lavorativi.