FAQ

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

Utilizzo dei formattatori #

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

I formattatori possono essere aggiunti in due modi:

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

• Come configurazione di Clerk.js, nello tracking-script che viene inserito in tutte le pagine, dove possono essere aggiunti più formattatori contemporaneamente.

Esempio di formatter #

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

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

Formatter multipli #

Puoi scrivere qualsiasi numero di formattatori, separati da 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 design #

Dopo aver creato i tuoi formattatori, puoi usarli nei Designs usando questa sintassi:

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

Errori comuni #

Clerk non definito #

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

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

Clicca qui per visualizzare il processo di implementazione per l’inserimento sia degli script di Order Tracking che di Visitor Tracking.

Raffreddamento API #

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

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

Si prega di notare che questo rate limit non è sotto il controllo di Clerk.

Per risolvere questo problema, hai due opzioni:

1. Prendi in considerazione l’aggiornamento del servizio di rate limit con Lightspeed.

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

429 Troppe richieste #

Questo errore significa che Lightspeed ha effettuato troppe richieste in un determinato lasso di tempo e ha superato il proprio rate limit.

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

Mancante nel checkout #

In Lightspeed, le pagine carrello e thank-you usano un file tema separato chiamato fixed.rain. Gli script aggiunti a custom.rain non sono inclusi in queste pagine.

Se Clerk.js non si carica nella pagina del carrello o in quella di ringraziamento, la soluzione è aggiungere anche lo script di visitor tracking a fixed.rain.

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

2. Apri layouts > fixed.rain.

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

4. Clicca su Save.