Menu della documentazione

Configurare i servizi Google

Configurazione lato Google per Consent Mode v2: GA4, Google Ads, GTM e verifica end-to-end insieme a CookieHug.

Partner CMP di Google — requisiti del banner (Sprint 5)

CookieHug è progettato per soddisfare i requisiti sul banner del programma Partner CMP di Google. Questa sezione associa a ciascun requisito di Google la funzione che lo soddisfa, così i clienti che richiedono la certificazione possono indicare un'implementazione concreta. Riferimento: la guida avanzata a Consent Mode v2 di Google — developers.google.com/tag-platform/security/guides/consent?consentmode=advanced.

Requisito 1 — banner completamente configurabile da un'interfaccia

L'intero banner si configura senza toccare codice. Il pannello di amministrazione (Dettaglio del dominio) espone ogni proprietà del banner tramite controlli grafici: nessun campo richiede codice, file di configurazione o chiamate API.

Scheda / sezione dell'interfaccia	Controlli
Testi del banner	Titolo, descrizione, testo in piccolo, etichette accetta/rifiuta/accetta selezione, testo del link alle categorie
Layout	Posizione (sinistra/destra/in basso al centro/centro), raggio degli angoli, allineamento del testo, Google Font, icona cookie facoltativa (emoji/SVG), posizione del pulsante categorie
Colori	Sfondo del banner, titolo, descrizione, link, testo in piccolo, pulsanti accetta/rifiuta/categorie (sfondo/testo/hover/bordo)
Categorie	Attiva/disattiva le 4 categorie, etichette e descrizioni per categoria, inventario dei cookie
Google Consent Mode	Interruttori Ads/GA4/fuori CMP, valori predefiniti dei 4 segnali GCM v2, valori regionali (SEE/US-CA/ROW/personalizzati), corrispondenza categoria→segnale, interruttore del modello conforme CMP
Politica di consenso	Modello di consenso (opt-in / opt-out / solo informativa), gestione di GPC / DNT, adattatore USP (US Privacy), vista dopo il consenso
Diagnostica	Attivazione del Debug Mode, ricezione dei report di diagnostica lato client

Requisito 2 — modello di banner conforme ai requisiti di Google

CookieHug include un modello conforme al CMP di Google che i clienti attivano con un solo interruttore: Dettaglio del dominio → Google Consent Mode → Certificazione CMP Google → interruttore attivo. Una volta attivo, il banner soddisfa tutti e tre i sotto-requisiti:

(a) Finalità della raccolta dei dati. La descrizione predefinita spiega che i cookie servono a personalizzare i contenuti e ad analizzare il traffico. Il cliente può ampliare il testo dall'interfaccia: il campo è libero, quindi si possono aggiungere finalità specifiche del prodotto (es. «misurare le prestazioni degli annunci tramite Google»). Le schede di categoria espandibili, raggiungibili dal link Personalizza le preferenze sui cookie, elencano le finalità puntuali di ciascuna categoria.

(b) Link a https://business.safety.google/privacy. Viene reso in linea nel banner come <a> subito sotto il paragrafo di descrizione. È visibile già nella prima vista del banner: l'utente non deve allontanarsi né aprire un'altra pagina. Usa target="_blank" rel="noopener noreferrer".

(c) Opzione di consenso affermativo. Il banner mostra sempre un pulsante dedicato Accetta tutto come opt-in esplicito, non selezionato per impostazione predefinita. Tutti i segnali GCM v2 partono da "denied" e passano a "granted" solo dopo il clic su accetta: nessuna casella pre-selezionata, nessun consenso implicito dallo scorrimento, e il pulsante di rifiuto ha lo stesso peso visivo in ogni preset.

Requisito 3 — raccomandazione del modello nell'interfaccia

Quando un cliente attiva Google Consent Mode (tramite gli interruttori Google Ads collegato o Google Analytics 4 collegato) ma non ha ancora attivato il modello CMP, l'interfaccia mostra una raccomandazione in cima alla sezione Google Consent Mode:

> Consigliato: attiva il modello CMP di Google > Consent Mode v2 è attivo, ma il tuo banner non contiene il link alla privacy di Google richiesto. Attiva il modello CMP affinché il banner soddisfi i requisiti del programma Partner CMP di Google. > [Attiva il modello] • [Documentazione di Google Consent Mode]

La raccomandazione include un pulsante di attivazione con un clic e un link alla guida avanzata di Consent Mode. Sparisce automaticamente non appena il modello è attivo. CookieHug non supporta IAB TCF, quindi questa raccomandazione vale per tutte le implementazioni di Consent Mode fatte con la piattaforma.

Configurazione lato Google — panoramica

CookieHug gestisce automaticamente gtag('consent','default', …) e gtag('consent','update', …): lo snippet che incolli nell'<head> emette entrambi. Restano però tre cose da configurare lato Google perché Consent Mode v2 advanced funzioni da capo a fondo. Riferimento completo: developers.google.com/tag-platform/security/guides/consent?consentmode=advanced.

Lato Google, passo 1 — proprietà GA4

Apri la proprietà GA4 → Amministrazione → Raccolta e modifica dei dati → Raccolta dei dati.
Nella scheda Consent Mode verifica che Consent Mode sia attivo. Non esiste un interruttore «advanced» per proprietà: la modalità *advanced* si determina a livello di tag, in base al fatto che ad_storage e analytics_storage siano su denied prima che il tag parta (esattamente ciò che fa CookieHug).
Lascia Segnali Google e Segnali di personalizzazione degli annunci configurati secondo la tua politica di consenso: rispetteranno i segnali ad_user_data e ad_personalization che CookieHug deriva dalla categoria Marketing.
Attendi 24–48 ore dalle prime accettazioni, poi apri Amministrazione → Impostazioni della proprietà → Diagnostica Consent Mode (pannello interno di Google). Dovrebbe indicare il rilevamento della modalità advanced e un rapporto sano tra consent_update e consent_default.

Lato Google, passo 2 — Google Ads

In Google Ads → Strumenti → Gestione dati → Impostazioni del consenso (oppure Amministrazione → Consenso nella nuova interfaccia): attiva Consent Mode per l'account.
Per ogni azione di conversione Google inizierà ad applicare la modellazione comportamentale quando l'account avrà abbastanza traffico con consenso (di norma oltre 1000 clic sugli annunci in 7 giorni per paese). Fino a quella soglia gli avvisi di diagnostica possono riportare «Consent Mode non del tutto attivo»: è una soglia sui dati lato Google, non una configurazione errata di CookieHug.
Verifica in Strumenti → Conversioni → Diagnostica. I contatori di redacted_data e dei ping consent_default/consent_update devono essere entrambi maggiori di 0.

Lato Google, passo 3 — Google Tag Manager

Importante: non aggiungere un tag «Consent Initialization — All Pages» che chiami a sua volta gtag('consent','default', …). Lo snippet di CookieHug gira *prima* che GTM si carichi (grazie alla priorità nell'<head>), quindi i valori predefiniti sono già impostati. Una seconda chiamata default da GTM sovrascrive i valori regionali di CookieHug e rompe il controllo per il SEE.

In GTM carica i tuoi tag (GA4, Ads, Floodlight ecc.) normalmente: leggeranno lo stato del consenso già inviato da CookieHug.
Per ogni tag che deve rispettare Consent Mode apri Impostazioni avanzate → Impostazioni del consenso e aggiungi i tipi di consenso richiesti (es. ad_storage, analytics_storage). GTM bloccherà allora la scrittura di cookie o pixel quando il segnale è su denied ed eseguirà il tag in forma oscurata in modalità advanced.
Se usi il tag Google (gtag.js) direttamente (senza GTM) non serve altro: lo snippet di CookieHug gira prima del loader gtag.

Lato Google, passo 4 — verifica end-to-end

Installa Google Tag Assistant (estensione per Chrome) → attivalo → ricarica il tuo dominio in un profilo pulito. Nella scheda Summary dovresti vedere due eventi consent: uno default (prima dell'accettazione del banner) con analytics_storage=denied / ad_storage=denied e uno update (dopo l'accettazione) con i relativi segnali su granted.
Apri GA4 → Amministrazione → DebugView. Con il Debug Mode di CookieHug disattivato in produzione, usa un URL con ?gtm_debug=1 oppure attiva la modalità debug nell'anteprima di GTM per vedere lo stato del consenso su ogni evento.
Nella scheda Diagnostica di Google Ads attendi fino a 24 ore e verifica che l'indicatore stato di Consent Mode diventi verde.

Come verificare il banner pubblicato

Attiva il modello nell'interfaccia di amministrazione.
Rigenera lo script del dominio dalla finestra Ottieni lo script: il nuovo HTML del banner entra in vigore al successivo caricamento della pagina.
Carica il dominio di destinazione e apri il banner. Dovresti vedere il titolo, la descrizione, un link in linea *Scopri come Google protegge i tuoi dati* che punta a https://business.safety.google/privacy e i pulsanti *Accetta tutto / Rifiuta tutto* con pari evidenza.
Apri DevTools → Network → filtra su google. Prima dell'accettazione i tag GA/Ads devono partire con il consenso su denied; dopo il clic su accetta dovresti vedere gtag('consent','update') portare i quattro segnali su granted secondo la tua corrispondenza di categorie.