Get Started

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

Collegare il tuo negozio #

Dopo aver seguito questi semplici passaggi, potrai vedere la tua Live Demo, che ti fornisce 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 da fare è aggiungere il tuo negozio:

1. Scrivi 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 del prodotto. Per questo motivo, lo script deve essere inserito in un file tema in cui 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 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.

Sincronizza i dati #

Sincronizzare i dati collega il tuo negozio Lightspeed a Clerk, permettendo a Clerk di accedere ai tuoi prodotti, ordini, clienti e altre informazioni del negozio. Questo consente a Clerk di offrire consigli personalizzati e risultati di ricerca basati sui dati reali del tuo negozio. Segui i passaggi della guida Sincronizza Dati per configurare la sincronizzazione dei dati.