Get Started
Collegamento del tuo Store #
Il primo passo per installare Clerk.io è collegare il tuo store con il tuo account Clerk.io.
Il video qui sotto ti mostra cosa fare, passo dopo passo. Utilizza il resto della guida come riferimento :)
Dopo aver seguito questi semplici passaggi, potrai vedere il tuo Live Demo Store, che ti offre una panoramica personale di come Clerk.io funzionerà sul tuo webshop. Contatta il tuo referente Clerk.io per visualizzare la Live Demo.
1. Aggiungi Store #
Accedi a my.clerk.io. La prima volta che lo fai, vedrai la pagina Aggiungi Nuovo Store.
Scrivi il Nome e il Dominio del tuo webshop
Scegli Shopware 6 come Piattaforma e seleziona la tua Valuta.
Clicca su Aggiungi Store.

2. Installa e configura il plugin #
Per Shopware v6.4 e versioni successive, il plugin può essere installato dallo Shopware Extension Store oppure caricato manualmente da GitHub.
Opzione A: Installa dallo Extension Store
- Nel tuo Admin Shopware, vai a Extensions > Store e cerca “Clerk”.

- Clicca su Add extension per installare.
Opzione B: Installa manualmente da GitHub
Se il plugin non è disponibile nello Shopware Extension Store, può essere scaricato da GitHub e caricato manualmente.
- Vai alle
Clerk Shopware 6.4 plugin releases su GitHub e scarica l’ultimo file
.zip. - Nel tuo Admin Shopware, vai su Extensions > My extensions.
- Clicca su Upload extension e seleziona il file
.zipscaricato. - Una volta caricato, clicca su Install e poi attiva il plugin.
Per Shopware v6.3 e versioni precedenti:
- Scarica il plugin:
Releases per v6.3 e precedenti.

- Nel tuo Admin Shopware, vai su Settings > System > Plugins.

- Clicca su Upload plugin, scegli il file scaricato, poi ... > Install e attiva.

Configura il plugin:
- Clicca su ... > Config. sul plugin Clerk.

- Seleziona il corretto Sales Channel.
- Sotto General, imposta Status su Enabled.
- Inserisci il tuo Public Key e Private Key, poi clicca su Save.

Dove trovare le chiavi: la tua Public Key e Private Key si trovano in my.clerk.io > Developers > API Keys.
3. Sincronizza i tuoi dati #
La sincronizzazione dei dati collega il tuo store Shopware 6 a Clerk, permettendo a Clerk di accedere ai tuoi prodotti, ordini, clienti e altre informazioni dello store. Questo consente a Clerk di fornire raccomandazioni personalizzate e risultati di ricerca basati sui dati reali del tuo store. Segui i passaggi nella guida Sync Data per impostare la sincronizzazione dei dati.
Configurazioni Headless #
Per le installazioni headless di Shopware, crea un canale di vendita Storefront nascosto con le stesse lingue e valute del tuo shop principale. Clerk utilizza il canale Storefront per determinare i riferimenti di lingua e valuta durante la sincronizzazione.
- Crea un canale di vendita Storefront e tienilo nascosto dalla navigazione.
- Aggiungi tutte le lingue e le valute utilizzate dal tuo shop headless.
- Seleziona questo canale di vendita Storefront nella configurazione del plugin Clerk durante l’impostazione della sincronizzazione.
Questo garantisce che tutti i riferimenti di lingua e valuta siano disponibili affinché la sincronizzazione dei dati venga completata correttamente.
Per dettagli su come creare e configurare i canali di vendita, consulta la documentazione di Shopware: Sales Channel settings.
Più lingue #
Shopware utilizza ID lingua per identificare ogni lingua unica nel webshop. Questi non sono visibili nel backend Shopware, quindi devono essere trovati tramite l’HTML del frontend.
Guarda questo video per vedere come identificare gli ID lingua.
Il modo migliore per gestire il multi-lingua in Clerk è creare Store unici per ciascuna lingua e sincronizzarli con il corretto ID lingua.
In questo modo puoi separare prodotti, vendite, valute ecc. per tracciare ogni lingua.
Inizia creando il tuo Store principale e segui la Setup Guide per collegare il tuo Store a Clerk.io, e scegli le Recommendations e/o i Search Results che desideri mostrare sul tuo webshop.
Quando hai terminato la configurazione iniziale, torna alla pagina iniziale di my.clerk.io (cliccando sul logo Clerk.io nell’angolo in alto a sinistra del menu laterale) e poi clicca su "+ Aggiungi nuovo store" l’ultima opzione della lista a discesa (generalmente sotto il tuo/i tuo/i store esistente/i e il nome della tua azienda):



Compila i dettagli del tuo webshop e scegli il tuo Store principale dal menu a tendina Copia elementi da uno store esistente, poi clicca su Aggiungi Store. Questo copierà gli Elementi e i Design dal tuo Store principale.
Ora puoi seguire di nuovo la Setup Guide per attivare Clerk.io cliccando su Getting Started, per Sincronizzare i dati per questa lingua. Ricorda di usare il corretto ID lingua come descritto nel video in cima alla guida. L’URL dello Store, Access Key e Secret Access Key saranno uguali per tutti gli Store.

Quando la Sincronizzazione dati è terminata, il tuo webshop è pronto e utilizza la stessa configurazione del tuo Store principale.
Ricorda di tradurre le Headlines, in Element-> Edit -> Select Design nella lingua corretta.
Puoi seguire questo processo per tutte le lingue del webshop con cui vuoi usare Clerk.io.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.