Get Started
Configura Clerk sul tuo store JTL in pochi semplici passaggi. Questa guida ti accompagnerà nella connessione del tuo store, nella configurazione del plugin e nella sincronizzazione dei tuoi dati.
Collegare il tuo store #
Il primo passo dell’installazione di Clerk è collegare il tuo store al tuo account Clerk.
Seguendo questi semplici passaggi potrai visualizzare il tuo Demo Store, che ti darà una panoramica personale su come Clerk funzionerà sul tuo webshop, prima di configurare il resto del sistema.
Aggiungi store #
Dopo aver effettuato l’accesso a my.clerk.io, la prima cosa da fare è aggiungere il tuo store:

Scrivi il Nome e il Dominio del tuo webshop.
Scegli JTL come Piattaforma e seleziona la tua Valuta.
Clicca su Add Store.
Una volta creato lo store, verrà inviata un’email sulle tue chiavi pubbliche e private al proprietario dell’Email dell’account.
Configura la connessione #
Dal menu principale della Setup Guide, clicca su Install Extension:

La pagina successiva mostra cosa devi fare per configurare la connessione JTL.
Vai al tuo plugin Clerk nel backend di JTL e inserisci le chiavi pubblica e privata dallo store clerk nei rispettivi campi.
Sincronizza store #
Dopo aver concesso l’accesso, devi semplicemente sincronizzare il tuo store.
Torna alla Setup Guide e clicca su Sync Your Data:

Inserisci i dettagli del tuo store e clicca su Start Sync.
L’url del feed JTL deve essere creato seguendo questa guida: Creazione di feed dati in JTL.
Esempio di installazione completa #
IMPORTANTE: Dovresti aver installato il plugin (S360 Clerk) nel backend JTL sotto Plugins
Questa documentazione ti guiderà attraverso i seguenti passaggi:
Aggiunta di uno store #
Ogni Store in Clerk è un ambiente isolato con i suoi dati, chiavi API e Dashboard.
La prima cosa che dovrai fare quando configuri il tuo account Clerk è creare il tuo primo Store:
Dopo questo, la Setup Guide ti accompagnerà nel resto della configurazione.
Nota che ogni volta che viene creato uno store, viene inviata un’email con chiavi pubbliche e private al proprietario dell’account aziendale. Questo serve per creare un accesso sicuro tra Clerk e JTL.
Installazione degli script di monitoraggio #
Con il plugin S360 Clerk puoi abilitare sia gli script di monitoraggio visitatori che ordini, che verranno inseriti in alcune parti del webshop:
Lo script di monitoraggio dei visitatori, che inizializza Clerk. Questo deve essere inserito nell’header del webshop.
Lo script di monitoraggio ordini che permette il tracciamento degli ordini in tempo reale. Questo viene solitamente installato sulla pagina di conferma dell’ordine.
Puoi abilitarli dal plugin JTL nella sezione ALLGEMEIN:
Quando entrambi gli script sono stati inseriti, Clerk sarà inizializzato.
Sincronizzazione del tuo store #
Per visualizzare i risultati, Clerk deve sincronizzarsi con prodotti, categorie, vendite, pagine e clienti da JTL in un feed dati generato.
Questo avviene configurando un feed dati che consenta di accedere ai dati regolarmente.
Questo è spiegato in dettaglio in questa guida: Creazione di feed dati in JTL.
Quando il feed dati è stato generato e aggiunto nelle impostazioni di Data sync sotto System Status nel backend di my.clerk.io.
Aggiunta di search e recommendations #
Gli elementi frontend in Clerk sono composti da due parti:
Un Design che controlla la presentazione visiva dei prodotti. Questo può essere modificato per adattarsi a qualsiasi stile desideri, oppure puoi usare uno dei nostri template standard Template Design da utilizzare in Clerk.
Più spesso userai 3 Design: uno per l’Instant Search, la pagina di Search e Recommendations.

- Un Content con un embedcode allegato che mostra i prodotti. Ogni contenuto ha un nome specifico nel suo embedcode che vuoi aggiungere nei rispettivi campi denominati Clerk TemplateName. Questo serve per comunicare tra il tuo webshop e il relativo content clerk.
La Setup Guide ti guiderà su dove piazzare ciascun elemento nella maggior parte delle configurazioni JTL.
Alla fine della configurazione le impostazioni nel plugin dovrebbero apparire così. Le immagini seguenti sono soltanto a scopo dimostrativo.

| Opzione | Significato |
|---|---|
| API Key | La tua chiave API ricevuta da Clerk |
| Private Key | La tua legacy private API key fornita da Clerk. Necessaria per limitare l’accesso al feed dati. |
| Language | Lingua del feed dati |
| customer group | Prezzi per il gruppo clienti |
| Currency | Valuta nel feed dati |
| Faceted design | Design delle faccette |

| Componente | Opzione | Significato |
|---|---|---|
| Generally | Usa tracciamento senza cookie | Tracciamento senza uso di cookies |
| Usare tracciamento carrello? | Informa Clerk sulle variazioni del carrello (tracciamento carrello generale) | |
| Anonimizzare email | Gli indirizzi Email vengono trasmessi a Clerk in modo anonimo (come hash) | |
| Live Suche (Header) | Attiva live search? | Se disattivato, la Clerk Live search non verrà mostrata nel frontend. |
| Selektor Livesearch | Selettore live search indipendente da Clerk | |
| Clerk TemplateName Livesuche | Template per la live search (Clerk Backend → Search → Content → Live search → Inserisci nel sito → Nel codice il valore di “data-template="@WERT’”) | |
| Numero di suggerimenti di ricerca nella live search | Numero di suggerimenti ricerca da visualizzare | |
| Numero di suggerimenti categoria | Numero di suggerimenti categoria da visualizzare | |
| Numero di suggerimenti pagina | Numero di suggerimenti pagina da visualizzare | |
| Posizione | Posizione del risultato live search rispetto al selettore | |
| Search (pagina risultati) | Attiva pagina risultati? | Se disattivato, la pagina risultati Clerk non sarà mostrata nel frontend. |
| Clerk TemplateName Search | Template per la live search (Clerk Backend → Search → Content → Search → Inserisci nel sito → Nel codice il valore di “data-template="@WERT’”) | |
| Posizione faccette | Posizione delle faccette | |
| Mostra faccette nell’URL | Mostra faccette nell’URL | |
| Clerk Facets Attribute | Lista separata da virgole delle faccette disponibili (funzionalità JTL) | |
| Clerk Facets Attributes Multiple Values | Lista separata da virgole delle faccette disponibili con valori multipli (caratteristiche JTL per filtraggio OR) |

| Componente | Opzione | Significato |
|---|---|---|
| Data Feed | Elaborazione Cron | Modalità di attivazione del cron per generare il feed dati (spiegato meglio nella sezione Possibilità di creazione feed dati) |
| Batch size | Dimensione batch dei prodotti del feed (spiegato nella sezione batch size) | |
| Pagina prodotto | Attivare slider pagina prodotto? | Se disattivato, lo slider in pagina prodotto non verrà mostrato nel frontend. |
| Selettore slider articolo | Selettore dello slider articolo indipendente da Clerk | |
| Clerk TemplateName Article | Nomi dei template slider da visualizzare. Più nomi template possono essere specificati come lista separata da virgole. | |
| Metodo inserimento slider | Come aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith) | |
| Filtro duplicati | Impedisce che gli slider successivi contengano prodotti già presenti (default: Yes) | |
| Pagina carrello | Attivare slider pagina carrello? | Se disattivato, lo slider in pagina carrello non verrà mostrato nel frontend. |
| Selettore slider carrello | Selettore dello slider carrello indipendente da Clerk | |
| Clerk TemplateName Shopping Cart | Nomi dei template slider da visualizzare. Più nomi template possono essere specificati come lista separata da virgole. | |
| Metodo inserimento slider | Come aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith) | |
| Filtro duplicati | Impedisce che gli slider successivi contengano prodotti già presenti (default: Yes) | |
| Powerstep | Attivare Slider Powerstep? | Se disattivato, lo slider nel power step non sarà visualizzato nel frontend. |
| Powerstep Selector | Selettore per lo slider Powerstep indipendente da Clerk | |
| Clerk TemplateName Powerstep | Nomi dei template slider da visualizzare. Più nomi template possono essere specificati come lista separata da virgole. | |
| Metodo inserimento Powerstep | Come aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith) | |
| Filtro duplicati | Impedisce che gli slider successivi contengano prodotti già presenti (default: Yes) |

| Componente | Opzione | Significato |
|---|---|---|
| Pagina categoria | Attivare slider pagina categoria? | Se disattivato, lo slider in pagina categoria non verrà mostrato nel frontend. |
| Kategorie Selektor Slider | Selettore slider categoria indipendente da Clerk | |
| Clerk TemplateName Shopping Cart | Nomi dei template slider da visualizzare. Più nomi template possono essere specificati come lista separata da virgole. | |
| Metodo inserimento slider | Come aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith) | |
| Filtro duplicati | Impedisce che gli slider successivi contengano prodotti già presenti (default: Yes) | |
| Exit Intent | Attiva slider Exit Intent? | Se disattivato, l’exit intent non sarà visualizzato nel frontend. |
| Clerk TemplateName Exit Intent | Template per l’exit intent |
Più domini #
Il modo più semplice per implementare Clerk su più domini nelle configurazioni standard è creare un Store separato per ogni dominio su my.clerk.io e sincronizzarli con ciascun dominio lingua JTL.
In questo modo è possibile separare prodotti, vendite, valute ecc. per tenere traccia di ogni dominio.
Inizia creando il tuo Store principale e segui la Setup Guide per collegare il tuo Store a Clerk, e scegli le Recommendations e/o Search Results che vuoi mostrare sul tuo webshop.
Terminata la configurazione iniziale, torna alla pagina iniziale di my.clerk.io (cliccando sul logo Clerk nell’angolo superiore sinistro della side-menu) e poi clicca su "+ Add new store" ultima opzione del menu a discesa (in genere sotto gli store esistenti e il nome dell’azienda):

- Nella pagina Add New Store, clicca su Advanced per vedere tutte le impostazioni.

- Compila i dettagli del tuo dominio e scegli il tuo store principale dal menu a tendina Copy Content From Existing Store, poi clicca su Add Store. Questo copierà i Content e i Designs dallo store principale.

- Ora puoi seguire nuovamente la Setup Guide, per attivare Clerk cliccando su Getting Started, per Sync Data per il nuovo dominio.

Questo ti permetterà di sincronizzare il tuo dominio con il tuo Store su my.clerk.io attraverso la Setup Guide.
Quando la Data Sync è terminata, il tuo dominio è pronto e utilizza la stessa configurazione dello Store principale.
Ripeti questo processo per ogni dominio lingua JTL. Ricordati di tradurre le Headlines, in Content-> Edit -> Select Design nella lingua corretta.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.