Jtl

Get Started

Installa Clerk su JTL seguendo questi semplici passaggi

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:

Esempio di come dovrebbe apparire
  1. Scrivi il Nome e il Dominio del tuo webshop.

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

  3. Clicca su Add Store.

  4. 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:

Pagina di installazione dell’estensione

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:

Pagina Sincronizza i tuoi dati

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:

Aspetto della schermata di creazione dello 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:

All’interno del plugin clerk se scorri un po’ in basso

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.

Esempio di uno slider di raccomandazioni usando il nostro editor di design
  • 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.

Credenziali
OpzioneSignificato
API KeyLa tua chiave API ricevuta da Clerk
Private KeyLa tua legacy private API key fornita da Clerk. Necessaria per limitare l’accesso al feed dati.
LanguageLingua del feed dati
customer groupPrezzi per il gruppo clienti
CurrencyValuta nel feed dati
Faceted designDesign delle faccette
Tracking e impostazioni Search
ComponenteOpzioneSignificato
GenerallyUsa tracciamento senza cookieTracciamento senza uso di cookies
Usare tracciamento carrello?Informa Clerk sulle variazioni del carrello (tracciamento carrello generale)
Anonimizzare emailGli 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 LivesearchSelettore live search indipendente da Clerk
Clerk TemplateName LivesucheTemplate 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 searchNumero di suggerimenti ricerca da visualizzare
Numero di suggerimenti categoriaNumero di suggerimenti categoria da visualizzare
Numero di suggerimenti paginaNumero di suggerimenti pagina da visualizzare
PosizionePosizione 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 SearchTemplate per la live search (Clerk Backend → Search → Content → Search → Inserisci nel sito → Nel codice il valore di “data-template="@WERT’”)
Posizione faccettePosizione delle faccette
Mostra faccette nell’URLMostra faccette nell’URL
Clerk Facets AttributeLista separata da virgole delle faccette disponibili (funzionalità JTL)
Clerk Facets Attributes Multiple ValuesLista separata da virgole delle faccette disponibili con valori multipli (caratteristiche JTL per filtraggio OR)
Impostazione feed dati e Recommendation
ComponenteOpzioneSignificato
Data FeedElaborazione CronModalità di attivazione del cron per generare il feed dati (spiegato meglio nella sezione Possibilità di creazione feed dati)
Batch sizeDimensione batch dei prodotti del feed (spiegato nella sezione batch size)
Pagina prodottoAttivare slider pagina prodotto?Se disattivato, lo slider in pagina prodotto non verrà mostrato nel frontend.
Selettore slider articoloSelettore dello slider articolo indipendente da Clerk
Clerk TemplateName ArticleNomi dei template slider da visualizzare. Più nomi template possono essere specificati come lista separata da virgole.
Metodo inserimento sliderCome aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith)
Filtro duplicatiImpedisce che gli slider successivi contengano prodotti già presenti (default: Yes)
Pagina carrelloAttivare slider pagina carrello?Se disattivato, lo slider in pagina carrello non verrà mostrato nel frontend.
Selettore slider carrelloSelettore dello slider carrello indipendente da Clerk
Clerk TemplateName Shopping CartNomi dei template slider da visualizzare. Più nomi template possono essere specificati come lista separata da virgole.
Metodo inserimento sliderCome aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith)
Filtro duplicatiImpedisce che gli slider successivi contengano prodotti già presenti (default: Yes)
PowerstepAttivare Slider Powerstep?Se disattivato, lo slider nel power step non sarà visualizzato nel frontend.
Powerstep SelectorSelettore per lo slider Powerstep indipendente da Clerk
Clerk TemplateName PowerstepNomi dei template slider da visualizzare. Più nomi template possono essere specificati come lista separata da virgole.
Metodo inserimento PowerstepCome aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith)
Filtro duplicatiImpedisce che gli slider successivi contengano prodotti già presenti (default: Yes)
Impostazioni categoria e exit intent
ComponenteOpzioneSignificato
Pagina categoriaAttivare slider pagina categoria?Se disattivato, lo slider in pagina categoria non verrà mostrato nel frontend.
Kategorie Selektor SliderSelettore slider categoria indipendente da Clerk
Clerk TemplateName Shopping CartNomi dei template slider da visualizzare. Più nomi template possono essere specificati come lista separata da virgole.
Metodo inserimento sliderCome aggiungere lo slider al selettore (After, Append, Before, Prepand, ReplaceWith)
Filtro duplicatiImpedisce che gli slider successivi contengano prodotti già presenti (default: Yes)
Exit IntentAttiva slider Exit Intent?Se disattivato, l’exit intent non sarà visualizzato nel frontend.
Clerk TemplateName Exit IntentTemplate 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.

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

  2. 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):

Add new store dropdown
  1. Nella pagina Add New Store, clicca su Advanced per vedere tutte le impostazioni.
Advanced settings
  1. 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.
Copy content from existing store
  1. Ora puoi seguire nuovamente la Setup Guide, per attivare Clerk cliccando su Getting Started, per Sync Data per il nuovo dominio.
Getting started page
  1. Questo ti permetterà di sincronizzare il tuo dominio con il tuo Store su my.clerk.io attraverso la Setup Guide.

  2. Quando la Data Sync è terminata, il tuo dominio è pronto e utilizza la stessa configurazione dello Store principale.

  3. 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.