Häufig gestellte Fragen

Synchronisierung mit HTTP Auth #

Oft wird die HTTP-Authentifizierung auf Staging-Seiten verwendet, um ungebetene Besucher zu vermeiden.

Dies blockiert auch den Clerk-Importer und zeigt einen 401 Unauthorized-Fehler im Synchronisierungsprotokoll an.

Sie können den Importer einfach überprüfen, indem Sie die Authentifizierungsinformationen in die Import-URL wie unten eingefügt einfügen, in der Datensynchronisierung bei my.clerk.io:

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

Häufige Synchronisierungsfehler #

Beim Importieren von Daten mit der Clerk.io-DanDomain-App ist der Server des Webshops dafür verantwortlich, die Produkt-, Kategorie- und Verkaufsdaten an Clerk.io zu senden.

In einigen Fällen kann jedoch die Serverkonfiguration den Zugriff auf den Import verhindern, was einen Fehler in der Datensynchronisierung verursacht.

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

401 Serverfehler: Unautorisiert #

Dieser Fehler tritt auf, wenn Ihr Webshop-/Entwicklungsumgebung HTTP-Authentifizierung benötigt, um darauf zuzugreifen.

Dies wird einfach gelöst, indem Sie den Benutzernamen und das Passwort als Teil der Import-URL einfügen:

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

403 Serverfehler: Verboten #

Dieser Fehler tritt auf, wenn Ihr Server den Importer daran hindert, darauf zuzugreifen. In den meisten Fällen müssen Sie einfach die IP-Adresse des Importers auf die Whitelist setzen, um ihm Zugriff zu gewähren.

Die neueste IP-Adresse kann hier gefunden werden.

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

In einigen Fällen (wenn Sie sich auf einer älteren DanDomain-Version befinden) wird dieser Fehler auch angezeigt, wenn Sie verschiedene Sprachdomains verwenden und jede unterschiedliche IDs hat. Stellen Sie in diesem Fall sicher, dass die IDs für jeden Shop mit denjenigen in Ihrem DanDomain-Backend übereinstimmen.

Was ist, wenn ich bereits auf die Whitelist gesetzt habe, aber der gleiche Fehler weiterhin auftritt?

Es gibt einige Fälle, in denen Sie die IP-Adresse des Importers auf die Whitelist gesetzt haben und der Fehler weiterhin besteht. In diesem Fall empfehlen wir, diese Punkte zu überprüfen:

• Der Authentifizierungsbereich des Körpers könnte aus der Anfrage des Shop-Servers entfernt worden sein.

• Die Rate-Limitierung für den Server in Bezug auf Cloudflares.

404 Serverfehler: Nicht gefunden #

Dieser Fehler tritt auf, wenn der Importer nicht auf den Link zugreifen konnte, der uns Daten vom Webshop sendet. In den meisten Fällen geschieht dies, weil die Erweiterung 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.

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

429 Serverfehler: Zu viele Anfragen #

Dieser Fehler tritt auf, wenn Ihr Server dem Importer den Zugriff aufgrund zu vieler eingehender Anfragen verweigert.

Sie können dies beheben, indem Sie das Anforderungs-Limit für Ihren Server erhöhen oder die Seitenanzahl in der Clerk.io Importer auf einen höheren Wert setzen, wodurch der Importer weniger, größere Anfragen stellt:

500 Interner Serverfehler #

Dieser Fehler bedeutet, dass Ihr Server auf einen internen Fehler gestoßen ist und nicht in der Lage war, anzugeben, welcher Fehler aufgetreten ist.

In diesen Fällen können Sie Ihr Serverprotokoll überprüfen, um zu identifizieren, 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. Wenn Letzteres der Fall ist, empfehlen wir, unser technisches Support-Team für diesen Teil zu kontaktieren.

503 Serverfehler: Dienst nicht verfügbar #

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

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

Überprüfen Sie die Serverlast, 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 auf jedem Webshop zum Kinderspiel macht.

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

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

Schritt 1: Designs konvertieren #

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:

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

• 2. Konvertieren Sie Ihre alten Designs. Befolgen Sie diesen Leitfaden, um zu sehen, wie es 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 Design-Einrichtungsassistenten und wählen Sie Ihren Design-Typ aus und geben Sie Ihrem Design einen N amen (wir empfehlen, " V2" hinzuzufügen, damit 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 neue Elemente zum Design hinzu, um weitere Informationen zu Produkten hinzuzufügen.

1.4. Klicken Sie auf Design veröffentlichen, wenn Sie fertig sind, und gehen Sie zu Schritt 2 im Leitfaden.

1.5. Gehen Sie schließlich zu Empfehlungen / Suche -> Inhalt und ändern Sie Ihren Clerk.io Inhalt, um Ihr neues Design zu verwenden.

1.6. Klicken Sie auf Inhalt aktualisieren. Dies wird vorübergehend dazu führen, dass sie nicht auf Ihrem Webshop angezeigt werden, bis Sie mit Schritt 2 fertig sind. Wählen Sie das neue Design für alle Inhalte aus, die aktualisiert werden sollen.

1.9. Da! Sie sind jetzt bereit, auf Clerk.js 2 umzuschalten.

Schritt 2: Wechseln 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. Melden Sie sich in Ihrem DanDomain Classic-Backend an und gehen Sie zur Clerk.io App im Seitenmenü.

2.2. Klicken Sie unter Allgemein und aktivieren Sie das Kontrollkästchen neben Brug Clerk.js 2 und klicken Sie auf Speichern: