FAQ

Hai riscontrato problemi con la tua integrazione Lightspeed? Questa FAQ copre i problemi più comuni e le relative soluzioni, dai formatter agli errori di sincronizzazione.

Utilizzo dei formatter #

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

I formatter possono essere aggiunti in due modi:

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

• Come configurazione per Clerk.js, nello tracking-script che viene inserito in tutte le pagine, dove è possibile aggiungere più formatter contemporaneamente.

Esempio di formatter #

Un esempio può essere visto di seguito. Si prega di notare che questa è Clerk V2 (ultima versione):

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

Formatter multipli #

Puoi scrivere qualsiasi numero di formatter, 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;
  }
}

Uso nei design #

Dopo aver creato i tuoi formatter, puoi utilizzarli nei Designs utilizzando questa sintassi:

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

Errori comuni #

Clerk non definito #

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

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

Fai clic qui per visualizzare il processo di implementazione per l’inserimento sia dello script di Order Tracking che di Visitor Tracking.

Raffreddamento API #

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

Lightspeed ha impostato un basso rate limit di default 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. Prendi in considerazione l’upgrade del servizio di rate limit con Lightspeed.

2. In alternativa, puoi scegliere di attendere che il processo di sincronizzazione sia completato.

429 Troppe Richieste #

Questo errore indica che Lightspeed ha effettuato troppe richieste in un determinato intervallo di tempo e ha superato il suo rate limit.

Per risolvere, ti suggeriamo di regolare la dimensione della pagina nelle tue impostazioni di sincronizzazione dati 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 nella pagina del carrello o della conferma.

In Lightspeed, queste pagine utilizzano un file tema separato chiamato fixed.rain. Gli script aggiunti a custom.rain non vengono inclusi in queste pagine, quindi Clerk.js potrebbe essere assente quando si completa l’ordine — 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. Fai clic su Save.

Se Clerk.io è già presente sia in custom.rain che in fixed.rain ma gli ordini non vengono ancora 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.

Questa impostazione dipende dal tema, quindi aggiungila a Web Extras solo se i posizionamenti standard non risolvono il problema.