Jtl

Get Started

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.

Collegamento del negozio #

Il primo passo dell’installazione di Clerk.io è la connessione del vostro negozio con il vostro account Commesso.io.

Dopo aver seguito questi semplici passaggi, sarete in grado di vedere il vostro Negozio demo, che vi darà una panoramica personale di come Commesso.io funzionerà sul vostro negozio web, prima di impostare il resto del sistema.

1. Aggiungi negozio #

Dopo aver effettuato l’accesso a mio.clerk.io, la prima cosa da fare è aggiungere il proprio negozio:

Example of how it should look
  1. Scrivete nome e Dominio del vostro negozio web.

  2. Scegliete JTL come Piattaforma e scegliete la vostra Valuta.

  3. Fare clic su Aggiungi negozio.

  4. Una volta creato il negozio, verrà inviata un’e-mail con le chiavi pubbliche e private al proprietario dell’account.

2. Configurare la connessione JTL #

Dal menu principale della Guida alla configurazione, fare clic su Installare l’estensione:

La pagina successiva mostra le operazioni da eseguire per configurare la connessione JTL.

Andare al plugin Clerk nel backend JTL e aggiungere le chiavi pubbliche e private dal negozio clerk nei rispettivi campi.

3. Sincronizzare il negozio #

Dopo aver consentito l’accesso, è sufficiente sincronizzare il negozio.

Tornare alla Guida alla configurazione e fare clic su Sincronizzare i dati:

Inserite i dati del vostro negozio e fate clic su Avvia sincronizzazione

L’url del feed JTL deve essere realizzato sulla base di questa guida Creazione di feed di dati in JTL

Esempio di installazione completa #

IMPORTANTE: il plugin (S360 CLerk) deve essere installato nel backend di JTL alla voce PLACEHOLDER_236

Questa documentazione vi guiderà attraverso i seguenti passaggi:

Aggiungere un negozio in my.clerk.io #

Ogni negozio di Clerk.io è un ambiente isolato con i propri dati, chiavi API e Dashboard. La prima cosa da fare quando si configura l’account Clerk.io è creare il primo negozio:

How the store creation screen looks

Dopodiché, la Guida all’installazione vi guiderà attraverso il resto della configurazione.

PLACEHOLDER_259

Installazione dei due script di tracciamento #

Con il plugin S360 Clerk, è possibile abilitare gli script di tracciamento dei visitatori e degli ordini che verranno iniettati in alcune parti del webshop:

  • Lo script Visitor Tracking, che inizializza Clerk.io. Deve essere iniettato all’interno dell’intestazione del webshop.

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

È possibile attivarli all’interno del plugin JTL nella sezione ALLGEMEIN:

Inside the clerk plugin if you scroll a bit down

Quando entrambi gli script sono inseriti, Clerk.io viene inizializzato.

Sincronizzazione del 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 di dati generato.

A tal fine, è necessario impostare un feed di dati che consenta di accedere regolarmente ai dati. Questo è spiegato ulteriormente in questa guida Creazione di feed di dati in JTL.

Quando il feed di dati è stato generato e aggiunto alle impostazioni di sincronizzazione dei dati in Stato del sistema nel backend my.clerk.io.

Aggiunta di ricerca e raccomandazioni #

Gli elementi del frontend di Clerk.io sono costituiti da due parti:

  • Un Design che controlla la presentazione visiva dei prodotti. Questo può essere modificato per adattarsi a qualsiasi stile si desideri o si possono utilizzare alcuni dei nostri modelli di design standard Modelli da utilizzare in Clerk.

  • Nella maggior parte dei casi si utilizzano 3 design: Uno per Instant Search, la pagina di ricerca e le raccomandazioni.

Example of a recommendation slider using our design editor
  • Un Contenuto con un codice embed allegato che visualizza i prodotti. Ogni contenuto ha un nome specifico nel suo embedcode che si vuole aggiungere al nome del rispettivo campo Clerk TemplateName. Questo viene utilizzato per comunicare tra il vostro webshop e il rispettivo contenuto clerk.

Il sito Guida alla configurazione illustra la collocazione di ciascun elemento nella maggior parte delle configurazioni JTL.

Al termine della configurazione, le impostazioni del plugin dovrebbero avere il seguente aspetto. Le immagini seguenti sono solo a scopo dimostrativo.

Credentials
OptionMeaning
API KeyYour API key received from Clerk
Private KeyYour legacy private API key provided by Clerk. Required to restrict access to the data feed.
LanguageLanguage of the data feed
customer groupPrices for the customer group
CurrencyCurrency in the data feed
Faceted designDesign of the facets
Tracking and Search settings
ComponentOptionMeaning
GenerallyUse cookieless trackingTracking without the use of cookies
Use shopping cart tracking?Informs Clerk about changes to the shopping cart (general tracking of the shopping cart)
Anonymize emailsEmail addresses are transmitted to Clerk anonymously (as a hash).
Live Suche (Header)Activate live search?If deactivated, the Clerk Live search will not be displayed in the frontend.
Selektor LivesearchLive search selector independent of Clerk
Clerk TemplateName LivesucheTemplate for the live search (Clerk Backend → Search → Content → Live search → Insert into website → In the code the value from “data-template=”@WERT’”)
Number of search suggestions in the live searchNumber of search suggestions to be displayed
Number of category suggestionsNumber of category suggestions to be displayed
Number of page suggestionsNumber of page suggestions to be displayed
PositionPosition of the live search result in relation to the selector
Search (results page)Activate results page?If deactivated, the Clerk results page will not be displayed in the frontend.
Clerk TemplateName SearchTemplate for live search (Clerk Backend → Search → Content → Search → Insert into website → In the code the value from “data-template=”@WERT’”)
Position facetsPosition of the facets
Show facets in URLShow facets in URL
Clerk Facets AttributeComma-separated list of available facets (JTL features)
Clerk Facets Attributes Multiple ValuesComma-separated list of available facets with multiple values ​​(JTL characteristics for OR filtering)
Data feed and Recommendation settings
ComponentOptionMeaning
Data FeedCron processingHow the cron should be triggered to generate the data feed (explained in more detail in the section Possibilities of data feed creation)
Batch sizeBatch size of the feed’s products (explained in more detail in the batch size section)
Product pageActivate product page slider?If deactivated, the slider on the product page will not be displayed in the frontend.
Article selector sliderSelector for the article slider independent of Clerk
Clerk TemplateName ArticleNames of the slider templates to be output. Multiple template names can be specified as a comma-separated list.
Slider Insert methodHow to add the slider to the selector (After, Append, Before, Prepand, ReplaceWith)
Filter duplicatesPrevents subsequent sliders from containing products from previous sliders (default: Yes)
Shopping cart pageActivate shopping cart slider?If deactivated, the slider on the shopping cart page will not be displayed in the frontend.
Shopping cart selector sliderSelector for the shopping cart slider independent of Clerk
Clerk TemplateName Shopping CartNames of the slider templates to be output. Multiple template names can be specified as a comma-separated list.
Slider Insert methodHow to add the slider to the selector (After, Append, Before, Prepand, ReplaceWith)
Filter duplicatesPrevents subsequent sliders from containing products from previous sliders (default: Yes)
PowerstepActivate Powerstep Slider?If deactivated, the slider in the power step is not played in the frontend.
Powerstep SelectorSelector for the Powerstep Slider independent of Clerk
Clerk TemplateName PowerstepNames of the slider templates to be output. Multiple template names can be specified as a comma-separated list.
Powerstep insertion methodHow to add the slider to the selector (After, Append, Before, Prepand, ReplaceWith)
Filter duplicatesPrevents subsequent sliders from containing products from previous sliders (default: Yes)
Category and exit intent settings
ComponentOptionMeaning
Category pageActivate category page slider?If deactivated, the slider on the category page will not be displayed in the frontend.
Kategorie Selektor SliderSelector for the category slider independent of Clerk
Clerk TemplateName Shopping CartNames of the slider templates to be output. Multiple template names can be specified as a comma-separated list.
Slider Insert methodHow to add the slider to the selector (After, Append, Before, Prepand, ReplaceWith)
Filter duplicatesPrevents subsequent sliders from containing products from previous sliders (default: Yes)
Exit IntentEnable Exit Intent Slider?If deactivated, the exit intent is not displayed in the frontend.
Clerk TemplateName Exit IntentTemplate for the exit intent

Domini multipli #

Il modo più semplice per implementare Commesso.io in più domini in configurazioni standard è creare un Negozio separato per ogni dominio in mio.clerk.io e poi sincronizzarlo con ogni dominio del linguaggio JTL.

In questo modo, è possibile separare i prodotti, le vendite, le valute, ecc. per tenere traccia di ciascun dominio.

  1. Iniziate creando il vostro Negozio principale e seguite il Guida all’installazione per collegare il vostro negozio a Clerk.io, e scegliete il Raccomandazioni e/o il Risultati della ricerca che volete visualizzare nel vostro negozio web.

  2. Una volta terminata la configurazione iniziale, tornate alla pagina iniziale di my.clerk.io (cliccando sul logo Commesso.io nella angolo in alto a sinistra del menu laterale) e poi cliccate "+ Aggiungi nuovo negozio" sull’ultima opzione dell’elenco a scorrimento (generalmente sotto il/i negozio/i esistente/i e il nome della vostra azienda):

  1. Su Pagina Aggiungi nuovo negozio, fare clic su Avanzato per visualizzare tutte le impostazioni.
  1. Compilate i dettagli del vostro dominio e scegliete il vostro negozio principale dal menu a tendina Copiare il contenuto di un negozio esistente, quindi fate clic su Aggiungi negozio. In questo modo i siti Contenuto e Designs verranno trasferiti dal vostro negozio principale.
  1. Ora potete seguire di nuovo la Guida all’installazione, per attivare Commesso.io facendo clic su Come iniziare, e Sincronizzare i dati per il nuovo dominio.
  1. Questo vi permetterà di sincronizzare il vostro dominio con il vostro Store su mio.clerk.io attraverso la Guida all’installazione.

  2. Al termine di Sincronizzazione dei dati, il vostro dominio è pronto e utilizza la stessa configurazione del vostro negozio principale.

  3. Ripetete questa procedura per tutti i domini in lingua JTL. Ricordarsi di tradurre anche Titoli di testa, in Contenuto-> Modifica -> Seleziona design nella lingua giusta.