CookiePilot

Installa CookiePilot e vincola ogni tracker al consenso

Carica prima lo stub di consenso predefinito, poi il banner e infine i tuoi tracker. Scegli il percorso adatto a come vengono caricati i tuoi script.

Inizia gratisLeggi la documentazione

Scegli il metodo di installazione

1Metodo

Direttamente nell’<head>

Consigliato quando GA4 o Meta vengono iniettati dai plugin e vuoi un unico punto in cui controllarli.

Passaggi

  1. 1Incolla lo stub di consenso predefinito in cima all’<head>, con ogni categoria impostata su denied.
  2. 2Aggiungi lo script del banner CookiePilot subito dopo lo stub.
  3. 3Sposta GA4, Meta e gli altri tracker sotto il banner e caricali solo dopo il consenso.
  4. 4Ridistribuisci e ricarica senza cache così da servire il nuovo ordine.
2Metodo

Tramite Google Tag Manager

Consigliato quando i tuoi tag vivono già in un container GTM.

Passaggi

  1. 1Tieni lo stub di consenso predefinito nell’<head>, prima del container GTM.
  2. 2Carica il loader CookiePilot una sola volta: o subito dopo lo stub di consenso predefinito nell’<head>, oppure come un unico tag HTML personalizzato sul trigger Consent Initialization. Mai entrambe le strade.
  3. 3Vincola ogni tag GTM al consenso corrispondente, così nulla si attiva prima di Accetta.
  4. 4Ricorda: GTM non controlla i tracker caricati al suo esterno dai plugin del CMS. Portali dentro GTM oppure bloccali direttamente.
3Metodo

Plugin o modulo del CMS

Consigliato solo quando esiste un’integrazione CookiePilot documentata per la tua piattaforma specifica e preferisci configurarla dal pannello di amministrazione.

Passaggi

  1. 1Conferma prima che esista un’integrazione CookiePilot documentata per la tua piattaforma; in caso contrario, usa le istruzioni dirette nell’<head> o tramite GTM.
  2. 2Verifica il codice sorgente generato della pagina: lo stub di consenso predefinito e il banner CookiePilot devono comparire prima dei tracker. Se l’ordine è errato, correggilo con la guida diretta.
  3. 3Controlla ogni plugin di analytics o marketing separato: ciascuno deve comunque leggere il consenso di CookiePilot prima di caricarsi.
  4. 4Disattiva ogni plugin che esegue script propri senza controllare il consenso.
4Metodo

Sorgenti miste

Consigliato quando i tracker arrivano da più punti contemporaneamente (tema, plugin, GTM, tag scritti a mano).

Passaggi

  1. 1Fai l’inventario di ogni sorgente di script: tema, plugin, GTM e tag scritti a mano.
  2. 2Tieni un solo stub di consenso predefinito e un solo loader cookiepilot.js su tutte le sorgenti e rimuovi ogni duplicato, così nulla si carica due volte.
  3. 3Vincola ogni sorgente alla categoria di consenso corretta.
  4. 4Riesegui la scansione dopo ogni modifica per intercettare un nuovo script sfuggito senza blocco.

Esempi di codice sicuri

Incolla questi blocchi nell'ordine mostrato. Sostituisci i segnaposto YOUR_* con i tuoi valori.

Ordine di caricamento corretto

  1. 1Incolla lo stub di consenso predefinito in cima all’<head>, con ogni categoria impostata su denied.
  2. 2Aggiungi lo script del banner CookiePilot subito dopo lo stub.
  3. 3Sposta GA4, Meta e gli altri tracker sotto il banner e caricali solo dopo il consenso.
1. consent-default stub
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){ dataLayer.push(arguments); }
  gtag('consent', 'default', {
    ad_storage: 'denied',
    analytics_storage: 'denied',
    ad_user_data: 'denied',
    ad_personalization: 'denied',
    functionality_storage: 'denied',
    personalization_storage: 'denied',
    security_storage: 'granted',
    wait_for_update: 500,
  });
</script>
2. CookiePilot banner
<script async
  src="https://cdn.cookiepilot.io/cookiepilot.js"
  data-cpkey="YOUR_SITE_KEY"
></script>
3. GA4
<script>
  window.addEventListener('cookiepilot:consent', function(event) {
    var consent = event.detail || {};
    if (!consent.analytics || window.__cookiepilotGa4Loaded) return;
    window.__cookiepilotGa4Loaded = true;
    var ga = document.createElement('script');
    ga.async = true;
    ga.src = 'https://www.googletagmanager.com/gtag/js?id=' +
      encodeURIComponent('YOUR_GA4_ID');
    ga.onload = function() {
      gtag('js', new Date());
      gtag('config', 'YOUR_GA4_ID');
    };
    document.head.appendChild(ga);
  });
</script>
3. GTM
<script>
  (function(w,d,s,l,i){
    w[l]=w[l]||[];
    w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});
    var f=d.getElementsByTagName(s)[0],j=d.createElement(s),
      dl=l!='dataLayer'?'&l='+l:'';
    j.async=true;
    j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;
    f.parentNode.insertBefore(j,f);
  })(window,document,'script','dataLayer','YOUR_GTM_ID');
</script>

Installare il banner da solo non blocca i tuoi script

CookiePilot mostra il banner e registra il consenso, ma non può bloccare in silenzio script che non controlla. Ogni tracker caricato da un tema, un plugin o un tag GTM continua ad attivarsi finché non lo vincoli al consenso. Tratta ogni sorgente separatamente e conferma che resti muta prima del consenso.

Verifica in una sessione pulita

  • Prima del consenso

    Apri il sito in una nuova finestra privata. Prima di cliccare qualsiasi cosa, nessuno script di analytics o marketing deve girare e nessun cookie non essenziale deve essere impostato.

  • Dopo Rifiuta

    Clicca Rifiuta. Ricarica e conferma che i tracker continuano a non caricarsi e che non compare alcun cookie non essenziale.

  • Dopo Accetta

    Clicca Accetta. Conferma che ora i tracker si caricano e che i loro cookie compaiono, in linea con le categorie accettate.

Pronto a installare in pochi minuti?

Crea un progetto, copia la tua site key e vincola ogni tracker a un consenso reale.

Inizia gratisLeggi la documentazione