FAQ

Støder du på problemer med din Lightspeed-integration? Denne FAQ dækker de mest almindelige problemer og deres løsninger, fra formatters til synkroniseringsfejl.

Brug af formatters #

Clerk.js giver dig mulighed for at skrive brugerdefinerede JavaScript-funktioner, der tilføjer ny funktionalitet til dine Designs.

Formatters kan tilføjes på to måder:

• Gennem my.clerk.io > Developers > Formatters, hvor hver Formatter kan oprettes som separate poster.

• Som en konfiguration for Clerk.js i tracking-scriptet, der indsættes på alle sider, hvor flere formatters kan tilføjes på én gang.

Eksempel på formatter #

Et eksempel kan ses nedenfor. Bemærk venligst, at dette er Clerk V2 (seneste version):

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

Flere formatters #

Du kan skrive et vilkårligt antal formatters, adskilt med komma, sådan her:

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;
  }
}

Brug i designs #

Efter oprettelse af en formatter kan du kalde den fra dit Designs Liquid-skabelon ved at bruge formatterens navn.

Dette giver dig mulighed for at oprette enhver funktionalitet i dine Designs, som du ønsker at bruge med Clerk i din webshop.

Almindelige fejl #

Clerk not defined #

Hvis du ser denne fejlmeddelelse, betyder det, at Clerk ikke bliver defineret på websitet.

Den mest almindelige årsag til dette er, at Clerk tracking-scripts ikke er implementeret de relevante steder.

Klik her for at se implementeringsprocessen for indsættelse af både Order Tracking og Visitor Tracking scripts.

API cooldown #

Denne besked i data sync logs kommer fra Lightspeed rate limit.

Lightspeed har som standard sat en lav rate limit for at styre mængden af data, der overføres fra deres tjenester.

Bemærk, at denne rate limit ikke er inden for Clerks kontrol.

For at løse dette har du to muligheder:

1. Overvej at opgradere rate limit-tjenesten hos Lightspeed.

2. Alternativt kan du vælge at vente på, at synkroniseringsprocessen afsluttes.

429 Too Many Requests #

Denne fejl betyder, at Lightspeed har lavet for mange forespørgsler inden for et givet tidsrum og har overskredet deres rate limit.

For at løse dette foreslår vi, at du justerer sidestørrelsen under dine data sync settings i my.clerk.io > Data > Configuration.

Ordrer spores ikke #

Hvis ordrer ikke spores i Clerk.io, kan det skyldes, at Clerk.js ikke indlæses på indkøbskurv- eller takkesiden.

I Lightspeed anvender disse sider en separat tema-fil kaldet fixed.rain. Scripts tilføjet til custom.rain er ikke inkluderet på disse sider, så Clerk.js kan mangle, når ordren færdiggøres – hvilket betyder, at salget aldrig spores.

For at løse dette skal du også tilføje visitor tracking-scriptet til fixed.rain:

1. Gå i din Lightspeed backend til Design > Theme Editor > Advanced > Edit Code.

2. Åbn layouts > fixed.rain.

3. Indsæt visitor tracking-scriptet nederst i filen.

4. Klik på Save.

Hvis Clerk.io allerede er til stede i både custom.rain og fixed.rain, men ordrer stadig ikke spores, kan dit tema have brug for Clerk.js i Web Extras i stedet. Gå til Settings > Website-Settings > Web Extras, og indsæt derefter visitor tracking-scriptet umiddelbart over Clerk.io order tracking-koden i Tracking-boksen.

Det er temaafhængigt, så tilføj det kun til Web Extras, hvis de almindelige placeringer ikke løser problemet.