Consentl pe BigCommerce

Instalați Consentl pe BigCommerce cu Script Manager sau în tema Stencil pentru blocare prealabilă strictă, cu finalizarea comenzii conformă PCI și pe Catalyst.

Scriptul de încărcare primul în <head>: Depinde de metodă

Există două moduri de instalare, în funcție de cât de strictă trebuie să fie blocarea prealabilă.

Metodă	Primul în `<head>`?	Efort
A. Script Manager	Nu: este afișat în `{{{head.scripts}}}`, după CSS-ul, fonturile și scripturile head ale temei	Fără cod
B. Fișierul temei (`base.html`)	Da	Editarea temei; se reaplică după actualizările temei

Înainte de oricare metodă, decideți ce faceți cu propriul consimțământ pentru cookie-uri al BigCommerce: Settings → Security & Privacy → Your customers' privacy → Cookie consent tracking.

Recomandat: dezactivați-l. Consentl afișează bannerul și reține singur scripturile neesențiale; dacă le păstrați pe amândouă, ar apărea două bannere.
Dacă îl păstrați activat, BigCommerce afișează scripturile Script Manager din categoriile Analytics, Functional sau Targeting; Advertising doar după propriul consimțământ, iar cele două bannere ar trebui menținute sincronizate, ceea ce acest ghid nu acoperă. Consentl însuși trebuie atunci să aibă categoria Essential, altfel nu s-ar încărca niciodată.

Cheia site-ului Consentl se află în pagina Configurare a site-ului din panoul de control. Adăugați numele de gazdă al magazinului în câmpul Domenii; www. și domeniul simplu contează ca același site, așa că nu este nevoie să adăugați separat www..

Ce acoperă planul dumneavoastră Consentl

Free: doar bannerul, jurnalul consimțămintelor și blocarea manuală.
Pro: adaugă Google Consent Mode v2.
Business: adaugă blocarea automată a trackerelor cunoscute și regulile de blocare pe care le adăugați în panoul de control.

În planurile Free și Pro, sunt reținute doar etichetele pe care le marcați manual.

A. Script Manager (magazine Stencil)

Panoul de control BigCommerce → Storefront → Script Manager → Create a Script.
Completați:
- Name of script: Consentl
- Location on page: Header
- Select pages where script will be added: Store pages (paginile magazinului). Nu All pages; consultați Finalizarea comenzii și My Account.
- Script category: Essential
- Script type: URL
- Load method: Default. Niciodată Async sau Defer: scriptul de încărcare trebuie să ruleze sincron.
- Script URL: https://api.consentl.com/v1/loader.js?k=SITE_KEY&l=en (adăugați &gcm=ext dacă magazinul folosește și șablonul GTM Consentl, astfel încât doar șablonul să trimită comenzi Consent Mode)
- Integrity Hash: lăsați gol. Scriptul de încărcare se schimbă atunci când modificați setările în panoul de control Consentl, așa că un hash fix ar face ca browserul să îl respingă.
Save. Din cauza cache-ului, modificările pot avea nevoie de aproximativ 20 de secunde pentru a apărea.
Testați într-o fereastră privată (consultați Verificați că funcționează).

Script Manager limitează conținutul scripturilor la 64 KB. Scriptul de încărcare este un script de tip URL, de o singură linie.

Finalizarea comenzii și My Account

BigCommerce impune un hash SRI pentru fiecare script de pe pagina de finalizare a comenzii: „All scripts on the checkout page need at least one SRI hash to meet PCI 4.0 - 6.4.3 requirements”. Documentația de ajutor BigCommerce extinde această cerință la pagina My Account atunci când cardurile stocate sunt activate.
Scriptul de încărcare Consentl nu poate avea un hash stabil, așa că nu trebuie plasat acolo. De aceea, Store pages este valoarea implicită de mai sus și de aceea metoda B trebuie să țină scriptul de încărcare în afara finalizării comenzii.
Prin urmare, finalizarea comenzii (și My Account, când cardurile stocate sunt activate) nu afișează niciun banner și acolo nu rulează niciun runtime Consentl.
Alegerea făcută de vizitator în magazin este păstrată în cookie-ul propriu consentl și este aplicată din nou pe următoarea pagină a magazinului. Consentl nu reține nimic pe pagina de finalizare a comenzii: țineți scripturile neesențiale în afara finalizării comenzii (selectați și pentru ele Store pages) și verificați ce încarcă acolo integrările din Settings → Data Solutions.
Scripturile sunt afișate pe paginile de finalizare a comenzii și de confirmare a comenzii doar cu Optimized One-Page Checkout.

B. Fișierul temei (cu adevărat primul)

Storefront → Themes: la tema curentă alegeți Advanced → Make a copy. BigCommerce permite editarea fișierelor temei doar pe o copie. Apoi deschideți Advanced → Edit Theme Files al copiei sau folosiți Stencil CLI.
Deschideți templates/layout/base.html și lipiți scriptul de încărcare imediat după <head>, înainte de {{{head.scripts}}} și de CSS-ul temei:
```
<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}} este helperul de limbă documentat. Cornerstone are și {{locale_name}}, care funcționează acolo, dar nu apare în referința obiectelor. Folosiți o limbă fixă, cum ar fi en, dacă niciunul nu returnează formatul de care aveți nevoie.
- Dacă Enable Nonce-Based Script Security este activat (Settings → Security & Privacy), adăugați nonce="{{nonce}}" la etichetă. Scripturile pe care Consentl le eliberează după consimțământ au atunci nevoie și ele de nonce (adăugați-l la fiecare etichetă pe care o marcați manual) sau de o politică cu 'strict-dynamic'; altfel browserul le blochează.
Salvați și aplicați copia. Nu adăugați în plus Consentl prin Script Manager.
Actualizările temei înlocuiesc base.html: adăugați din nou linia după fiecare actualizare.

Nu adăugați scriptul de încărcare în șabloanele de finalizare a comenzii (consultați Finalizarea comenzii și My Account). După aplicarea temei, deschideți pagina de finalizare a comenzii și verificați cu View Source că scriptul de încărcare nu se află acolo.

Etichete scrise direct

Un <script src>, un pixel <img> sau un <iframe> scris în fișierele temei sau într-un script Script Manager este preluat de browser înainte ca vreun script să îl poată opri, chiar dacă Consentl îi împiedică rularea. Marcați manual astfel de etichete și eliminați pixelii <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">

Etichetele încărcate prin cod (GTM, scriptul de încărcare JavaScript al unui pixel) sunt reținute fără nicio solicitare atunci când blocarea automată este activă (planul Business și cele superioare).

Linkul de redeschidere și elementele încorporate

Linkurile al căror URL se termină în #consentl sau #consentl-preferences și orice element cu atributul data-consentl-open deschid preferințele. Adăugați unul în subsol („Setări cookie-uri”).
Elementele încorporate pentru declarația privind cookie-urile, cererile privind datele personale și retragerea UE funcționează așa cum este descris în ghidul pentru orice site. Formularul de retragere necesită planul Pro sau unul superior și trebuie activat din panoul de control; altfel rămâne gol.

Content Security Policy

Dacă ați adăugat restricții script-src (Settings → Security & Privacy → Content Security Policy), permiteți https://api.consentl.com pentru script-src și connect-src.

Catalyst (magazin headless Next.js)

Catalyst injectează scripturile Script Manager pe client și amânat, așa că acestea nu sunt niciodată primele. Urmați ghidul pentru Next.js pentru App Router, inclusiv indicațiile privind „primul în <head>”:

core/app/[locale]/layout.tsx nu are un <head> explicit. Adăugați unul și plasați Consentl în el așa cum arată ghidul pentru Next.js: un <script> simplu, ca prim element copil.
app/not-found.tsx afișează propriul <html>; adăugați Consentl și acolo.
React 19 mută scripturile async deasupra unui script sincron simplu, iar next/script cu afterInteractive face ca browserul să descarce eticheta înainte de consimțământ. Adăugați fiecare altă etichetă care trebuie să aștepte consimțământul cu componenta ConsentlScript din ghid (type="text/plain" cu categoria sa Consentl) sau administrați-o în Google Tag Manager.

Dezactivați cookie consent tracking din BigCommerce. Catalyst 1.3 și versiunile ulterioare includ propriul banner de consimțământ (c15t): eliminați-l sau dezactivați-l pentru a evita două bannere.

Verificați că funcționează

Deschideți magazinul într-o fereastră privată și vizualizați sursa: cu metoda B, scriptul de încărcare este primul element din <head>. Bannerul apare. Serverul de dezvoltare Stencil CLI nu afișează scripturile Script Manager, dar afișează codul temei.

Regiunea vizitatorului se stabilește din adresa IP: Consentl determină țara în memorie la fiecare afișare de pagină (nu se stochează nimic) și aplică regula dumneavoastră din panoul de control pentru aceasta. Statele SUA nu sunt diferențiate: vizitatorii din SUA primesc regula pentru întreaga SUA sau, dacă nu există, prima regulă pentru un stat SUA. O țară necunoscută primește regula pentru regiuni necunoscute (opt-in în mod implicit).

Limitări

Script Manager nu este primul. Scripturile head proprii ale temei și orice scripturi Script Manager pe care BigCommerce le afișează înaintea Consentl rulează primele; ordinea lor în {{{head.scripts}}} nu este documentată. Folosiți metoda B pentru o blocare prealabilă strictă. Consentl reține trackerele recunoscute care se încarcă după el (planul Business și cele superioare); în planurile Free și Pro, sunt reținute doar etichetele pe care le marcați manual.
Niciun banner la finalizarea comenzii (și în My Account cu carduri stocate); consultați Finalizarea comenzii și My Account.
Analiza nativă BigCommerce nu este controlată de Consentl (de exemplu integrările native GA4 sau Meta din Settings → Data Solutions). Configurați-le să urmeze Consent Mode sau înlocuiți-le cu etichete încărcate prin GTM.

V-ați blocat? Scrieți-ne la support@consentl.com — răspundem în limba engleză, în zilele lucrătoare.