Passa al contenuto principale

Installazione Manuale

Tempo: ~5 minuti Requisiti: Accesso al codice sorgente HTML del vostro sito web

Passo 1: Copiate il vostro snippet di incorporamento​

Nel vostro dashboard ConsentForge, andate su Proprietà → Incorporamento e copiate il vostro snippet:

<script
  src="https://cdn.consentforge.com/consentforge.min.js"
  data-token="YOUR_EMBED_TOKEN"
  data-position="bottom"
  data-theme="auto"
  defer
></script>

Passo 2: Aggiungetelo al vostro HTML​

Incollate lo snippet prima di </head> — non in fondo al <body>.

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>Il Mio Sito</title>
  <!-- ConsentForge — deve essere prima di qualsiasi script di terze parti -->
  <script
    src="https://cdn.consentforge.com/consentforge.min.js"
    data-token="cf_live_abc123"
    defer
  ></script>
</head>
<body>
  ...
</body>
</html>
L'ordine è importante

Lo script di ConsentForge deve caricarsi prima di qualsiasi script di terze parti (Google Analytics, Meta Pixel, ecc.) affinché il blocco degli script funzioni correttamente.

Passo 3: Contrassegnate gli script di terze parti per il blocco​

Aggiungete type="text/plain" e data-consent-category a qualsiasi script che volete bloccare finché non viene dato il consenso:

<!-- PRIMA: si carica immediatamente, ignora il consenso -->
<script src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>

<!-- DOPO: bloccato finché l'utente non acconsente ad "analytics" -->
<script
  type="text/plain"
  data-consent-category="analytics"
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"
></script>

Valori di categoria:

ValoreSignificato
necessarySi carica sempre (nessun blocco)
analyticsSi carica dopo il consenso agli analytics
marketingSi carica dopo il consenso al marketing
functionalSi carica dopo il consenso funzionale

Passo 4: Testate​

Aprite il vostro sito in una finestra in incognito. Il banner per il consenso dovrebbe apparire prima che si carichi qualsiasi script bloccato. Verificate in DevTools → Rete che gli script bloccati non appaiano fino a dopo il consenso.

Esempi comuni​

Google Analytics 4​

<script type="text/plain" data-consent-category="analytics"
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script type="text/plain" data-consent-category="analytics">
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-XXXXXX');
</script>

Meta Pixel​

<script type="text/plain" data-consent-category="marketing">
  !function(f,b,e,v,n,t,s)
  {if(f.fbq)return;n=f.fbq=function(){...}
  fbq('init', 'YOUR_PIXEL_ID');
  fbq('track', 'PageView');
</script>

Incorporamento YouTube​

<!-- Usate data-src invece di src -->
<iframe
  data-src="https://www.youtube.com/embed/VIDEO_ID"
  data-consent-category="marketing"
  width="560" height="315"
  frameborder="0">
</iframe>