Get Started
Collegamento del tuo Store #
Il primo passo per installare Clerk.io è collegare il tuo store al tuo account Clerk.io.
Il video qui sotto ti mostra cosa fare, passo dopo passo. Usa 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 vedere la Live Demo.
1. Aggiungi Store #
Accedi a my.clerk.io. La prima volta che accedi, vedrai la pagina Aggiungi Nuovo Store.
Inserisci il Nome e il Dominio del tuo webshop
Scegli Shopware 6 come Piattaforma e seleziona la tua Valuta.
Fai clic su Aggiungi Store.

2. Installa e configura il plugin #
Per Shopware v6.4 e successivi:
- Nel tuo Shopware Admin, vai su Extensions > Store e cerca “Clerk”.

- Fai clic su Add extension per installare.
Per Shopware v6.3 e precedenti:
- Scarica il plugin:
Releases for v6.3 and earlier.

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

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

Configura il plugin:
- Fai clic su ... > Config. sul plugin Clerk.

- Seleziona il corretto Sales Channel.
- Sotto General, imposta Status su Enabled.
- Inserisci le tue Public Key e Private Key, poi fai clic su Save.

Posizione delle 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, consentendo a Clerk di accedere a prodotti, ordini, clienti e ad altre informazioni del negozio. Questo permette a Clerk di fornire Recommendations e risultati Search personalizzati in base ai dati reali del tuo store. Segui i passaggi nella guida Sync Data per configurare la sincronizzazione dati.
Configurazioni Headless #
Per le installazioni Shopware headless, crea un Sales Channel Storefront nascosto con le stesse lingue e valute del tuo negozio principale. Clerk utilizza il canale Storefront per risolvere le referenze di lingua e valuta durante la sincronizzazione.
- Crea un Sales Channel Storefront e mantienilo nascosto dalla navigazione.
- Aggiungi tutte le lingue e valute utilizzate dal tuo shop headless.
- Seleziona questo Sales Channel Storefront nella configurazione del plugin Clerk durante la configurazione della sincronizzazione.
Questo garantisce che tutte le referenze di lingua e valuta siano disponibili e la sincronizzazione dati si completi correttamente.
Per dettagli su creazione e configurazione dei Sales Channel, consulta la documentazione Shopware: Sales Channel settings.
Più lingue #
Shopware utilizza ID lingua per identificare ciascuna lingua unica nel webshop. Questi non sono visibili nel backend Shopware, quindi devono essere trovati tramite il frontend HTML.
Guarda questo video per vedere come identificare gli ID lingua.
Il modo migliore per gestire il multi-lingua in Clerk è creare Store unici per ogni lingua e sincronizzarli con il corretto ID lingua.
In questo modo, puoi separare prodotti, vendite, valute ecc. per monitorare ogni lingua.
Inizia creando il tuo main Store e segui la Setup Guide per collegare il tuo Store a Clerk.io, scegliendo le Recommendations e/o Search Results che vuoi mostrare nel tuo webshop.
Quando hai completato la configurazione iniziale, torna alla pagina iniziale di my.clerk.io (facendo clic sul logo di Clerk.io nell’angolo in alto a sinistra del menu laterale) e quindi fai clic su "+ Add new store" che è l’ultima opzione dell’elenco a discesa (generalmente sotto il tuo/i store esistente/i e il nome della tua azienda):



Inserisci i dettagli del tuo webshop e scegli il tuo main Store nel dropdown Copy Elements From Existing Store, quindi fai clic su Add Store. Questo copierà gli Elements e i Designs dal tuo main Store.
Ora puoi seguire di nuovo la Setup Guide per attivare Clerk.io facendo clic su Getting Started, per Sync Data per questa lingua. Ricorda di usare il corretto Language ID come descritto nel video all’inizio della guida. Lo Store URL, Access Key e Secret Access Key saranno gli stessi per tutti gli Store.

Quando la Data Sync è terminata, il tuo webshop è pronto e utilizza la stessa configurazione del tuo main Store.
Ricordati 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 utilizzare Clerk.io.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.