Documentazione FitConsent CMP
Guida completa all'installazione e configurazione di FitConsent CMP. Installa banner per il consenso ai cookie, configura Google Consent Mode V2 e Microsoft UET, e rispetta il GDPR, CCPA e oltre 15 normative sulla privacy globali.
Introduzione
Benvenuto nella documentazione della Piattaforma di gestione del consenso (CMP) FitConsent. Questa guida copre tutto il necessario per installare, configurare e sfruttare al meglio FitConsent — dal primo tag script alla gestione avanzata dei dati di consenso.
Cos'è una Piattaforma di gestione del consenso (CMP)?
Una Piattaforma di gestione del consenso (CMP) è uno strumento che aiuta i siti web a raccogliere e gestire legalmente il consenso degli utenti per il trattamento dei dati, un requisito previsto da leggi sulla privacy come il GDPR in Europa e il CCPA/CPRA in California. È la tecnologia che alimenta i banner sui cookie che si vedono sui siti web di tutto il mondo.
FitConsent va oltre un semplice banner. Fornisce gli strumenti per conformarsi alla legge e costruire la fiducia degli utenti ottimizzando l'esperienza di consenso. Il nostro servizio include supporto completo e automatico per Google Consent Mode V2 e Microsoft UET Consent Mode.
Funzionalità Principali
Integrazione automatica di Google Consent Mode V2 e Microsoft UET Consent Mode
Supporto per 16 framework normativi globali: GDPR, CCPA, TCF, ePrivacy, UCPA, VCDPA, CTDPA, LGPD, PIPEDA, APPI, PDPA, APA-NZPA, FADP, POPIA e altri
Oltre 100 lingue con rilevamento automatico della lingua
Ottimizzatore banner basato su IA (piani Pro+)
Dichiarazione di archiviazione (tabella cookie) per le pagine della privacy policy
Pulsante trigger flottante per aggiornare il consenso in qualsiasi momento
Anteprima in tempo reale nella dashboard
Strumento di diagnostica integrato per verificare la corretta installazione
Installazione e Configurazione
L'integrazione di FitConsent è progettata per essere rapida e semplice. Scegli il metodo più adatto alla tua piattaforma.
Prerequisiti
Prima di iniziare, assicurati di avere:
Creato un account FitConsent e registrato il tuo sito web nella dashboard
Il tuo ID sito web univoco (disponibile nella pagina di configurazione del sito)
Deciso quale framework normativo si applica al tuo pubblico
Incorporazione Diretta
Per i siti HTML standard, copia il codice seguente e incollalo nella sezione <head> il più in alto possibile — prima di qualsiasi script Google Analytics, Google Ads o Microsoft UET.
<!-- FitConsent CMP: Imposta i consensi predefiniti PRIMA di tutti gli altri script -->
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
window.uetq = window.uetq || [];
// Consenso predefinito: negato fino all'interazione dell'utente
gtag('consent', 'default', {
'ad_storage': 'denied',
'ad_user_data': 'denied',
'ad_personalization': 'denied',
'analytics_storage': 'denied'
});
window.uetq.push('consent', 'default', { 'ad_storage': 'denied' });
</script>
<!-- Carica qui gli altri script (Google Analytics, UET, ecc.) -->
<!-- Banner FitConsent: aggiorna il consenso in base all'interazione dell'utente -->
<script async defer src="https://app.fitconsent.com/api/banner?websiteId=IL_TUO_WEBSITE_ID"></script>Sostituisci IL_TUO_WEBSITE_ID con il tuo ID sito web reale dalla dashboard. Questo script deve apparire prima di qualsiasi tag che legge o imposta cookie.
Google Tag Manager (Consigliato)
L'utilizzo del template ufficiale della community GTM di FitConsent è il metodo di installazione consigliato.
Passaggio 1: Abilitare la Panoramica del Consenso
1. Nel tuo spazio di lavoro GTM, clicca sulla scheda "Amministrazione".
2. Sotto la colonna "Contenitore", clicca su "Impostazioni contenitore".
3. Spunta "Abilita panoramica del consenso" e clicca su "Salva".
Passaggio 2: Aggiungere il Template FitConsent
1. Vai su "Template" > "Template tag" > "Cerca nella galleria".
2. Cerca "FitConsent" e clicca su "Aggiungi allo spazio di lavoro".
3. Accetta la richiesta di autorizzazioni.
Passaggio 3: Creare il Tag "Consenso Predefinito Google"
1. Vai su "Tag" > "Nuovo", denominalo "FitConsent – Consenso predefinito".
2. Scegli "FitConsent" come tipo di tag.
3. Nel menu a tendina "Tipo di tag", seleziona "Google Consent Default".
4. Inserisci il tuo ID sito web nel campo "FitConsent Website ID".
5. Imposta l'attivatore su "Inizializzazione consenso – Tutte le pagine".
6. Salva il tag.
Passaggio 4: Creare il Tag "Caricatore Banner"
1. Crea un nuovo tag denominato "FitConsent – Caricatore banner".
2. Scegli "FitConsent" come tipo di tag.
3. Inserisci il tuo ID sito web e imposta l'attivatore su "Inizializzazione consenso – Tutte le pagine".
4. Salva il tag.
Passaggio 5: Configurare il Tag Google
Se hai già un Tag Google (GA4): modifica il tag > "Impostazioni avanzate" > "Impostazioni consenso" > seleziona "Nessun consenso aggiuntivo richiesto".
Passaggio 6: Gestire Script di Terze Parti
Per script come Microsoft Clarity o Meta Pixel: modifica il tag > "Impostazioni avanzate" > "Impostazioni consenso" > "Richiedi consenso aggiuntivo per attivare il tag" > aggiungi analytics_storage o ad_storage.
Clicca su "Invia" e "Pubblica" il tuo contenitore GTM.
Plugin WordPress
FitConsent è disponibile come plugin ufficiale su WordPress.org. Fornisce compatibilità automatica con la WP Consent API, lo standard utilizzato da Google Site Kit.
Installazione tramite la Dashboard WordPress
1. Vai su "Plugin" > "Aggiungi nuovo".
2. Cerca "FitConsent CMP" e clicca su "Installa ora", poi "Attiva".
Configurazione Post-installazione
1. Vai su "Impostazioni" > "FitConsent".
2. Inserisci il tuo ID sito web FitConsent.
3. Clicca su "Salva modifiche".
Se utilizzi Google Site Kit, abilita la "Modalità di consenso" nelle sue impostazioni. FitConsent comunica automaticamente con Site Kit tramite la WP Consent API.
Altre Piattaforme
FitConsent funziona con qualsiasi piattaforma che permette HTML o JavaScript personalizzato (Shopify, Drupal, Webflow, ecc.). Usa l'integrazione GTM se disponibile, altrimenti il metodo di incorporazione diretta.
Configurare il Banner
Tutta la configurazione è gestita dalla dashboard FitConsent. Apri la pagina di configurazione del tuo sito web per accedere a tutte le impostazioni. Le modifiche sono visualizzate in anteprima in tempo reale nel pannello destro.
Impostazioni Generali
Dominio: Il dominio del tuo sito web (es.: example.com).
ID Google Analytics: Inserisci il tuo ID GA4 (es.: G-XXXXXXXXXX).
Framework: Scegli il framework normativo sulla privacy applicabile ai tuoi visitatori.
| Framework | Ideale Per | Regione |
|---|---|---|
| Auto | Applica automaticamente GDPR o CCPA in base alla posizione del visitatore | Globale |
| GDPR | Regolamento Generale sulla Protezione dei Dati dell'UE | Unione Europea / SEE |
| CCPA | California Consumer Privacy Act | California, USA |
| ePrivacy | Direttiva ePrivacy dell'UE (legge sui cookie) | Unione Europea |
| TCF | Framework di Trasparenza e Consenso IAB | Editori e reti pubblicitarie |
| UCPA | Utah Consumer Privacy Act | Utah, USA |
| VCDPA | Virginia Consumer Data Protection Act | Virginia, USA |
| CTDPA | Connecticut Data Privacy Act | Connecticut, USA |
| LGPD | Legge Generale sulla Protezione dei Dati del Brasile | Brasile |
| PIPEDA | Legge Canadese sulla Protezione delle Informazioni Personali | Canada |
| APPI | Legge Giapponese sulla Protezione delle Informazioni Personali | Giappone |
| PDPA | Legge Tailandese sulla Protezione dei Dati Personali | Tailandia |
| APA-NZPA | Leggi sulla Privacy di Australia e Nuova Zelanda | Australia / Nuova Zelanda |
| FADP | Legge Federale Svizzera sulla Protezione dei Dati | Svizzera |
| POPIA | Legge Sudafricana sulla Protezione delle Informazioni Personali | Sudafrica |
| Nessuno | Nessun framework automatico — controllo completamente manuale | Qualsiasi |
Per siti web con pubblico internazionale, seleziona "Auto". FitConsent mostrerà automaticamente il banner GDPR per i visitatori europei e il banner CCPA per i visitatori californiani.
Geotargeting: Scegli chi vede il banner:
Nessuno — Tutti i visitatori vedono il banner
GDPR — Solo i visitatori dai paesi UE/SEE vedono il banner
Domini Aggiuntivi
Disponibile nei piani Pro Large e Business. I domini aggiuntivi ti consentono di caricare lo stesso banner su fino a 5 domini aggiuntivi di tua proprietà — utile per ambienti di staging, domini regionali o configurazioni multi-brand.
Per aggiungere un dominio aggiuntivo:
1. Apri la pagina di configurazione del tuo sito web nella dashboard.
2. Vai alla scheda Impostazioni Generali.
3. Scorri fino alla scheda Domini Aggiuntivi.
4. Clicca su Aggiungi dominio e inserisci il nome host semplice (es. staging.example.com o miomarchio.it) — senza prefisso https:// o barre finali.
5. Ripeti per fino a 5 domini, poi salva la configurazione.
Se la sezione Domini Aggiuntivi appare bloccata nonostante un piano Pro Large o Business, contatta il supporto — il tuo abbonamento potrebbe non essere ancora correttamente applicato a questo sito web.
Modalità di Consenso
Modalità Avanzata (Consigliata)
I tag Google si caricano immediatamente ma operano con raccolta dati limitata fino all'ottenimento del consenso.
Prima del consenso: I tag inviano "ping anonimi senza cookie" — nessun cookie identificativo viene impostato.
Dopo il consenso: La raccolta completa dei dati è abilitata in base alle scelte dell'utente.
Vantaggio chiave: Abilita il Modello di conversione di Google, che recupera i dati di attribuzione persi.
Modalità Base (Blocco Rigido)
Tutti gli script di tracciamento sono completamente bloccati fino a quando l'utente non concede il consenso.
<!-- Script bloccato per la Modalità Base -->
<script
type="text/plain"
data-cookieconsent="analytics"
async
src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXX">
</script>Mappatura categorie:
analytics → Google Analytics (GA4), Microsoft Clarity
marketing → Google Ads, Meta Pixel, LinkedIn
functional → Chatbot, strumenti di personalizzazione
| Funzionalità | Modalità Base | Modalità Avanzata |
|---|---|---|
| Tag Google | Bloccati fino al consenso | Si caricano immediatamente (limitati) |
| Dati prima del consenso | Zero dati | Ping senza cookie (modellazione) |
| Livello di privacy | Il più rigido | Conforme GDPR / DMA |
| Modellazione conversioni | Non disponibile | Disponibile |
Aspetto
Layout e Animazione
Tipo: Banner (barra orizzontale) o Dialogo (sovrapposizione centrata)
Posizione: Basso, Alto, Basso-Sinistra, Basso-Destra, Alto-Sinistra, Alto-Destra, Centro
Stile animazione: Spring (elastico), Slide (scorrimento), Fade (dissolvenza), Nessuna
Accento bordo: Nessuno, Alto, Sinistra (striscia colorata), Gradiente
Tipografia
Font: Inter, DM Sans, Plus Jakarta Sans, Nunito, Outfit, Lato, Poppins, Raleway, Merriweather, Playfair Display, Source Code Pro
Allineamento titolo: Sinistra, Centro, Destra
Forma ed Elevazione
Raggio bordo: Nessuno, SM, MD, LG, XL, 2XL
Raggio bordo pulsanti: Nessuno, SM, MD, LG, XL, Pieno
Elevazione (ombra): Nessuna, SM, MD, LG, XL
Colori
Ogni campo colore supporta indipendentemente la modalità chiara e modalità scura:
Colore testo, Colore titolo, Colore sfondo
Colore pulsanti, Colore testo pulsanti, Colore bordo pulsanti
Colore divisore, Colore scheda attiva, Colore scheda inattiva
Logo e Immagine di Sfondo
URL logo: Mostra il logo della tua azienda nel banner.
Immagine di sfondo: Immagini separate per Desktop Chiaro, Desktop Scuro, Mobile Chiaro e Mobile Scuro.
Contenuto e Lingue
Campi di testo configurabili:
Intestazione del banner
Messaggio del banner (supporta Markdown: grassetto, *corsivo*, [link](url))
Etichetta pulsante "Accetta tutto"
Etichetta pulsante "Rifiuta"
Etichetta pulsante "Gestisci preferenze"
Titolo e descrizione del modal preferenze
Etichetta pulsante "Salva preferenze"
Etichette schede: Consenso, Preferenze, Dichiarazione archiviazione
Impostazioni di Comportamento
Pulsanti
Abilita pulsante Rifiuta: Mostra o nascondi l'opzione "Rifiuta".
Abilita pulsante Gestisci: Mostra o nascondi l'opzione "Gestisci preferenze".
Categorie di Consenso
Necessario (sempre attivo): Cookie essenziali per il funzionamento del sito
Analytics: Analisi e monitoraggio delle prestazioni del sito
Marketing: Pubblicità e remarketing
Funzionale: Personalizzazione e funzionalità avanzate
Pulsante Trigger Flottante
Abilita: Attiva o disattiva il pulsante flottante.
Posizione: Basso-Sinistra o Basso-Destra.
Colori: Colore sfondo e colore icona per modalità chiara e scura.
Impostazioni Specifiche CCPA
Link "Non vendere": URL alla pagina "Non vendere le mie informazioni personali".
Link "Limita utilizzo": URL alla pagina "Limita l'uso delle mie informazioni personali sensibili".
Vendita dati: Indica se il tuo sito vende o condivide dati personali con terze parti.
Ottimizzatore IA
Disponibile nei piani Pro+. L'ottimizzatore IA analizza il contenuto, il brand e il pubblico target del tuo sito per suggerire combinazioni di colori ottimali, testi per il banner e miglioramenti al layout.
Dichiarazione di Archiviazione
FitConsent può mostrare una tabella aggiornata automaticamente di tutti i cookie e gli elementi di archiviazione utilizzati dal tuo sito web.
HTML Standard
<div id="fitconsent-declaration"></div>
<script async defer src="https://app.fitconsent.com/api/declaration?websiteId=IL_TUO_WEBSITE_ID"></script>React & Next.js
Per evitare errori di idratazione, carica lo script lato client usando un hook useEffect.
'use client';
import { useEffect } from 'react';
type Props = {
websiteId: string;
};
export function StorageDeclarationEmbed({ websiteId }: Props) {
useEffect(() => {
const script = document.createElement('script');
script.src = `https://app.fitconsent.com/api/declaration.js?websiteId=${websiteId}`;
script.async = true;
script.defer = true;
const container = document.getElementById('fitconsent-declaration');
if (container) {
container.appendChild(script);
}
return () => {
if (container && container.contains(script)) {
container.removeChild(script);
}
};
}, [websiteId]);
return <div id="fitconsent-declaration"></div>;
}Questo approccio garantisce che lo script venga caricato ed eseguito in modo sicuro lato client, evitando conflitti con il ciclo di rendering di React.
Utilizzo Avanzato
Utilizzare i Dati di Consenso sul Tuo Sito
Dopo l'interazione dell'utente, FitConsent memorizza le sue scelte in un cookie denominato fitconsent_given.
Struttura del Cookie
{
"choices": {
"necessary": true,
"analytics": true,
"marketing": false
},
"geo": {
"country": "IT",
"state": null
}
}choices: Un oggetto in cui ogni chiave è una categoria di consenso e il valore è true (accettato) o false (rifiutato).
geo: Contiene la posizione geografica dell'utente al momento del consenso.
Lettura del Consenso Lato Client
function getFitConsentChoices() {
const cookie = document.cookie
.split('; ')
.find(row => row.startsWith('fitconsent_given='));
if (!cookie) return null;
try {
return JSON.parse(decodeURIComponent(cookie.split('=')[1]));
} catch {
return null;
}
}
const consent = getFitConsentChoices();
if (consent?.choices?.analytics) {
// Inizializza il tuo script di analisi
}Rilevamento Automatico della Lingua
Il banner FitConsent rileva automaticamente la lingua preferita dell'utente in questo ordine:
1. L'attributo lang del tag <html> (es.: <html lang="it">). Questo è il metodo più affidabile.
2. L'impostazione navigator.language del browser.
3. Ritorna all'inglese (en) o alla prima lingua nella lista configurata.
Strumento di Diagnostica
Utilizza lo strumento di diagnostica integrato nella tua pagina di configurazione FitConsent per verificare che il banner sia correttamente installato. Lo strumento verifica: rilevamento dello script banner, stato dei valori predefiniti della modalità di consenso, stato dell'integrazione dei tag Google, e problemi rilevati con raccomandazioni.
Migrazione: Modalità Avanzata → Modalità Base
1. Cambia la configurazione FitConsent in "basic".
2. Rimuovi il blocco script "Consent Default" dal tuo <head>.
3. Aggiungi type="text/plain" e data-cookieconsent="..." a tutti i tuoi tag script di tracciamento.
4. Cancella i cookie del browser e testa nuovamente.
Dopo il passaggio alla Modalità Base, perderai tutti i dati pre-consenso, inclusi i dati di modellazione anonima. Questo non può essere recuperato retroattivamente.
Ready to simplify your compliance?
Implement a reliable Consent Management Platform (CMP) today and ensure you stay compliant with all global regulations.
Start Your Free Trial