Get Started

Configura Clerk e fallo funzionare sul tuo store JTL in pochi 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 passaggio per installare Clerk è collegare il tuo store al tuo account Clerk.

Dopo aver seguito questi semplici passaggi, sarai in grado di vedere il tuo Demo Store, che ti offrirà una panoramica personale di come Clerk funzionerà sul tuo webshop, prima di configurare il resto del sistema.

Aggiungi store #

Dopo aver effettuato il login su my.clerk.io, la prima cosa da fare è aggiungere il tuo store:

1. Scrivi il Nome e il Dominio del tuo webshop.

2. Scegli JTL come Piattaforma e seleziona la tua Valuta.

3. Clicca su Aggiungi Store.

4. Una volta creato lo store, verrà inviata una email riguardante le chiavi pubbliche e private al proprietario dell’account email.

Configura la connessione #

Dal menu principale della Setup Guide, 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 inserisci le chiavi pubblica e privata dallo store clerk nei rispettivi campi.

Sincronizza lo store #

Dopo aver consentito l’accesso, devi semplicemente sincronizzare il tuo store.

Torna alla Setup Guide e clicca su Sincronizza i tuoi dati:

Inserisci i dati del tuo store e clicca su Avvia la sincronizzazione.

L’url del feed JTL dovrebbe essere creato in base a questa guida Creazione di Data Feed in JTL.

Esempio di installazione completa #

IMPORTANTE: Devi aver installato il plugin (S360 Clerk) nel backend JTL sotto Plugins

Questa documentazione ti guiderà nei seguenti passaggi:

Aggiunta di uno store #

Ogni Store in Clerk è un ambiente isolato con i propri dati, chiavi API e Dashboard.

Crea il tuo primo Store in Clerk prima di continuare con la Setup Guide.

Dopo questo, la Setup Guide ti accompagnerà nel resto della configurazione.

Nota che ogni volta che viene creato uno store, viene inviata una email con le chiavi pubblica e privata al proprietario dell’account aziendale. Questo serve per creare un accesso sicuro tra Clerk e JTL.

Installazione degli script di tracciamento #

Con il plugin S360 Clerk, puoi attivare sia gli script di tracciamento visitatori che ordini, che verranno inseriti in parti del webshop:

• Lo script di tracciamento visitatori, che inizializza Clerk. Questo deve essere inserito all’interno dell’header del webshop.

• Lo script di tracciamento degli ordini, che consente il tracciamento degli ordini in tempo reale. Di solito viene installato nella pagina di conferma dell’ordine.

Attiva entrambi gli script nella sezione ALLGEMEIN del plugin JTL.

Quando entrambi gli script sono inseriti, Clerk sarà stato inizializzato.

Sincronizzazione del tuo store #

Per mostrare i risultati, Clerk deve sincronizzarsi con prodotti, categorie, vendite, pagine e clienti da JTL tramite un feed dati generato.

Questo viene fatto impostando un feed dati che consente di accedere regolarmente ai dati.

Questo viene spiegato ulteriormente in questa guida Creazione di Data Feed in JTL.

Quando il feed dati è stato generato e aggiunto alle impostazioni di Data sync sotto System Status nel tuo backend 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. Puoi modificarlo secondo lo stile che desideri o utilizzare alcuni dei nostri template standard Template Design da usare in Clerk.

• Generalmente, utilizzerai 3 Design: uno per l’Instant Search, la pagina Search e Recommendations.

• Un Elemento con un embedcode collegato che mostra i prodotti. Ogni elemento ha un nome specifico nel proprio embedcode che va aggiunto ai rispettivi campi dal nome Clerk TemplateName. Questo viene usato per comunicare tra il tuo webshop e il rispettivo elemento clerk.

La Setup Guide ti illustrerà dove ciascun elemento deve essere inserito nella maggior parte delle configurazioni JTL.

Al termine della configurazione, verifica le impostazioni del plugin rispetto alle opzioni qui sotto.

Più domini #

Il modo più semplice per implementare Clerk in più domini nella configurazione standard è creando un Store separato per ogni dominio in my.clerk.io, e sincronizzandoli con ciascuno dei tuoi domini linguistici JTL.

In questo modo puoi separare prodotti, vendite, valute, ecc. per tenere traccia di ogni dominio.

1. 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 desideri mostrare sul tuo webshop.

2. Una volta terminata la configurazione iniziale, torna alla pagina principale di my.clerk.io (cliccando sul logo Clerk nell’angolo in alto a sinistra del menu laterale) e poi clicca "+ Aggiungi nuovo store" come ultima opzione della lista a discesa (solitamente sotto gli store esistenti e il nome della tua azienda):

3. Nella pagina Aggiungi Nuovo Store, clicca su Avanzate per vedere tutte le impostazioni.

4. Compila i dettagli del tuo dominio e scegli il tuo Store principale dal menu a tendina Copia elementi dallo Store esistente, poi clicca su Aggiungi Store. Questo copierà gli Elementi e i Design dal tuo Store principale.

5. Ora puoi seguire nuovamente la Setup Guide per attivare Clerk cliccando su Getting Started, per Sincronizzare i Dati per il nuovo dominio.

6. Questo ti permetterà di sincronizzare il tuo dominio con il tuo Store su my.clerk.io tramite la Setup Guide.

7. Quando la Data Sync è terminata, il tuo dominio è pronto e utilizza le stesse impostazioni del tuo Store principale.

8. Ripeti questa procedura per ognuno dei tuoi domini linguistici JTL. Ricorda di tradurre anche le Headlines, in Element-> Edit -> Select Design nella lingua corretta.