FAQ

Haben Sie Probleme mit Ihrer Lightspeed-Integration? Diese FAQ behandelt die häufigsten Probleme und deren Lösungen, von Formatierern bis zu Synchronisationsfehlern.

Verwendung von Formatierern #

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

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

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

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

Beispiel-Formatter #

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

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

Mehrere Formatierer #

Sie können beliebig viele Formatierer schreiben, getrennt durch Kommas, so wie hier:

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 Sie Ihre Formatierer erstellt haben, können Sie diese in Designs mit dieser Syntax verwenden:

Damit können Sie jede gewünschte Funktionalität in Ihren Designs erstellen, die Sie mit Clerk in Ihrem Webshop nutzen möchten.

Häufige Fehler #

Clerk nicht definiert #

Wenn Sie diese Fehlermeldung sehen, bedeutet dies, dass Clerk auf der Website nicht definiert wird.

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

Klicken Sie hier, um den Implementierungsprozess für das Einfügen sowohl des Order Tracking- als auch des Visitor Tracking-Skripts zu sehen.

API-Abkühlung #

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

Lightspeed hat standardmäßig ein niedriges Rate Limit festgelegt, um das Datenvolumen von deren Diensten zu verwalten.

Bitte beachten Sie, dass dieses Rate Limit außerhalb von Clerk’s Kontrolle liegt.

Um dieses Problem zu beheben, haben Sie zwei Optionen:

1. Erwägen Sie, den Rate-Limit-Service bei Lightspeed zu erhöhen.

2. Alternativ können Sie abwarten, bis der Synchronisierungsprozess abgeschlossen ist.

429 Too Many Requests #

Dieser Fehler bedeutet, dass Lightspeed zu viele Anfragen innerhalb eines bestimmten Zeitraums gestellt und damit sein Rate Limit überschritten hat.

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

Bestellungen werden nicht getrackt #

Wenn Bestellungen in Clerk.io nicht getrackt werden, könnte es daran liegen, dass Clerk.js auf der Warenkorb- oder Dankeseite nicht geladen wird.

In Lightspeed verwenden diese Seiten eine separate Theme-Datei namens fixed.rain. Skripte, die zu custom.rain hinzugefügt wurden, sind auf diesen Seiten nicht enthalten, daher kann es sein, dass Clerk.js beim Abschluss der Bestellung fehlt – was bedeutet, dass der Verkauf nie getrackt wird.

Um das zu beheben, fügen Sie das Visitor Tracking Skript auch zu fixed.rain hinzu:

1. Gehen Sie in Ihrem Lightspeed-Backend zu Design > Theme Editor > Advanced > Edit Code.

2. Öffnen Sie layouts > fixed.rain.

3. Fügen Sie das Visitor Tracking Skript am unteren Ende der Datei ein.

4. Klicken Sie auf Save.

Wenn Clerk.io bereits sowohl in custom.rain als auch in fixed.rain vorhanden ist, Bestellungen jedoch weiterhin nicht getrackt werden, benötigt Ihr Theme möglicherweise Clerk.js stattdessen in Web Extras. Gehen Sie zu Settings > Website-Settings > Web Extras, und fügen Sie anschließend das Visitor Tracking Skript direkt über dem Clerk.io Order Tracking Code in das Tracking-Feld ein.

Das ist vom Theme abhängig, daher sollte es nur in Web Extras eingefügt werden, wenn die Standardplatzierungen das Problem nicht lösen.