FAQ

Synchronisierung mit HTTP-Authentifizierung #

Häufig wird die HTTP-Authentifizierung auf Staging-Sites verwendet, um ungebetene Besucher zu vermeiden.

Dadurch wird auch der Clerk-Importer blockiert und im Synchronisierungsprotokoll wird der Fehler 401 Unberechtigt angezeigt.

Sie können den Importer leicht überprüfen, indem Sie die Authentifizierungsinformationen in die Import-URL einfügen, wie unten, in Data Sync unter my.clerk.io:

https://USER:OASS@dandomain.clerk.io/api/6155349/28

Häufige Synchronisationsfehler #

Beim Datenimport mit der DanDomain App von Clerk.io ist der Webshop-Server für das Senden der Produkt-, Kategorie- und Verkaufsdaten an Clerk.io. verantwortlich.

In einigen Fällen kann es jedoch vorkommen, dass die Serverkonfiguration den Zugriff auf den Import verhindert, was zu einem Fehler in Data Sync. führt.

Nachfolgend finden Sie eine Liste der häufigsten Fehler und wie Sie diese beheben können.

401 Server-Fehler: Nicht autorisiert #

Dieser Fehler tritt auf, wenn Ihr Webshop/Ihre Entwicklungsumgebung eine HTTP-Authentifizierung für den Zugriff erfordert.

Dies wird einfach durch Einfügen von Benutzername und Passwort als Teil der Import-URL gelöst:

http://USER:PASS@dandomain.clerk.io/api/6155349/28

403 Server-Fehler: Forbidden #

Dieser Fehler tritt auf, wenn Ihr Server den Zugriff des Importeurs blockiert. In den meisten Fällen müssen Sie einfach die IP-Adresse des Importeurs auf eine Whitelist setzen, um ihm den Zugriff zu ermöglichen.

Die aktuelle IP-Adresse finden Sie hier.

Überprüfen Sie auch, ob Ihr öffentlicher Schlüssel, Ihr privater Schlüssel und Ihre Import-URL für den Shop, den Sie auf my.clerk.io betreiben, korrekt sind.

In einigen Fällen (wenn Sie eine ältere Dandomain-Version verwenden) wird dieser Fehler auch angezeigt, wenn Sie verschiedene Sprach-Domains verwenden und diese unterschiedliche IDs haben. Stellen Sie in diesem Fall sicher, dass die IDs der einzelnen Shops mit denen in Ihrem Dandomain-Backend übereinstimmen.

**Was ist, wenn ich bereits auf der Whitelist bin, aber der gleiche Fehler immer noch auftritt?

Es gibt einige Fälle, in denen Sie die IP-Adresse des Importeurs bereits auf die Whitelist gesetzt haben, der Fehler aber immer noch auftritt:

• Der Authentifizierungsteil des Body kann aus der Anfrage vom Server des Shops entfernt werden.

• Ratenlimit für den Server in Bezug auf Cloudflares.

404 Serverfehler: Nicht gefunden #

Dieser Fehler tritt auf, wenn der Importeur nicht auf den Link zugreifen konnte, der uns Daten aus dem Webshop sendet. In den meisten Fällen geschieht dies, weil die Erweiterung entweder:

• gar nicht installiert ist

• Ein Cache führt dazu, dass der Link nicht initialisiert werden kann

Vergewissern Sie sich zunächst, dass Sie die Anwendung korrekt installiert haben

Zweitens sollten Sie den Cache Ihres Webshops leeren, bevor Sie einen neuen Import versuchen.

429 Serverfehler: Zu viele Requests #

Dieser Fehler tritt auf, wenn Ihr Server dem Importeur den Zugriff verweigert, weil zu viele Anfragen eingehen.

Sie können dies beheben, indem Sie das Request-Limit für Ihren Server höher setzen oder indem Sie Page Size im Clerk.io importer auf einen höheren Wert setzen, so dass der Importer weniger und größere Anfragen stellt:

500 Interner Serverfehler #

Dieser Fehler bedeutet, dass Ihr Server auf einen internen Fehler gestoßen ist und Sie nicht in der Lage waren, den Fehler zu spezifizieren.

In diesen Fällen können Sie Ihr Server Log überprüfen, um festzustellen, welcher Prozess abgestürzt ist und warum. In den meisten Fällen liegt es an einem Produkt mit einem ungültigen Attribut oder an einer Funktion, die im Webshop falsch aufgerufen wird. Sollte letzteres der Fall sein, empfehlen wir Ihnen, sich mit unserem technischen Support in Verbindung zu setzen.

503 Server-Fehler: Dienst nicht verfügbar #

Dieser Fehler ist normalerweise vorübergehend und wird dadurch verursacht, dass der Server zu beschäftigt ist, um die Anfrage zu bearbeiten. Versuchen Sie es etwas später noch einmal.

Wenn das Problem weiterhin auftritt, könnte dies bedeuten, dass der Server mit Prozessen überlastet ist und sich nahe der maximalen Kapazität befindet.

Überprüfen Sie die Serverauslastung, um festzustellen, ob dies der Fall ist.

Upgrade auf Clerk.js 2 #

Clerk.js 2 ist eine schnellere und viel flexiblere Version unserer JavaScript-Bibliothek, die die Installation von Clerk.io in jedem Webshop zu einem Kinderspiel macht.

Da die beiden Versionen jedoch leicht unterschiedlich funktionieren, müssen Sie die folgenden Schritte befolgen, um das Upgrade erfolgreich durchzuführen.

Die beiden Hauptunterschiede in Clerk.js 2 bestehen darin, dass die Designs in my.clerk.io die Liquid Schablonensprache verwenden, aber auch einfach mit dem Design Editor erstellt werden können.

Schritt 1: Konvertieren von Designs #

Da Clerk.js 2 einen anderen Ansatz hat, müssen Sie neue Designs erstellen.

Sie können Ihre Clerk.js 2 Designs auf eine von zwei Arten erstellen:

• 1. Verwenden Sie den intuitiven Design Editor, um neue Designs zu erstellen, wie in den folgenden Punkten beschrieben.

• 2. Konvertieren Sie Ihre alten Designs. Folgen Sie dieser Anleitung, um zu sehen, wie das geht.

1.1 Beginnen Sie, indem Sie zu my.clerk.io -> Empfehlungen / Suche -> Designs gehen und auf Neues Design: klicken.

1.2 Folgen Sie dem Einrichtungsassistenten und wählen Sie Ihren Typ und geben Sie Ihrem Entwurf einen n Namen (wir empfehlen den Zusatz “V2”, damit es offensichtlich ist, dass Sie Clerk.js2 verwenden).

1.3. Klicken Sie im Design-Editor auf eines der vorhandenen Elemente wie den Namen, das Bild, die Schaltfläche usw., um es zu bearbeiten, oder fügen Sie dem Design neue Elemente hinzu, um weitere Informationen über die Produkte hinzuzufügen.

1.5. Zum Schluss gehen Sie zu Empfehlungen / Suche -> Inhalt und ändern Sie Ihren Clerk.io Inhalt, um Ihr neues Design zu verwenden.

1.6. Klicken Sie auf Inhalte aktualisieren. 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 Inhalte, die aktualisiert werden sollen.

1.9. So! Sie sind jetzt bereit, auf Clerk.js 2 umzusteigen.

Schritt 2: Wechsel zu Clerk.js 2 in der DanDomain App #

Als nächstes müssen Sie Clerk.js 2 in der DanDomain Classic App aktivieren.

2.1. Loggen Sie sich in Ihr DanDomain Classic Backend ein und gehen Sie zur Clerk.io App im Sidemenu.

2.2. Unter Allgemein klicken Sie auf das Kästchen neben Brug Clerk.js 2 und klicken Sie auf Speichern: