Consentl su BigCommerce

Installi Consentl su BigCommerce con Script Manager o nel tema Stencil per un blocco preventivo rigoroso, con checkout conforme a PCI e vetrine Catalyst.

Loader per primo nel <head>

Dipende dal metodo

Esistono due modi di installazione, a seconda di quanto debba essere rigoroso il blocco preventivo.

Prima di entrambi i metodi, decida che cosa fare con il consenso ai cookie di BigCommerce: Settings → Security & Privacy → Your customers' privacy → Cookie consent tracking.

• Consigliato: lo disattivi. Consentl mostra il banner e trattiene autonomamente gli script non essenziali; mantenendoli entrambi verrebbero mostrati due banner.
• Se lo mantiene attivo, BigCommerce genera gli script di Script Manager delle categorie Analytics, Functional o Targeting; Advertising solo dopo il proprio consenso, e i due banner dovrebbero essere mantenuti sincronizzati, cosa che questa guida non tratta. Consentl stesso deve allora essere nella categoria Essential, altrimenti non verrebbe mai caricato.

La sua chiave del sito Consentl si trova nella pagina Configurazione del suo sito nel pannello di controllo. Aggiunga il nome host del negozio nel campo Domini; www. e il dominio senza www contano come lo stesso sito, quindi non è necessario aggiungere www. separatamente.

Che cosa copre il suo piano Consentl

• Free: solo banner, registro dei consensi e blocco manuale.
• Pro: aggiunge Google Consent Mode v2.
• Business: aggiunge il blocco automatico dei tracker noti e le regole di blocco che aggiunge nel pannello di controllo.

Con Free e Pro vengono trattenuti solo i tag che contrassegna manualmente.

A. Script Manager (vetrine Stencil)

1. Pannello di controllo → Storefront → Script Manager → Create a Script.
2. Compili:
   • Name of script: Consentl
   • Location on page: Header
   • Select pages where script will be added: Store pages (pagine della vetrina). Non All pages; veda Checkout e My Account.
   • Script category: Essential
   • Script type: URL
   • Load method: Default. Mai Async o Defer: il loader deve essere eseguito in modo sincrono.
   • Script URL: https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=en (aggiunga &gcm=ext se il negozio usa anche il modello Consentl per GTM, così solo il modello invia i comandi di Consent Mode)
   • Integrity Hash: lo lasci vuoto. Il loader cambia quando modifica le impostazioni nel pannello di controllo Consentl, quindi un hash fisso farebbe sì che il browser lo rifiuti.
3. Save. A causa della cache, le modifiche possono richiedere circa 20 secondi per comparire.
4. Esegua il test in una finestra privata (veda Verificare che funzioni).

Script Manager limita il contenuto degli script a 64 KB. Il loader è uno script URL di una riga.

Checkout e My Account

• BigCommerce richiede un hash SRI per ogni script nella pagina di checkout: "All scripts on the checkout page need at least one SRI hash to meet PCI 4.0 - 6.4.3 requirements". La guida di BigCommerce estende questo requisito alla pagina My Account quando le carte memorizzate sono attive.
• Il loader di Consentl non può avere un hash stabile, quindi non deve essere inserito lì. Per questo sopra l'impostazione predefinita è Store pages, e per questo il metodo B deve tenere il loader fuori dal checkout.
• Di conseguenza, il checkout (e My Account quando le carte memorizzate sono attive) non mostrano alcun banner e lì non viene eseguito alcun runtime di Consentl.
• La scelta effettuata dal visitatore sulla vetrina viene conservata nel cookie di prima parte consentl e applicata di nuovo nella pagina successiva della vetrina. Consentl non trattiene nulla nel checkout stesso: tenga gli script non essenziali fuori dal checkout (selezioni Store pages anche per loro) e controlli che cosa vi caricano le integrazioni di Settings → Data Solutions.
• Gli script vengono generati nel checkout e nella conferma d'ordine solo con Optimized One-Page Checkout.

B. File del tema (davvero per primo)

1. Storefront → Themes: sul tema attuale scelga Advanced → Make a copy. BigCommerce consente di modificare i file del tema solo su una copia. Poi apra Advanced → Edit Theme Files della copia, oppure usi la Stencil CLI.

2. Apra templates/layout/base.html e incolli il loader subito dopo <head>, prima di {{{head.scripts}}} e dei CSS del tema:

   <head>
       <script src="https://api.consentl.com/v1/loader.js?k=SITE_KEY&l={{language_selector.active_language_code}}"></script>
       <title>{{ head.title }}</title>

   • {{language_selector.active_language_code}} è l'helper documentato per la lingua. Cornerstone ha anche {{locale_name}}, che lì funziona ma non è presente nel riferimento degli oggetti. Usi una lingua fissa come en se nessuno dei due restituisce il formato necessario.
   • Se Enable Nonce-Based Script Security è attivo (Settings → Security & Privacy), aggiunga nonce="{{nonce}}" al tag. Gli script che Consentl sblocca dopo il consenso richiedono allora anch'essi il nonce (lo assegni a ogni tag che contrassegna manualmente) oppure una policy con 'strict-dynamic'; altrimenti il browser li blocca.

3. Salvi e applichi la copia. Non aggiunga Consentl anche tramite Script Manager.

4. Gli aggiornamenti del tema sostituiscono base.html: aggiunga di nuovo la riga dopo ogni aggiornamento.

Non aggiunga il loader ai template del checkout (veda Checkout e My Account). Dopo aver applicato il tema, apra la pagina di checkout e verifichi con View Source che il loader non sia presente.

Tag inseriti nel codice

Uno <script src>, un pixel <img> o un <iframe> scritto nei file del tema o in uno script di Script Manager viene recuperato dal browser prima che qualsiasi script possa fermarlo, anche quando Consentl ne impedisce l'esecuzione. Contrassegni manualmente tali tag e rimuova i pixel in <noscript>:

<script type="text/plain" data-consentl="marketing" src="https://ads.example.com/tag.js"></script>
<iframe data-consentl="marketing" data-src="https://www.youtube-nocookie.com/embed/ID" title="Video"></iframe>
<img data-consentl="marketing" data-src="https://tracker.example.com/pixel.gif" alt="" width="1" height="1">

I tag caricati dal codice (GTM, il loader JavaScript di un pixel) vengono trattenuti senza alcuna richiesta quando il blocco automatico è attivo (dal piano Business in su).

Link per riaprire le preferenze ed embed

• I link il cui URL termina con #consentl o #consentl-preferences, e qualsiasi elemento con l'attributo data-consentl-open, aprono le preferenze. Ne aggiunga uno al piè di pagina («Impostazioni dei cookie»).
• Gli embed della dichiarazione dei cookie, delle richieste sui dati personali e del modulo di recesso UE funzionano come descritto nella guida per il web. Il modulo di recesso richiede il piano Pro o superiore e deve essere attivato nel pannello di controllo; altrimenti resta vuoto.

Content Security Policy

Se ha aggiunto restrizioni script-src (Settings → Security & Privacy → Content Security Policy), consenta https://api.consentl.com per script-src e connect-src.

Catalyst (vetrina headless Next.js)

Catalyst inserisce gli script di Script Manager lato client e in modo differito, quindi non sono mai i primi. Segua la guida Next.js per l'App Router, comprese le sue indicazioni su «per primo nel <head>»:

• core/app/[locale]/layout.tsx non ha un <head> esplicito. Ne aggiunga uno e vi inserisca Consentl come mostra la guida Next.js: uno <script> semplice come primo figlio.
• app/not-found.tsx genera un proprio <html>; aggiunga Consentl anche lì.
• React 19 sposta gli script async sopra uno script sincrono semplice, e next/script con afterInteractive fa sì che il browser scarichi il tag prima del consenso. Aggiunga ogni altro tag che deve attendere il consenso con il componente ConsentlScript della guida (type="text/plain" con la sua categoria Consentl), oppure lo gestisca in Google Tag Manager.

Disattivi il Cookie consent tracking di BigCommerce. Catalyst 1.3 e versioni successive includono un proprio banner di consenso (c15t): lo rimuova o lo disattivi per evitare due banner.

Verificare che funzioni

Apra la vetrina in una finestra privata e visualizzi il sorgente: con il metodo B il loader è il primo elemento nel <head>. Il banner compare. Il server di sviluppo della Stencil CLI non genera gli script di Script Manager, ma genera il codice del tema.

La regione del visitatore viene ricavata dal suo indirizzo IP: Consentl individua il Paese in memoria a ogni visualizzazione di pagina (senza memorizzare nulla) e applica la regola del pannello di controllo per quel Paese. Gli Stati USA non vengono distinti: i visitatori statunitensi ricevono la sua regola per l'intero territorio USA oppure, in sua assenza, la sua prima regola per uno Stato USA. Un Paese sconosciuto riceve la sua regola per le regioni sconosciute (opt-in per impostazione predefinita).

Limitazioni

• Script Manager non è per primo. Gli script del head del tema e gli script di Script Manager che BigCommerce stampa prima di Consentl vengono eseguiti per primi; il loro ordine all'interno di {{{head.scripts}}} non è documentato. Usi il metodo B per un blocco preventivo rigoroso. Consentl trattiene i tracker riconosciuti che si caricano dopo di esso (dal piano Business in su); con Free e Pro vengono trattenuti solo i tag che contrassegna manualmente.
• Nessun banner nel checkout (e in My Account con carte memorizzate); veda Checkout e My Account.
• Le statistiche native di BigCommerce non sono controllate da Consentl (ad esempio le integrazioni native GA4 o Meta in Settings → Data Solutions). Le configuri in modo che seguano Consent Mode, oppure le sostituisca con tag caricati tramite GTM.

Guide correlate

• Qualsiasi sito web (snippet)
• Google Tag Manager
• Next.js

Serve aiuto? Scriva a support@consentl.com: rispondiamo in inglese nei giorni lavorativi.