FAQ

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

Verwendung von Formatierern #

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

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

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

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

Beispiel-Formatierer #

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

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

Mehrere Formatierer #

Sie können beliebig viele Formatierer schreiben, durch Kommas getrennt, 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 einen Formatierer erstellt haben, rufen Sie ihn aus dem Liquid-Template Ihres Designs mit dem Namen des Formatierers auf.

Dadurch können Sie jede gewünschte Funktionalität in Ihren Designs schaffen, die Sie mit Clerk in Ihrem Webshop verwenden möchten.

Häufige Fehler #

Clerk nicht definiert #

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

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

Klicken Sie hier, um den Implementierungsprozess zum Einfügen sowohl des Order Tracking- als auch des Visitor Tracking-Skripts anzusehen.

API-Abkühlung #

Diese Meldung in den Daten-Synchronisierungsprotokollen stammt von dem Lightspeed-Rate Limit.

Lightspeed hat standardmäßig ein niedriges Rate Limit gesetzt, um das Übertragungsvolumen ihrer Dienste zu steuern.

Bitte beachten Sie, dass dieses Rate Limit nicht im Einflussbereich von Clerk liegt.

Um dies zu lösen, haben Sie zwei Möglichkeiten:

1. Überlegen Sie, das Rate Limit bei Lightspeed zu erhöhen.

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

429 Zu viele Anfragen #

Dieser Fehler bedeutet, dass Lightspeed in einem bestimmten Zeitraum zu viele Anfragen gesendet und damit das Rate Limit überschritten hat.

Um dies zu umgehen, empfehlen wir, die Seitengröße unter Ihren Data Sync Settings in 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 werden, sind auf diesen Seiten nicht enthalten, sodass Clerk.js möglicherweise fehlt, wenn die Bestellung abgeschlossen wird – was bedeutet, dass der Verkauf nie getrackt wird.

Um dies zu beheben, fügen Sie das Besucher-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 Script am Ende der Datei ein.

4. Klicken Sie auf Save.

Wenn Clerk.io sowohl in custom.rain als auch in fixed.rain bereits vorhanden ist, aber Bestellungen trotzdem nicht getrackt werden, muss Ihr Theme eventuell Clerk.js stattdessen in Web Extras laden. Gehen Sie zu Settings > Website-Settings > Web Extras, und fügen Sie das Visitor Tracking Script direkt über den Clerk.io Order Tracking Code in das Tracking-Feld ein.

Dies ist vom Theme abhängig, also fügen Sie es zu Web Extras nur hinzu, wenn die Standardplatzierungen das Problem nicht lösen.