FAQ
Probleme mit Ihrer Dandomain Classic-Integration? In dieser FAQ finden Sie die häufigsten Probleme und deren Lösungen, von HTTP-Authentifizierung bis hin zu Synchronisationsfehlern.
HTTP-Authentifizierung #
Die HTTP-Authentifizierung wird häufig auf Staging-Websites verwendet, um unerwünschte Besucher fernzuhalten.
Dies blockiert den Clerk-Importer und zeigt einen 401 Unauthorized-Fehler im Synchronisationsprotokoll an.
Sie können dies beheben, indem Sie die Authentifizierungsdaten in die Import-URL einfügen.
In my.clerk.io > Data > Configuration aktualisieren Sie Ihre Import-URL wie folgt:
https://USER:PASS@dandomain.clerk.io/api/6155349/28
Häufige Synchronisationsfehler #
Beim Importieren von Daten mit der Clerk Dandomain App ist der Server Ihres Webshops dafür verantwortlich, Produkt-, Kategorie- und Verkaufsdaten an Clerk zu senden.
In einigen Fällen kann jedoch die Konfiguration des Servers den Import blockieren und einen Fehler bei der Data Sync verursachen.
Nachfolgend finden Sie eine Liste der häufigsten Fehler und deren Behebung.
401 Unauthorized #
Dieser Fehler tritt auf, wenn Ihr Webshop oder die Entwicklungsumgebung eine HTTP-Authentifizierung benötigt, um darauf zuzugreifen.
Dies wird gelöst, indem der Benutzername und das Passwort als Teil der Import-URL eingefügt werden:
http://USER:PASS@dandomain.clerk.io/api/6155349/28
403 Forbidden #
Dieser Fehler tritt auf, wenn Ihr Server den Importer am Zugriff hindert.
In den meisten Fällen müssen Sie einfach die IP-Adresse des Importers auf die Whitelist setzen, um den Zugriff zu ermöglichen.
Die aktuellste IP-Adresse finden Sie hier.
Überprüfen Sie außerdem, ob Ihr public key, private key und Import-URL für den Shop korrekt sind, den Sie in my.clerk.io verwenden.
In einigen Fällen (wenn Sie eine ältere Dandomain-Version nutzen) wird dieser Fehler ebenfalls angezeigt, wenn Sie verschiedene Sprachdomains mit unterschiedlichen IDs verwenden.
Stellen Sie in diesem Fall sicher, dass die IDs der Shops denen in Ihrem Dandomain-Backend entsprechen.
Was, wenn ich bereits auf die Whitelist gesetzt habe, der Fehler aber dennoch auftritt?
Es gibt einige Fälle, in denen Sie die IP-Adresse des Importers auf die Whitelist gesetzt haben, der Fehler aber weiterhin besteht.
In diesen Fällen empfehlen wir, auf Folgendes zu achten:
Der Authentifizierungsteil des Bodys könnte von der Anfrage durch den Server Ihres Shops entfernt werden.
Rate-Limit des Servers in Bezug auf Cloudflare.
404 Not Found #
Dieser Fehler tritt auf, wenn der Importer den Link, über den die Daten vom Webshop gesendet werden, nicht erreichen konnte.
In den meisten Fällen liegt es daran, dass die App entweder:
Überhaupt nicht installiert ist
Ein Cache dazu führt, dass der Link nicht initialisiert wird
Stellen Sie zunächst sicher, dass Sie die App korrekt installiert haben.
Leeren Sie danach den Cache Ihres Webshops, bevor Sie einen neuen Import versuchen.
429 Too Many Requests #
Dieser Fehler tritt auf, wenn Ihr Server dem Importer den Zugriff wegen zu vieler eingehender Anfragen verweigert.
Sie können dies beheben, indem Sie das Request-Limit für Ihren Server erhöhen oder die Page Size auf einen höheren Wert in my.clerk.io > Data > Configuration setzen. Dadurch macht der Importer weniger, aber größere Anfragen:
500 Internal Server Error #
Dieser Fehler bedeutet, dass Ihr Server auf einen internen Fehler gestoßen ist und nicht angeben konnte, welcher Fehler aufgetreten ist.
Überprüfen Sie in diesen Fällen Ihr Server Log, um zu erkennen, welcher Prozess abgestürzt ist und warum.
In den meisten Fällen liegt es einfach an einem Produkt mit einem ungültigen Attribut oder einer Funktion, die im Webshop falsch aufgerufen wird.
Falls Letzteres der Fall ist, empfehlen wir, sich an unser technisches Support-Team zu wenden.
503 Service Unavailable #
Dieser Fehler ist meist temporär und tritt auf, wenn der Server zu ausgelastet ist, um die Anfrage zu bearbeiten.
Versuchen Sie es später erneut.
Wenn das Problem weiterhin besteht, könnte dies bedeuten, dass der Server überlastet ist und sich seiner maximalen Kapazität nähert.
Überprüfen Sie die Serverauslastung, um festzustellen, ob dies der Fall ist.
Upgrade auf Clerk.js 2 #
Clerk.js 2 ist eine schnellere und flexiblere Version unserer JavaScript-Bibliothek.
Es macht die Installation von Clerk auf jedem Webshop einfacher.
Da die beiden Versionen jedoch leicht unterschiedlich arbeiten, müssen Sie diese Schritte befolgen, um das Upgrade erfolgreich durchzuführen.
Die beiden Hauptunterschiede in Clerk.js 2 sind, dass die Designs in my.clerk.io die Liquid-Templating-Sprache verwenden, aber sie können auch einfach mit dem Design Editor erstellt werden.
Designs erstellen #
Da Clerk.js 2 einen anderen Ansatz für Designs hat, müssen Sie neue erstellen.
Sie können Ihre Clerk.js 2 Designs auf zwei Arten erstellen:
Verwenden Sie den intuitiven Design Editor, um neue Designs zu erstellen, wie in den folgenden Schritten beschrieben.
Konvertieren Sie Ihre alten Designs. Folgen Sie dieser Anleitung, um zu sehen, wie es geht.
Option Design Editor #
- Gehen Sie zu my.clerk.io > Recommendations/Search > Designs > New Design.
Folgen Sie dem Design-Setup-Wizard, wählen Sie den Typ Ihres Designs und geben Sie ihm einen Namen (wir empfehlen, “V2” hinzuzufügen, damit ersichtlich ist, dass Sie Clerk.js 2 verwenden).
Klicken Sie im Design Editor auf eines der vorhandenen Elemente wie Name, Bild, Button usw., um es zu bearbeiten oder fügen Sie neue Elemente zum Design hinzu, um weitere Informationen zu Produkten anzuzeigen.
Klicken Sie auf Publish Design, wenn Sie fertig sind, und fahren Sie mit Schritt 2 in der Anleitung fort.
Gehen Sie zu Recommendations/Search > Content und ändern Sie Ihren Clerk Content, sodass Ihr neues Design verwendet wird.
Klicken Sie auf Update Content. Dadurch werden sie vorübergehend nicht in Ihrem Webshop angezeigt, bis Sie mit Schritt 2 fertig sind. Wählen Sie das neue Design für alle Content, der aktualisiert werden soll.
Sie sind nun bereit, auf Clerk.js 2 umzusteigen.
Clerk.js 2 aktivieren #
Als Nächstes müssen Sie Clerk.js 2 in der Dandomain Classic App aktivieren.
Loggen Sie sich in Ihr Dandomain Classic Backend ein und gehen Sie im Seitenmenü zur Clerk App.
Unter General klicken und das Kästchen neben Brug Clerk.js 2 ankreuzen und auf Save klicken:
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.