Get Started

Configura Clerk sul tuo store Lightspeed in pochi semplici passaggi. Questa guida ti accompagna nella connessione del tuo store, nell’installazione degli script di tracciamento e nella sincronizzazione dei tuoi dati.

Connessione del tuo store #

Dopo aver seguito questi semplici passaggi, potrai visualizzare la tua Live Demo, che ti offre una panoramica personale di come Clerk funzionerà sul tuo webshop, prima di completare la configurazione del resto del sistema.

Aggiungi store #

Dopo aver effettuato l’accesso 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 Lightspeed come Platform e seleziona la tua Valuta.

3. Clicca su Add Store.

Installa gli script di tracciamento #

1. Nel backend di Lightspeed, vai su Settings > Website-Settings > Web Extras.

2. Tracciamento visitatori: trova la casella Custom JS e inserisci lo script di tracciamento visitatori di Clerk.

   • Sostituisci INSERT_PUBLIC_API_KEY con la tua Public Key presa da my.clerk.io > Developers > API Keys.

• Se questo non dovesse funzionare, inserisci lo script nella casella Tracking.

<!-- Clerk.io Visitor Tracking (Lightspeed) -->
<script type="text/javascript">
  (function(w,d){
    var e=d.createElement('script'); e.type='text/javascript'; e.async=true;
    e.src='https://cdn.clerk.io/clerk.js';
    var s=d.getElementsByTagName('script')[0]; s.parentNode.insertBefore(e,s);
    w.__clerk_q=w.__clerk_q||[]; w.Clerk=w.Clerk||function(){w.__clerk_q.push(arguments)};
  })(window,document);

  Clerk('config', {
    key: 'INSERT_PUBLIC_API_KEY',
    formatters: {
      convert_currency: function(price) {
        const rate_raw = '{{ 100 | money }}'.replace(/[^0-9.]/g, '');
        const rate = parseFloat(rate_raw) ? (parseFloat(rate_raw) / 100) : 1;
        return rate * price;
      }
    },
    globals: {
      currency_iso: '{{ shop.currency2.code }}',
      currency_symbol: '{{ shop.currency2.symbol }}'
    }
  });

  {% if page.account.email %}
  Clerk('call', 'log/email', { email: '{{ page.account.email }}' });
  {% endif %}
</script>

3. Tracciamento ordini: nella stessa pagina, trova la casella Tracking e inserisci il codice di tracciamento ordini di Clerk sotto lo script visitatori.

<span
  class="clerk"
  data-api="log/sale"
  data-sale="{{ order.information.number }}"
  data-email="{{ order.customer.email }}"
  data-customer="{{ order.customer.id }}"
  data-products='[{% for product in order.products %}{"id":{{ product.product_id }},"quantity":{{ product.quantity }},"price":{{ product.base_price_incl }}}{% if not loop.last %},{% endif %}{% endfor %}]'>
</span>

4. Clicca su Save.

Sincronizza i dati #

1. Vai su my.clerk.io > Data > Configuration.

2. Inserisci le seguenti informazioni per il tuo store Lightspeed:

   • Dominio: L’URL del tuo webshop (ad esempio, https://www.beautifulshop.nl/).

   • Cluster ID: Consulta la documentazione Server Clusters di Lightspeed (scegli il cluster per la tua regione, es. https://api.webshopapp.com/nl per NL).

   • API Key e API Secret: Contatta il supporto Lightspeed per farle generare per il tuo store.

   • Lingua (opzionale): Usa codici come en o nl per store multilingua.

3. Inserisci i dettagli nei campi dell’importatore. Le impostazioni avanzate opzionali possono essere lasciate invariate.

4. Clicca su Start Sync e attendi il completamento della sincronizzazione.