Get Started

Configura Clerk e avvialo nel tuo store Lightspeed in pochi 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 vedere la tua Live Demo, che ti fornisce una panoramica personale su come Clerk funzionerà sul tuo webshop, prima di configurare il 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 Piattaforma e scegli la Valuta.

3. Clicca su Add Store.

Installa gli script di tracciamento #

Lo script di tracciamento di Clerk utilizza le variabili Lightspeed Liquid per leggere i dati del negozio come valuta e contesto dei prodotti. Per questo motivo, lo script deve essere inserito in un file di tema in cui Liquid viene elaborato.

Tracciamento visitatori #

1. Nel backend di Lightspeed, vai su Design > Theme Editor > Advanced > Edit Code.

2. Apri layouts > custom.rain.

3. Incolla il seguente script in fondo al file e sostituisci INSERT_PUBLIC_API_KEY con la tua Public Key da my.clerk.io > Developers > API Keys.

<!-- 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 }}'
    }
  });
  // Clerk.js Context
  Clerk('context', {
    product: {% if product.id %}'{{ product.id }}'{% else %}null{% endif %},
    category: {% if collection.category_id %}'{{ collection.category_id }}'{% else %}null{% endif %},
    page: {% if product.id %}null{% else %}{% if collection.category_id %}null{% else %}'{{ template }}'{% endif %}{% endif %}
  });

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

4. Clicca su Save.

Le pagine del carrello e di ringraziamento in Lightspeed utilizzano un file di tema separato chiamato fixed.rain. Questo file non eredita gli script da custom.rain, quindi Clerk.js non sarà caricato su queste pagine a meno che lo script non venga aggiunto anche qui.

5. Apri layouts > fixed.rain nello stesso Theme Editor.

6. Incolla lo stesso script appena prima del tag di chiusura </head>.

7. Clicca su Save.

Tracciamento ordini #

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

2. Trova il box Tracking e inserisci il codice di tracciamento ordini Clerk.

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

3. Clicca su Save.

Se gli ordini non vengono ancora tracciati #

Alcuni temi Lightspeed non caricano Clerk.js da custom.rain e fixed.rain durante il checkout. Se Clerk.io è già stato aggiunto a entrambi i file ma gli ordini non vengono ancora tracciati, aggiungi lo script di tracciamento visitatori anche nei Web Extras.

1. Vai su Settings > Website-Settings > Web Extras e trova il box Tracking.

2. Incolla lo script di tracciamento visitatori immediatamente sopra il codice di tracciamento ordini Clerk.io.

3. Clicca su Save.

Utilizza questo posizionamento solo quando la configurazione standard dei file tema non traccia gli ordini. L’esigenza dipende dal tema Lightspeed attivo.

Sincronizza i dati #

La sincronizzazione dei dati collega il tuo store Lightspeed a Clerk, permettendo a Clerk di accedere a prodotti, ordini, clienti e altre informazioni del negozio. Questo consente a Clerk di offrire raccomandazioni personalizzate e risultati di ricerca basati sui dati reali del tuo store. Segui i passaggi nella Guida di sincronizzazione dati per configurare la sincronizzazione dei dati.