Get Started
Metti in funzione Clerk sul tuo store JTL in pochi passaggi. Questa guida ti accompagna nella connessione del tuo store, nella configurazione del plugin e nella sincronizzazione dei tuoi dati.
Connessione del tuo store #
Il primo passo per installare Clerk è collegare il tuo store al tuo account Clerk.
Dopo aver seguito questi semplici passaggi potrai vedere il tuo Demo Store, che ti offre una panoramica personale su come Clerk funzionerà sul tuo webshop, prima di completare il resto del sistema.
Aggiungi store #
Dopo aver effettuato l’accesso a my.clerk.io, la prima cosa da fare è aggiungere il tuo store:
Inserisci il Nome e il Dominio del tuo webshop.
Scegli JTL come Piattaforma e seleziona la tua Valuta.
Fai clic su Add Store.
Una volta che lo store è stato creato, un’email con le chiavi pubblica e privata verrà inviata al proprietario dell’account Email.
Configura la connessione #
Dal menu principale della Setup Guide, fai clic su Install Extension:
La pagina successiva mostra cosa occorre fare per configurare la connessione JTL.
Vai al tuo plugin Clerk nel backend JTL e aggiungi le chiavi pubblica e privata dallo store clerk nei rispettivi campi.
Sincronizza store #
Dopo aver consentito l’accesso, dovrai semplicemente sincronizzare il tuo store.
Torna alla Setup Guide e fai clic su Sync Your Data:
Inserisci i dettagli del tuo store e clicca su Start Sync.
L’url del feed JTL dovrebbe essere creato seguendo questa guida Creation of Data Feeds 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.
La prima cosa che dovrai fare per configurare il tuo account Clerk, è creare il tuo primo Store:
Dopo questo, la Setup Guide ti guiderà nel resto dell’installazione.
Nota che ogni volta che viene creato uno store, un’email con le chiavi pubblica e privata sarà inviata al proprietario dell’account aziendale. Questo serve per creare accesso sicuro tra Clerk e JTL.
Installazione degli script di tracking #
Con il plugin S360 Clerk puoi abilitare sia gli script di tracciamento dei visitatori che degli ordini, che verranno inseriti in alcune parti del webshop:
Lo script di tracciamento visitatori, che inizializza Clerk. Questo deve essere inserito nell’header del webshop.
Lo script di tracciamento ordini che consente il tracciamento degli ordini in tempo reale. Questo viene solitamente installato nella pagina di conferma ordine.
Puoi abilitarli all’interno del plugin JTL nella sezione ALLGEMEIN:
Quando entrambi gli script sono inseriti, Clerk sarà 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.
Ciò avviene configurando un feed dati che consente di accedere ai dati regolarmente.
Questo è spiegato più dettagliatamente in questa guida Creation of Data Feeds in JTL.
Quando il feed dati sarà stato generato e aggiunto alle impostazioni di sincronizzazione dati nella tua area System Status di my.clerk.io backend.
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 tu voglia oppure puoi utilizzare alcuni dei nostri template standard Template Design to use in Clerk.
Molto spesso utilizzerai 3 Design: uno per Instant Search, la Search page e le Recommendations.
- Un Elemento con uno embedcode allegato che visualizza i prodotti. Ogni elemento ha uno specifico nome nell’embedcode che desideri aggiungere nel rispettivo campo nome Clerk TemplateName. Ciò è utilizzato per comunicare tra il tuo webshop e il rispettivo elemento clerk.
La Setup Guide ti mostrerà dove collocare ciascun elemento nella maggior parte delle configurazioni JTL.
Al termine della configurazione, le impostazioni nel plugin dovrebbero apparire così. Le immagini seguenti sono solo a scopo dimostrativo.
| Option | Meaning |
|---|---|
| API Key | La tua API key ricevuta da Clerk |
| Private Key | La tua legacy private API key fornita da Clerk. Necessaria per limitare l’accesso al feed dei dati. |
| Language | Lingua del feed dati |
| customer group | Prezzi per il gruppo clienti |
| Currency | Valuta nel feed dati |
| Faceted design | Design delle faccette |
| Component | Option | Meaning |
|---|---|---|
| Generally | Usa il tracciamento senza cookie | Tracciamento senza l’uso di cookie |
| Usare il tracciamento del carrello? | Informa Clerk sulle modifiche al carrello (tracciamento generale del carrello) | |
| Anonimizzare le email | Gli indirizzi Email vengono trasmessi a Clerk in modo anonimo (come hash). | |
| Live Suche (Header) | Attivare la live search? | Se disattivato, la Clerk Live search non sarà mostrata nel frontend. |
| Selektor Livesearch | Selettore live search indipendente da Clerk | |
| Clerk TemplateName Livesuche | Template per la live search (Clerk Backend → Search → Elements → Live search → Insert into website → Nel codice il valore da “data-template="@WERT’”) | |
| Numero di suggerimenti ricerca live | 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 (results page) | Attivare la pagina dei risultati? | Se disattivato, la Clerk results page non sarà mostrata nel frontend. |
| Clerk TemplateName Search | Template per live search (Clerk Backend → Search → Elements → Search → Insert into website → Nel codice il valore da “data-template="@WERT’”) | |
| Posizione faccette | Posizione delle faccette | |
| Mostrare faccette nell’URL | Mostrare 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 con più valori (caratteristiche JTL per filtraggio OR) |
| Component | Option | Meaning |
|---|---|---|
| Data Feed | Processing cron | Come il cron deve essere attivato per generare il feed dati (spiegato in dettaglio nella sezione Modalità di creazione del feed dati) |
| Batch size | Quantità batch dei prodotti nel feed (spiegato meglio nella sezione batch size) | |
| Pagina prodotto | Attivare slider pagina prodotto? | Se disattivato, lo slider nella pagina prodotto non sarà mostrato nel frontend. |
| Selettore slider articolo | Selettore per lo slider articolo indipendente da Clerk | |
| Clerk TemplateName Article | Nomi dei template slider da mostrare. Si possono specificare più template come lista separata da virgole. | |
| Metodo di inserimento slider | Come aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith) | |
| Filtrare duplicati | Previene che slider successivi contengano i prodotti degli slider precedenti (default: Yes) | |
| Pagina carrello | Attivare slider su pagina carrello? | Se disattivato, lo slider nella pagina carrello non sarà mostrato nel frontend. |
| Selettore slider carrello | Selettore per lo slider carrello indipendente da Clerk | |
| Clerk TemplateName Shopping Cart | Nomi dei template slider da mostrare. Si possono specificare più template come lista separata da virgole. | |
| Metodo di inserimento slider | Come aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith) | |
| Filtrare duplicati | Previene che slider successivi contengano i prodotti degli slider precedenti (default: Yes) | |
| Powerstep | Attivare Powerstep Slider? | Se disattivato, lo slider in power step non verrà mostrato nel frontend. |
| Selettore Powerstep | Selettore per Powerstep Slider indipendente da Clerk | |
| Clerk TemplateName Powerstep | Nomi dei template slider da mostrare. Si possono specificare più template come lista separata da virgole. | |
| Metodo di inserimento Powerstep | Come aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith) | |
| Filtrare duplicati | Previene che slider successivi contengano i prodotti degli slider precedenti (default: Yes) |
| Component | Option | Meaning |
|---|---|---|
| Pagina categoria | Attivare slider su pagina categoria? | Se disattivato, lo slider nella pagina categoria non sarà mostrato nel frontend. |
| Selettore Slider Categoria | Selettore per lo slider categoria indipendente da Clerk | |
| Clerk TemplateName Shopping Cart | Nomi dei template slider da mostrare. Si possono specificare più template come lista separata da virgole. | |
| Metodo di inserimento slider | Come aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith) | |
| Filtrare duplicati | Previene che slider successivi contengano i prodotti degli slider precedenti (default: Yes) | |
| Exit Intent | Abilitare Exit Intent Slider? | Se disattivato, l’exit intent non sarà mostrato nel frontend. |
| Clerk TemplateName Exit Intent | Template per l’exit intent |
Domini multipli #
Il modo più semplice per implementare Clerk in più domini nelle configurazioni standard è creare un Store separato per ciascun dominio in my.clerk.io, e poi sincronizzarli con ognuno dei tuoi domini linguistici JTL.
In questo modo puoi separare prodotti, vendite, valute, ecc., per tenere traccia di ogni dominio.
Inizia creando il tuo main Store e segui la Setup Guide per collegare il tuo Store a Clerk, e scegli la/le Recommendations e/o Search Results che desideri visualizzare nel tuo webshop.
Una volta completata la configurazione iniziale, torna alla pagina iniziale di my.clerk.io (cliccando il logo Clerk nell’angolo in alto a sinistra del side-menu) e poi clicca su "+ Add new store" ultima opzione della lista a tendina (generalmente sotto lo/gli store esistenti e il nome della tua azienda):
- Nella pagina Add New Store, clicca su Advanced per visualizzare tutte le impostazioni.
- Inserisci i dettagli del tuo dominio e scegli il tuo main Store dal menu Copy Elements From Existing Store, poi clicca su Add Store. In questo modo importerai Elements e Designs dal main Store.
- Ora puoi seguire ancora 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 lo Store su my.clerk.io tramite la Setup Guide.
Quando Data Sync è terminata, il tuo dominio è pronto e utilizzerà la stessa configurazione del main Store.
Ripeti questo processo per ciascuno dei tuoi domini linguistici JTL. Ricorda di tradurre le Headlines, in Element-> Edit -> Select Design nella lingua corretta.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.