CookiezyCookiezy
ProdottoPiattaformeDocumentazionePrezziBlogContatto

Documentazione aggiornata l'ultima volta il 27 maggio 2026

Navigazione documentazione

Panoramica

DocumentazioneDocumentazione tecnica per installare, configurare e verificare Cookiezy su ogni adapter supportato.ConfigurazioneLocale, Cookie Policy, categorie e note di configurazione sensibili al licensing.Headless adapterIstruzioni tecniche per installare, configurare e verificare l’adapter Headless.InizioCome scegliere l’adapter corretto, capire il flusso di fatturazione e preparare la pubblicazione.InstallazioneSequenza condivisa per installare Cookiezy: package, dominio, adapter e verifica runtime.Next.js adapterIstruzioni tecniche per installare, configurare e verificare l’adapter Next.js.React adapterIstruzioni tecniche per installare, configurare e verificare l’adapter React.Shopify adapterGuida tecnica Shopify: scarica Platform Core, prepara la theme app extension e verifica il comportamento del consenso prima della pubblicazione.Strapi adapterIstruzioni tecniche per installare, configurare e verificare l’adapter Strapi.Webflow adapterIstruzioni tecniche per installare, configurare e verificare l’adapter Webflow.Wix adapterGuida tecnica per il rollout Wix: installa l'app Wix private o unlisted, collega il corretto account Cookiezy, pubblica il runtime ospitato dall'app e usa il custom code solo come fallback.WordPress adapterIstruzioni tecniche per installare, configurare e verificare l’adapter WordPress.

Riferimento

APIMetodi browser, eventi di consenso, verifica del licensing e helper per la pagina della Cookie Policy.
Versione adapterShopify adapter

Stato release dell'adapter Shopify

Versione corrente del percorso storefront Shopify e note di rollout per l'estensione distribuita dentro Platform Core.

Versione corrente

0.1.23

Canale di consegna

Incluso in Platform Core

Note di compatibilità

Il rollout storefront Shopify passa ancora attraverso Platform Core, mentre la lane app standalone resta separata.

Principali cambi di rollout

1. Usa la theme app extension da Platform Core.

2. Considera la lane embedded app come superficie admin separata e non come installer principale dello storefront.

3. Verifica l’embed block in uno store di sviluppo prima del rollout live.

Panoramica

Shopify adapter dopo l'acquisto

Il runtime Shopify vive nella theme app extension. Il lane embedded app resta una superficie separata per onboarding, billing e rollout più strutturati.

  • • Scarica `cookiezy-platform-core.zip` dall'area cliente.
  • • Per Shopify usa `packages/adapters/shopify/theme-app-extension/`.
  • • Per il primo smoke test usa un development store e un'app extension-only.
  • • Prima di attivare l'embed registra l'hostname esatto del storefront nella fatturazione.
Passo 1

Mantieni intatti i file Shopify

Il blocco Liquid e il loader si appoggiano ai nomi dei file, quindi non rinominarli.

Code snippet

packages/adapters/shopify/theme-app-extension/assets/cookie-consent-shopify-loader.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent-ui.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent-scanner.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent.css
packages/adapters/shopify/theme-app-extension/assets/shopify-customer-privacy-bridge.js
packages/adapters/shopify/theme-app-extension/blocks/cookiezy-embed.liquid
Passo 2

Controlla i campi visibili nel Theme Editor

Merchant e team di delivery devono vedere tutti i campi operativi senza modificare il Liquid a mano.

  • • Cookie policy URL
  • • Cookiezy Site Key
  • • License verification URL
  • • Billing / portal URL
  • • Banner layout
  • • Theme CSS class
Passo 3

Registra l'hostname esatto del storefront

Il licensing di Cookiezy controlla l'hostname esatto del storefront a runtime.

  • • `my-shop.myshopify.com` e una custom domain non sono lo stesso hostname.
  • • Se testi sulla custom domain, registra la custom domain.
  • • Se testi sul dominio `myshopify.com`, registra quell'hostname preciso.
  • • Conferma che `/api/licensing/verify` restituisca `allowed: true`.
Test minimi

Cosa verificare prima del go-live

Checklist minima in preview tema o in una sessione pulita del browser.

Il banner appare alla prima visita?

Apri homepage, collection, product e cart in una sessione pulita e verifica che il banner compaia correttamente.

Il tracciamento opzionale resta bloccato?

Rifiuta le categorie opzionali e conferma che analytics e marketing non partano prima del consenso.

I campi di verifica e billing sono visibili?

Se `verify_url` o `billing_url` non sono visibili nel Theme Editor, controlla schema e file locale della extension.

Cookiezy

Piattaforma leggera per la gestione del consenso ai cookie su siti web moderni.

Prodotto

FunzionalitàPiattaformePrezziDocumentazioneBlogContatto

Legale

Informativa sui cookieInformativa sulla privacyTermini di servizio

Lingua

Italiano
EnglishenSlovenščinaslHrvatskihrItalianoit

Gestione dei cookie

© 2026 Cookiezy. Tutti i diritti riservati.