Get Started

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

Connessione del tuo negozio #

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

Aggiungi negozio #

Dopo aver effettuato l’accesso su my.clerk.io, la prima cosa che devi fare è aggiungere il tuo negozio:

1. Inserisci il Nome e il Dominio del tuo webshop.

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

3. Clicca su Add Store.

Installa gli script di tracciamento #

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

Tracciamento dei 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.

Tracciamento degli ordini #

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

2. Trova la casella Tracking e inserisci il codice di tracciamento ordine 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.

Sincronizza i dati #

La sincronizzazione dei dati collega il tuo negozio Lightspeed a Clerk, consentendo a Clerk di accedere a prodotti, ordini, clienti e altre informazioni del negozio. Questo permette a Clerk di fornire raccomandazioni personalizzate e risultati di Search basati sui dati reali del tuo negozio. Segui i passaggi nella guida Sync Data per configurare la sincronizzazione dati.