Get Started
Collegare il tuo Negozio #
Il primo passo per installare Clerk.io è collegare il tuo negozio al tuo account Clerk.io.
Dopo aver seguito questi semplici passaggi, sarai in grado di vedere il tuo Negozio Demo, che ti offre una panoramica personale di come Clerk.io funzionerà sul tuo webshop, prima di configurare il resto del sistema.
1. Aggiungi Negozio #
Dopo aver effettuato l’accesso a my.clerk.io, la prima cosa che devi fare è aggiungere il tuo negozio:

Scrivi il Nome e il Dominio del tuo webshop
Scegli JTL come Piattaforma e scegli la tua Valuta.
Clicca su Aggiungi Negozio.
Una volta creato il negozio, verrà inviata un’email riguardante le tue chiavi pubbliche e private al proprietario dell’email dell’account.
2. Configura la Connessione JTL #
Dal menu principale della Guida all’Installazione, clicca su Installa Estensione:

La pagina successiva mostra cosa devi fare per configurare la connessione JTL.
Vai al tuo plugin Clerk nel backend JTL e aggiungi le chiavi pubbliche e private dal negozio Clerk nei rispettivi campi.
3. Sincronizza il tuo negozio #
Dopo aver consentito l’accesso, devi semplicemente sincronizzare il tuo negozio.
Torna alla Guida all’Installazione e clicca su Sincronizza i tuoi Dati:

Scrivi i dettagli del tuo negozio e clicca su Inizia Sincronizzazione
L’URL del feed JTL dovrebbe essere creato in base a questa guida Creazione di Feed Dati in JTL
Esempio Completo di Installazione #
IMPORTANTE: Dovresti aver installato il plugin (S360 Clerk) nel tuo backend JTL sotto Plugins
Questa documentazione ti guiderà attraverso i seguenti passaggi:
Aggiungere un Negozio in my.clerk.io #
Ogni Negozio in Clerk.io è un ambiente isolato con i propri dati, chiavi API e Dashboard. La prima cosa che dovrai fare quando configuri il tuo account Clerk.io è creare il tuo primo Negozio:
Dopo questo, la Guida all’Installazione ti guiderà attraverso il resto della configurazione.
Nota che ogni volta che viene creato un negozio, verrà inviata un’email con chiavi pubbliche e private al proprietario dell’account aziendale. Questo è utilizzato per creare un accesso sicuro tra Clerk e JTL.
Installazione dei due script di tracciamento #
Con il plugin S360 Clerk, puoi abilitare sia gli script di tracciamento dei visitatori che degli ordini, che verranno iniettati in parti del webshop:
Lo script di tracciamento dei visitatori, che inizializza Clerk.io. Questo deve essere iniettato all’interno dell’intestazione del webshop.
Lo script di tracciamento degli ordini che consente il tracciamento degli ordini in tempo reale. Questo è solitamente installato sulla pagina di conferma dell’ordine.
Puoi abilitarli all’interno del plugin JTL nella sezione ALLGEMEIN:
Quando entrambi gli script sono inseriti, Clerk.io sarà stato inizializzato.
Sincronizzazione del tuo Negozio JTL con Clerk.io #
Per mostrare i risultati, Clerk.io deve sincronizzarsi con i prodotti, le categorie, le vendite, le pagine e i clienti di JTL in un feed dati generato.
Questo viene fatto impostando un feed dati che consente di accedere ai dati regolarmente. Questo è ulteriormente spiegato in questa guida Creazione di Feed Dati in JTL.
Quando il feed dati è stato generato e aggiunto alle impostazioni di sincronizzazione dei dati sotto Stato di Sistema nel tuo backend my.clerk.io.
Aggiungere Ricerca e Raccomandazioni #
Gli elementi frontend in Clerk.io consistono di due parti:
Un Design che controlla la presentazione visiva dei prodotti. Questo può essere modificato per adattarsi a qualsiasi stile tu voglia o puoi utilizzare alcuni dei nostri modelli di design standard Design del Modello da utilizzare in Clerk.
Più spesso utilizzerai 3 Design: Uno per la Ricerca Istantanea, la pagina di Ricerca e le Raccomandazioni.

- Un Contenuto con un codice di incorporamento allegato che visualizza i prodotti. Ogni contenuto ha un nome specifico nel suo codice di incorporamento che desideri aggiungere ai rispettivi campi nome Clerk TemplateName. Questo è utilizzato per comunicare tra il tuo webshop e il rispettivo contenuto clerk.
La Guida all’Installazione ti guiderà su dove ogni elemento deve essere posizionato nella maggior parte delle configurazioni JTL.
Alla fine della tua configurazione, le impostazioni nel plugin dovrebbero apparire in questo modo. Le seguenti immagini sono solo a scopo dimostrativo.

Opzione | Significato |
---|---|
Chiave API | La tua chiave API ricevuta da Clerk |
Chiave Privata | La tua chiave API privata legacy fornita da Clerk. Necessaria per limitare l’accesso al feed dati. |
Lingua | Lingua del feed dati |
gruppo clienti | Prezzi per il gruppo clienti |
Valuta | Valuta nel feed dati |
Design a faccette | Design delle faccette |

Componente | Opzione | Significato |
---|---|---|
Generale | Utilizza tracciamento senza cookie | Tracciamento senza l’uso di cookie |
Utilizzare il tracciamento del carrello? | Informa Clerk sui cambiamenti al carrello (tracciamento generale del carrello) | |
Anonimizzare le email | Gli indirizzi email vengono trasmessi a Clerk in modo anonimo (come hash). | |
Ricerca Live (Intestazione) | Attivare la ricerca live? | Se disattivato, la ricerca live di Clerk non verrà visualizzata nel frontend. |
Selettore Ricerca Live | Selettore di ricerca live indipendente da Clerk | |
Clerk TemplateName Ricerca Live | Modello per la ricerca live (Clerk Backend → Ricerca → Contenuto → Ricerca live → Inserisci nel sito web → Nel codice il valore da “data-template=”@WERT’”) | |
Numero di suggerimenti di ricerca nella ricerca live | Numero di suggerimenti di ricerca da visualizzare | |
Numero di suggerimenti di categoria | Numero di suggerimenti di categoria da visualizzare | |
Numero di suggerimenti di pagina | Numero di suggerimenti di pagina da visualizzare | |
Posizione | Posizione del risultato della ricerca live rispetto al selettore | |
Ricerca (pagina dei risultati) | Attivare la pagina dei risultati? | Se disattivato, la pagina dei risultati di Clerk non verrà visualizzata nel frontend. |
Clerk TemplateName Ricerca | Modello per la ricerca live (Clerk Backend → Ricerca → Contenuto → Ricerca → Inserisci nel sito web → Nel codice il valore da “data-template=”@WERT’”) | |
Posizione faccette | Posizione delle faccette | |
Mostra faccette nell’URL | Mostra faccette nell’URL | |
Clerk Facets Attribute | Elenco separato da virgole delle faccette disponibili (funzionalità JTL) | |
Clerk Facets Attributes Multiple Values | Elenco separato da virgole delle faccette disponibili con valori multipli (caratteristiche JTL per filtraggio OR) |

Componente | Opzione | Significato |
---|---|---|
Feed Dati | Elaborazione Cron | Come deve essere attivato il cron per generare il feed dati (spiegato in dettaglio nella sezione Possibilità di creazione di feed dati) |
Dimensione batch | Dimensione batch dei prodotti del feed (spiegato in dettaglio nella sezione dimensione batch) | |
Pagina prodotto | Attivare lo slider della pagina prodotto? | Se disattivato, lo slider sulla pagina prodotto non verrà visualizzato nel frontend. |
Selettore articolo slider | Selettore per lo slider degli articoli indipendente da Clerk | |
Clerk TemplateName Articolo | Nomi dei modelli di slider da visualizzare. Possono essere specificati più nomi di modelli come elenco separato da virgole. | |
Metodo di inserimento dello slider | Come aggiungere lo slider al selettore (Dopo, Aggiungi, Prima, Prepend, Sostituisci con) | |
Filtra duplicati | Impedisce che slider successivi contengano prodotti da slider precedenti (predefinito: Sì) | |
Pagina carrello | Attivare lo slider del carrello? | Se disattivato, lo slider sulla pagina del carrello non verrà visualizzato nel frontend. |
Selettore carrello slider | Selettore per lo slider del carrello indipendente da Clerk | |
Clerk TemplateName Carrello | Nomi dei modelli di slider da visualizzare. Possono essere specificati più nomi di modelli come elenco separato da virgole. | |
Metodo di inserimento dello slider | Come aggiungere lo slider al selettore (Dopo, Aggiungi, Prima, Prepend, Sostituisci con) | |
Filtra duplicati | Impedisce che slider successivi contengano prodotti da slider precedenti (predefinito: Sì) | |
Powerstep | Attivare lo Slider Powerstep? | Se disattivato, lo slider nel passo di potenza non verrà riprodotto nel frontend. |
Selettore Powerstep | Selettore per lo Slider Powerstep indipendente da Clerk | |
Clerk TemplateName Powerstep | Nomi dei modelli di slider da visualizzare. Possono essere specificati più nomi di modelli come elenco separato da virgole. | |
Metodo di inserimento Powerstep | Come aggiungere lo slider al selettore (Dopo, Aggiungi, Prima, Prepend, Sostituisci con) | |
Filtra duplicati | Impedisce che slider successivi contengano prodotti da slider precedenti (predefinito: Sì) |

Componente | Opzione | Significato |
---|---|---|
Pagina categoria | Attivare lo slider della pagina categoria? | Se disattivato, lo slider sulla pagina categoria non verrà visualizzato nel frontend. |
Selettore Categoria Slider | Selettore per lo slider della categoria indipendente da Clerk | |
Clerk TemplateName Carrello | Nomi dei modelli di slider da visualizzare. Possono essere specificati più nomi di modelli come elenco separato da virgole. | |
Metodo di inserimento dello slider | Come aggiungere lo slider al selettore (Dopo, Aggiungi, Prima, Prepend, Sostituisci con) | |
Filtra duplicati | Impedisce che slider successivi contengano prodotti da slider precedenti (predefinito: Sì) | |
Intento di Uscita | Abilitare lo Slider Intento di Uscita? | Se disattivato, l’intento di uscita non verrà visualizzato nel frontend. |
Clerk TemplateName Intento di Uscita | Modello per l’intento di uscita |
Domini multipli #
Il modo più semplice per implementare Clerk.io in più domini in configurazioni standard è creando un Negozio separato per ogni dominio in my.clerk.io, e poi sincronizzarli con ciascuno dei tuoi domini linguistici JTL.
In questo modo, puoi separare prodotti, vendite, valute, ecc. per tenere traccia di ciascun dominio.
Inizia creando il tuo Negozio principale e segui la Guida all’Installazione per collegare il tuo Negozio a Clerk.io, e scegli le Raccomandazioni e/o i Risultati di Ricerca che desideri visualizzare sul tuo webshop.
Quando hai terminato la configurazione iniziale, torna alla pagina di avvio di my.clerk.io (cliccando sul logo Clerk.io nell’angolo in alto a sinistra del menu laterale) e poi clicca su "+ Aggiungi nuovo negozio" l’ultima opzione dell’elenco a discesa (generalmente sotto i negozi esistenti e il nome della tua azienda):

- Nella pagina Aggiungi Nuovo Negozio, clicca su Avanzato per vedere tutte le impostazioni.

- Compila i dettagli del tuo dominio e scegli il tuo Negozio principale dal menu a discesa Copia Contenuto da Negozio Esistente, quindi clicca su Aggiungi Negozio. Questo porterà il Contenuto e i Design dal tuo Negozio principale.

- Ora puoi seguire di nuovo la Guida all’Installazione, per attivare Clerk.io cliccando su Iniziare, per Sincronizzare Dati per il nuovo dominio.

Questo ti permetterà di sincronizzare il tuo dominio con il tuo Negozio su my.clerk.io attraverso la Guida all’Installazione.
Quando la Sincronizzazione Dati è terminata, il tuo dominio è pronto e utilizza la stessa configurazione del tuo Negozio principale.
Ripeti questo processo per ciascuno dei tuoi domini linguistici JTL. Ricorda di tradurre Titoli, in Contenuto-> Modifica -> Seleziona Design nella lingua corretta.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.