Codice di integrazione
Seleziona il dominio e copia lo snippet da integrare nel sito del cliente.
Integrazione via script tag
Incolla questo codice nel <head> del sito del cliente, prima di qualsiasi altro script di terze parti (Google Analytics, Meta Pixel, ecc.).
Attributi disponibili
| Attributo | Obbligatorio | Descrizione |
|---|---|---|
data-domain-id | ✓ Sì | ID univoco del dominio su CookieAegis |
data-api-url | No | URL del server CookieAegis (default: stesso origine) |
async | Raccomandato | Caricamento asincrono per non bloccare il rendering |
Come bloccare gli script di terze parti
Per bloccare preventivamente gli script non necessari (GDPR: opt-in), modifica gli script delle terze parti aggiungendo type="text/plain" e data-cn-category:
CookieAegis attiverà automaticamente gli script delle categorie accettate dall'utente.
Integrazione con Google Tag Manager
Scarica il template GTM di CookieAegis e importalo nel tuo container.
↓ Scarica template GTMScarica il template
Clicca il bottone qui sopra per scaricare il file cookieaegis-cmp.tpl.
Importa in GTM
In Google Tag Manager: Modelli → Nuovo → ⋮ → Importa, seleziona il file scaricato e salva.
Crea il tag
Tag → Nuovo, seleziona il modello "CookieAegis CMP", inserisci il Domain ID nel campo apposito, imposta il trigger Consent Initialization - All Pages con priorità 999.
Il tuo Domain ID per questo dominio:
Pubblica
Clicca Invia → Pubblica.
Codice da inserire nel <head>
Stesso codice dello Script diretto — incolla nel <head> prima di GTM e di qualsiasi tag di tracciamento.
API JavaScript
Dopo il caricamento dello snippet, puoi interagire con CookieAegis programmaticamente:
Link "Gestisci preferenze" nel footer
Inserisci questo link nel footer del sito per permettere agli utenti di riaprire il banner e modificare il consenso:
ID dominio
L'ID univoco di questo dominio su CookieAegis è:
Caricare widget custom dopo il consenso — senza refresh
Se hai script o widget caricati via GTM che devono apparire solo dopo il consenso (es. chatbot, mappe, video embed), CookieAegis pubblica due eventi nel dataLayer che GTM usa come trigger per caricarli immediatamente, senza richiedere un refresh di pagina.
I due eventi pubblicati da CookieAegis
cookieaegis_consent_ready — Pubblicato sincronicamente al caricamento pagina se l'utente ha già dato il consenso in una visita precedente:
cookieaegis_consent_updated — Pubblicato al click su Accetta / Rifiuta / Salva preferenze (prima visita o modifica successiva):
Crea le variabili Data Layer in GTM
In GTM → Variabili → Nuova variabile definita dall'utente. Ripeti per ogni categoria che ti serve:
| Nome variabile GTM | Tipo | Nome variabile Data Layer |
|---|---|---|
Consent Marketing | Variabile Data Layer | consent_state.marketing |
Consent Statistics | Variabile Data Layer | consent_state.statistics |
Consent Preferences | Variabile Data Layer | consent_state.preferences |
Crea il trigger "Consenso CookieAegis"
In GTM → Trigger → Nuovo → Evento personalizzato:
| Campo GTM | Valore |
|---|---|
| Nome evento | cookieaegis_consent_updated|cookieaegis_consent_ready |
| Usa espressione regolare | Attivato |
| Attiva su | Alcuni eventi personalizzati |
| Condizione aggiuntiva | {{Consent Marketing}} uguale a true |
Sostituisci marketing con la categoria adatta al tuo widget: statistics, preferences o marketing.
Assegna il trigger al tag del widget
In GTM → Tag → il tuo tag: sostituisci il trigger "Tutte le pagine" con il trigger CookieAegis creato al passo 2, poi pubblica.
Verifica in console
Incolla questo snippet nella console del browser per verificare che gli eventi siano presenti nel dataLayer:
Prima visita: apri in incognito → accetta i cookie → verifica cookieaegis_consent_updated nel dataLayer.
Visita successiva: apri normalmente → verifica cookieaegis_consent_ready al caricamento, prima che GTM processi i tag.
Modifica preferenze: apri il pannello → salva → verifica un nuovo cookieaegis_consent_updated.