FAQ

Haben Sie Probleme mit Ihrer Dandomain Classic-Integration? Dieses FAQ behandelt die häufigsten Probleme und deren Lösungen, von HTTP-Authentifizierung bis zu Synchronisationsfehlern.

HTTP-Authentifizierung #

HTTP-Authentifizierung wird oft auf Staging-Seiten 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 Authentifizierungsinformationen 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 Dandomain App von Clerk ist der Server Ihres Webshops dafür verantwortlich, Produkt-, Kategorien- und Verkaufsdaten an Clerk zu senden.

In manchen Fällen kann die Serverkonfiguration jedoch den Import daran hindern, auf die Daten zuzugreifen, was zu einem Fehler in Data Sync führt.

Nachfolgend finden Sie eine Liste der häufigsten Fehler und deren Lösungen.

401 Unauthorized #

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

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

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

403 Forbidden #

Dieser Fehler tritt auf, wenn Ihr Server den Zugriff des Importers blockiert.

In den meisten Fällen müssen Sie lediglich die IP-Adresse des Importers whitelisten, um den Zugriff zu ermöglichen.

Die aktuelle IP-Adresse finden Sie hier.

Überprüfen Sie außerdem, ob Ihr public key, private key und Ihre import URL für den jeweiligen Shop in my.clerk.io korrekt sind.

In manchen Fällen (wenn Sie eine ältere Dandomain-Version verwenden), wird dieser Fehler auch angezeigt, wenn Sie verschiedene Sprach-Domains mit unterschiedlichen IDs verwenden.

Stellen Sie in diesem Fall sicher, dass die IDs für jeden Shop mit denen im Dandomain-Backend übereinstimmen.

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

Es gibt einige Fälle, in denen Sie die IP-Adresse des Importers auf die Whitelist gesetzt haben, der Fehler jedoch weiterhin besteht.

In diesen Fällen empfehlen wir, folgende Punkte zu überprüfen:

• Der Authentifizierungsteil des Body könnte vom Server Ihres Shops aus der Anfrage entfernt werden.

• Rate-Limit des Servers im Zusammenhang mit Cloudflare.

404 Not Found #

Dieser Fehler tritt auf, wenn der Importer den Link, der Daten aus dem Webshop sendet, nicht erreichen konnte.

In den meisten Fällen geschieht dies, weil die App 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.

Leeren Sie anschließend unbedingt 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 aufgrund zu vieler eingehender Anfragen verweigert.

Sie können dies beheben, indem Sie das Anfrage-Limit Ihres Servers erhöhen oder die Page Size in my.clerk.io > Data > Configuration erhöhen. Eine größere Page Size sorgt dafür, dass der Importer weniger, dafür größere Anfragen sendet.

500 Internal Server Error #

Dieser Fehler bedeutet, dass Ihr Server auf einen internen Fehler gestoßen ist und nicht bestimmen konnte, welcher Fehler aufgetreten ist.

In diesen Fällen überprüfen Sie bitte Ihr Serverprotokoll, um herauszufinden, 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 falsch aufgerufenen Funktion im Webshop.

Falls Letzteres zutrifft, empfehlen wir, unseren technischen Support zu kontaktieren.

503 Service Unavailable #

Dieser Fehler ist meistens temporär und wird verursacht, wenn der Server zu ausgelastet ist, um die Anfrage zu bearbeiten.

Versuchen Sie es etwas später erneut.

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

Überprüfen Sie die Serverauslastung, um zu erkennen, 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 etwas unterschiedlich arbeiten, müssen Sie diese Schritte befolgen, um erfolgreich zu aktualisieren.

Die beiden größten Unterschiede bei Clerk.js 2 sind, dass die Designs in my.clerk.io die Liquid Template-Sprache verwenden, aber sie können auch ganz 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 Punkten beschrieben.

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

Option Design Editor #

1. Gehen Sie zu my.clerk.io > Recommendations/Search > Designs > New Design.

2. Folgen Sie dem Setup-Assistenten für das Design und wählen Sie den Typ Ihres Designs aus und geben Sie Ihrem Design einen Namen (wir empfehlen, “V2” hinzuzufügen, damit klar ist, dass Sie Clerk.js 2 verwenden).

3. Im Design Editor können Sie Elemente wie Name, Bild, Button etc. anklicken, um sie zu bearbeiten, oder neue Elemente zum Design hinzufügen, um weitere Produktinformationen bereitzustellen.

4. Klicken Sie auf Publish Design, wenn Sie fertig sind, und gehen Sie zu Schritt 2 in der Anleitung.

5. Gehen Sie zu Recommendations/Search > Elements und ändern Sie Ihr Clerk Element, um Ihr neues Design zu verwenden.

6. Klicken Sie auf Update Element. 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 zu aktualisierenden Elemente.

Jetzt sind Sie bereit, auf Clerk.js 2 zu wechseln.

Clerk.js 2 aktivieren #

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

1. Melden Sie sich in Ihrem Dandomain Classic Backend an und gehen Sie im Seitenmenü zur Clerk App.

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