Installare CookieHawk
Scegli la piattaforma e inserisci il codice generico. Shopify, Wix, Squarespace e Webflow sono stati testati solo come modelli locali di inserimento statico. Non abbiamo testato account reali, temi, app, consenso nativo o checkout. Chiarire questi punti prima di pubblicare.
1. Codice e ordine
Inserisci il loader come primo script in head, prima di GTM e del tracciamento. Non usare async/defer. Imposta data-policy-url sulla tua pagina privacy. Scegli la lingua del banner nb, nn, sv o en; la lingua della guida non cambia quella del banner. Usa una sola installazione.
<script src="https://cookiehawk.com/loader.js" data-core="https://cookiehawk.com/cmp.js" data-lang="nb" data-policy-url="/personvern.html" data-strict-gtm="1"></script>2. Marcare gli script statici
Gli script di tracciamento nell’HTML richiedono type=text/plain, data-cookiehawk-cat e data-cookiehawk-src. L’esempio usa statistics; scegli marketing per annunci e functional per funzioni opzionali. Il codice inline usa lo stesso tipo e categoria, mantenendo il codice tra i tag script. Le categorie sconosciute non vengono sbloccate.
<script type="text/plain" data-cookiehawk-cat="statistics" data-cookiehawk-src="https://www.googletagmanager.com/gtag/js?id=G-XXXX"></script>3. Guide per piattaforma
HTML
HTML: inserisci il codice subito dopo l’apertura di head in ogni modello di pagina. Marca i tag statici. Testa prima visita e ricaricamento con scelta salvata.
Shopify
Shopify: duplica il tema. Apri il tema del negozio → Edit code → layout/theme.liquid. Inserisci il codice per primo in head e marca i tuoi script statici di tracciamento. Copre solo l’HTML del tema. Non integra Customer Privacy API, pixel delle app, account cliente o checkout. Non sostituire il consenso Shopify senza chiarire e testare questi flussi.
Wix
Wix: apri Settings → Custom Code → Add Custom Code. Scegli head e tutte le pagine. Su una pagina di prova pubblicata verifica che il loader preceda il tracciamento e venga eseguito una sola volta per documento. Wix può caricare codice dinamicamente; il test locale non dimostra l’ordine reale né il comportamento di Wix Analytics o app. Un iframe HTML non installa il banner sull’intero sito.
Squarespace
Squarespace: apri Code Injection e inserisci il codice all’inizio di Header. Serve un piano con code injection. Verifica l’ordine della pagina pubblicata e marca gli script statici. Checkout, integrazioni native e navigazione senza ricaricamento completo non sono verificati.
Webflow
Webflow: Site settings → Custom code → Head code. Inserisci il codice prima del tracciamento, salva e pubblica su un dominio di prova. Controlla ogni modello e il codice in Page settings. L’anteprima Designer non basta. Ecommerce e integrazioni non verificati.
WordPress
WordPress: scarica lo ZIP, apri Plugin → Aggiungi nuovo → Carica, installa e attiva. In Impostazioni → CookieHawk Consent scegli lingua e pagina privacy. Evita installazioni duplicate tramite tema/GTM. Attiva il registro con la configurazione cliente che forniamo.
Google Tag Manager
GTM: installa il loader direttamente in head, non dentro GTM. Marca il contenitore statistics|marketing. Può caricarsi con una delle due scelte; ogni tag deve controllare la propria categoria. Custom HTML deve richiedere cookiehawk.marketing=true o cookiehawk.statistics=true su cookiehawk_consent_update. Il solo evento non è consenso. Rimuovi trigger che aggirano il controllo e iframe noscript opzionali.
<script type="text/plain" data-cookiehawk-cat="statistics|marketing" data-cookiehawk-src="https://www.googletagmanager.com/gtm.js?id=GTM-XXXX"></script>Google Consent Mode v2: sei segnali regolati dal consenso controllano archiviazione pubblicitaria e analitica, dati pubblicitari, annunci personalizzati, funzionalità e personalizzazione. I tag Google Ads e GA4 configurati correttamente seguono il consenso. security_storage è granted; gli altri sei iniziano con denied.
Microsoft UET
Microsoft UET: il banner invia consent/default con ad_storage=denied e consent/update secondo il consenso marketing, incluse scelte salvate e revoca. Marca UET come marketing. Il blocco rigoroso rimane; non promette Microsoft Advanced Consent Mode o conversioni modellate. Verifica il traffico UET reale del cliente.
4. Test prima di pubblicare
Usa una sessione pulita e il registro Network. Prima della scelta e dopo il rifiuto: nessuna richiesta dai tag opzionali marcati. Testa anche solo statistiche e solo marketing. Dopo l’accettazione i tag consentiti vengono eseguiti una volta. Ricarica per verificare la scelta salvata. Revoca e verifica ricaricamento e cessazione delle chiamate opzionali. Testa più pagine, mobile, tastiera e link privacy. Loader/cmp devono rispondere 200. Il solo stato del consenso non dimostra il blocco di rete.
Limiti e ulteriore configurazione
fetch/XHR/beacon, Workers, shadow DOM, srcdoc e tracciamento sul server richiedono interventi specifici. Un test locale non certifica una piattaforma. Registro ed esportazione richiedono configurazione cliente registrata, informazioni banner archiviate e verifica degli eventi ricevuti. Contattaci per attivare.