FAQ

Probleme mit deiner Lightspeed-Integration? Dieses FAQ behandelt die häufigsten Probleme und deren Lösungen, von Formatierern bis hin zu Synchronisierungsfehlern.

Verwendung von Formatierern #

Clerk.js ermöglicht es dir, benutzerdefinierte JavaScript-Funktionen zu schreiben, die neue Funktionalitäten zu deinen Designs hinzufügen.

Formatierer können auf zwei Arten hinzugefügt werden:

• Über my.clerk.io > Developers > Formatters, wobei jeder Formatierer als separater Eintrag erstellt werden kann.

• Als Konfiguration für Clerk.js, im tracking-script, das auf allen Seiten eingefügt ist, wobei mehrere Formatierer gleichzeitig hinzugefügt werden können.

Beispiel-Formatierer #

Ein Beispiel ist unten zu sehen. Bitte beachte, dass dies Clerk V2 (neueste Version) ist:

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

Mehrere Formatierer #

Du kannst beliebig viele Formatierer schreiben, getrennt durch Kommas, zum Beispiel so:

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

Verwendung in Designs #

Nachdem du deine Formatierer erstellt hast, kannst du sie in Designs mit dieser Syntax verwenden:

So kannst du jede gewünschte Funktionalität in deinen Designs erstellen, die du mit Clerk in deinem Webshop nutzen möchtest.

Häufige Fehler #

Clerk not defined #

Wenn diese Fehlermeldung erscheint, bedeutet das, dass Clerk auf der Webseite nicht definiert ist.

Die häufigste Ursache dafür ist, dass die Clerk-Tracking-Skripte nicht an den richtigen Stellen implementiert wurden.

Klicke hier, um dir den Implementierungsprozess für das Einfügen sowohl des Order Tracking- als auch des Visitor Tracking-Skripts anzusehen.

API cooldown #

Diese Meldung in den Data Sync Logs stammt von dem Lightspeed-Rate-Limit.

Lightspeed hat standardmäßig ein niedriges Rate-Limit festgelegt, um das übertragene Datenvolumen ihrer Services zu steuern.

Bitte beachte, dass dieses Rate-Limit nicht im Einflussbereich von Clerk liegt.

Um das zu lösen, hast du zwei Optionen:

1. Ziehe in Betracht, das Rate-Limit bei Lightspeed zu erhöhen.

2. Alternativ kannst du abwarten, bis der Synchronisierungsprozess abgeschlossen ist.

429 Too Many Requests #

Dieser Fehler bedeutet, dass Lightspeed zu viele Anfragen in kurzer Zeit gestellt und somit sein Rate-Limit überschritten hat.

Um das zu beheben, empfehlen wir, die Seitengröße unter deinen Data Sync Settings in my.clerk.io > Data > Configuration anzupassen.

Fehlende Einbindung beim Checkout #

In Lightspeed verwenden der Warenkorb und die Dankeseite eine separate Theme-Datei namens fixed.rain. Skripte, die zu custom.rain hinzugefügt werden, sind auf diesen Seiten nicht enthalten.

Wenn Clerk.js auf der Warenkorb- oder Dankeseite nicht geladen wird, besteht die Lösung darin, das Visitor Tracking Script auch in fixed.rain einzufügen.

1. Gehe im Lightspeed-Backend zu Design > Theme Editor > Advanced > Edit Code.

2. Öffne layouts > fixed.rain.

3. Füge das Visitor Tracking Script am Ende der Datei ein.

4. Klicke auf Save.