FAQ

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

Utilizzo dei formattatori #

Clerk.js consente di scrivere funzioni JavaScript personalizzate che aggiungono nuove 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 configuration per Clerk.js, nello tracking-script che viene inserito su tutte le pagine, dove è possibile aggiungere più formattatori contemporaneamente.

Esempio di formattatore #

Un esempio è riportato 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);
    }
  }
});

Formattatori multipli #

Puoi scrivere qualsiasi numero di formattatori, separati da virgole, 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 i tuoi formattatori, puoi usarli 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 not defined #

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

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

Clicca qui per vedere il processo di implementazione per inserire entrambi gli script di Order Tracking e Visitor Tracking.

API cooldown #

Questo messaggio nei log della 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.

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

Per affrontare il problema, hai due opzioni:

1. Considera l’upgrade 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 certo periodo di tempo superando il proprio rate limit.

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