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 unter my.clerk.io:

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

Häufige Synchronisierungsfehler #

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

In einigen Fällen könnte jedoch die Serverkonfiguration den Zugriff auf den Import verhindern, was einen Fehler in Data Sync verursacht.

Unten 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 für den Shop, in dem Sie arbeiten, korrekt sind unter my.clerk.io.

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

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 Authentifizierungsteil 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 verhindert, dass der Link 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 auf einen höheren Wert im Clerk.io Importer 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 an 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 erneut.

Wenn das Problem weiterhin auftritt, könnte es bedeuten, dass der Server mit Prozessen überlastet ist und sich der 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 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 sind, 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-Setup-Assistenten und wählen Sie Ihren Design-Typ aus und geben Sie Ihrem Design einen N amen (wir empfehlen, " V2" hinzuzufügen, 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 neue Elemente zum Design hinzu, um weitere Informationen über Produkte 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 zuletzt 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, zu Clerk.js 2 zu wechseln.

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. 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 Verwenden Sie Clerk.js 2 und klicken Sie auf Speichern: