FAQ

Problemi con l’integrazione di Lightspeed? Questa FAQ copre i problemi più comuni e le relative soluzioni, dai formatters agli errori di sincronizzazione.

Utilizzo dei formatters #

Clerk.js ti permette di scrivere funzioni JavaScript personalizzate che aggiungono nuove funzionalità ai tuoi Designs.

I formatters possono essere aggiunti in due modi:

• Tramite my.clerk.io > Developers > Formatters, dove ogni Formatter può essere creato come voce separata.

• Come una configuration per Clerk.js, nello tracking-script che viene inserito in tutte le pagine, dove più formatters possono essere aggiunti contemporaneamente.

Esempio di formatter #

Un esempio è visibile qui sotto. Si prega di notare che questa è la Clerk V2 (ultima versione):

Clerk('config', {
  key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
  formatters: {
    log_price: function(price) {
      console.log(price);
    }
  }
});

Più formatters #

Puoi scrivere qualsiasi numero di formatters, separati da una virgola, in questo modo:

formatters: {
  log_price: function(price) {
    console.log(price);
  },
  calculate_discount: function(price, special_price) {
    return price - special_price;
  },
  substring: function(text) {
    var short_string = text.substring(0, 20);
    return short_string;
  }
}

Utilizzo nei designs #

Dopo aver creato un formatter, chiamalo dal template Liquid del tuo Design usando il nome del formatter.

Questo ti consente di creare qualsiasi funzionalità nei tuoi Designs che desideri utilizzare con Clerk nel tuo webshop.

Errori comuni #

Clerk not defined #

Se vedi questo messaggio di errore, significa che Clerk non è definito nel sito web.

La causa più comune è che gli script di tracking di Clerk non sono stati implementati nei posti corretti.

Clicca qui per visualizzare il processo di implementazione per inserire sia gli script di Order Tracking che di Visitor Tracking.

API cooldown #

Questo messaggio nei log di sincronizzazione dati proviene dal rate limit di Lightspeed.

Lightspeed ha impostato di default un basso rate limit per gestire il volume di dati trasmessi dai loro servizi.

Nota che questo rate limit non è sotto il controllo di Clerk.

Per risolvere, hai due opzioni:

1. Considera l’aggiornamento del servizio di rate limit con Lightspeed.

2. In alternativa, puoi scegliere di attendere il completamento del processo di sincronizzazione.

429 Too Many Requests #

Questo errore significa che Lightspeed ha effettuato troppe richieste in un dato periodo di tempo e ha superato il suo rate limit.

Per risolvere, suggeriamo di regolare la dimensione della pagina nelle tue data sync settings in my.clerk.io > Data > Configuration.

Ordini non tracciati #

Se gli ordini non vengono tracciati in Clerk.io, potrebbe essere perché Clerk.js non viene caricato sulla pagina del carrello o della conferma d’ordine.

In Lightspeed, queste pagine usano un file tema separato chiamato fixed.rain. Gli script aggiunti a custom.rain non sono inclusi su queste pagine, quindi Clerk.js potrebbe essere assente quando l’ordine viene completato — il che significa che la vendita non viene mai tracciata.

Per risolvere, aggiungi anche lo script di visitor tracking a fixed.rain:

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

2. Apri layouts > fixed.rain.

3. Incolla lo visitor tracking script in fondo al file.

4. Clicca su Save.

Se Clerk.io è già presente sia in custom.rain che in fixed.rain ma gli ordini non vengono comunque tracciati, il tuo tema potrebbe richiedere Clerk.js in Web Extras invece. Vai su Settings > Website-Settings > Web Extras, quindi incolla lo script di visitor tracking immediatamente sopra il codice di order tracking di Clerk.io nella casella Tracking.

Questo dipende dal tema, quindi aggiungilo a Web Extras solo quando le posizioni standard non risolvono il problema.