Sync

Starten einer Synchronisierung #

Du kannst jederzeit eine vollständige Synchronisierung von my.clerk.io aus starten, indem du zu Data > Configuration gehst und auf Start New Data Sync klickst.

Dadurch werden alle neuesten Daten aus deinem Webshop importiert, mit der von dir ausgewählten Synchronisierungsmethode.

Informationen #

Dieser Abschnitt bietet schnelle Einblicke in den Status deiner Synchronisierung:

• Die Anzahl der importierten Produkte, Kategorien, Seiten, Bestellungen und Kunden
• Zeitstempel für den letzten Versuch sowie Abschluss einer Synchronisierung oder Analyse
• Zeitstempel, wann bei einer Synchronisierung oder Analyse zuletzt eine Änderung an einem Produkt registriert wurde

Die Sync-Details beziehen sich darauf, wann Clerk zuletzt Daten aus dem Webshop abgerufen hat, während sich die Analyse-Details auf den Zeitpunkt beziehen, zu dem Clerk die Daten zuletzt verarbeitet und gespeichert hat.

Einstellungen #

Diese Einstellungen ermöglichen es dir, die Datensynchronisierung so zu konfigurieren, dass Zugriff auf den Webshop besteht und Anpassungen vorgenommen werden, wie die Daten abgerufen werden.

Synchronisationsmethode #

Clerk verfügt über eine Reihe von Integrationen und Synchronisationsmethoden, sodass ein Datenabgleich von jeder eCommerce-Plattform möglich ist. Unsere selbst entwickelten Integrationen nutzen jeweils ihre eigene Methode für Plattformen wie Shopify, Magento, WooCommerce usw.

Es ist außerdem möglich, Demo Data als Synchronisationsmethode auszuwählen. Damit synchronisiert Clerk einen vordefinierten Datensatz, den du zu Testzwecken verwenden kannst. Das ist nützlich, wenn du dich erstmal in my.clerk.io und unserer API umschauen möchtest, bevor du ein echtes Setup startest.

Synchronisationszeit #

Mit dieser Einstellung kannst du festlegen, zu welchen 1-stündigen Zeitfenstern die Synchronisierung laufen soll. Bei Auswahl eines Zeitpunktes läuft die Synchronisierung nur in diesem Zeitraum (UTC-Zeit). Das ist hilfreich, wenn du Serverkapazität während Stoßzeiten sparen und nur außerhalb synchronisieren willst.

Standardmäßig ist Bei Bedarf (Empfohlen) eingestellt, wodurch die Synchronisierung regelmäßig entsprechend der Dauer des Datenladens durchgeführt wird. Dauert es unter 10 Minuten, findet sie ggf. stündlich statt, dauern Synchronisierungen über 60 Minuten, findet sie eventuell nur einmal täglich statt.

Import #

Du kannst genau festlegen, welche Datenpunkte importiert werden, indem du für jeden Punkt Ja oder Nein auswählst:

• Produkte
• Kategorien
• Bestellungen
• Kunden
• Seiten

Clerk benötigt Produkte und Kategorien, um korrekt zu funktionieren, und es wird dringend empfohlen, auch Bestellungen zu importieren, da diese die Haupttriebkraft für Clerks Ergebnisse sind.

Seiten, die per Datensynchronisierung importiert werden, überschreiben bei der nächsten Synchronisierung alle Änderungen, die in my.clerk.io an diesen synchronisierten Seiten vorgenommen wurden.

Seiten, die du manuell unter Data > Pages hochlädst, werden als geschützt behandelt und nicht durch die Synchronisierung überschrieben.

KI-Importer #

KI-Importer ermöglichen es dir, eine individuelle Integration selbst zu erstellen – ohne vordefinierte Konfiguration. Wenn deine Plattform eine API bereitstellt, kann Clerk.io eine Verbindung herstellen.

Das Setup läuft über Ask Clerk.io ab. Beschreibe, mit welcher Plattform du dich verbinden möchtest und Ask Clerk.io führt dich durch die Authentifizierung, baut den Importer, testet die Verbindung und übergibt alles als vollständige Konfiguration an Data Sync.

KI-Importer sind eigenständige Integrationen. Falls dein Shop beispielsweise auf Shopify läuft und du zusätzliche Daten importieren willst, die vom Standard-Shopify-Importer nicht abgedeckt werden, richtest du einen neuen KI-Importer ein, der direkt mit Shopify kommuniziert.

Dieser KI-Importer übernimmt dann alles: sowohl Standarddaten als auch alle Zusatzfelder, die du benötigst.

Sobald die Verbindung besteht, kannst du steuern, was importiert wird — zusätzliche Attribute hinzufügen, Daten von Drittanbieter-Integrationen einbinden oder die Logik an deinen Katalog anpassen — alles mit Ask Clerk.io.

Mehr zum Setup findest du unter AI Importer.

Mehrere Importeure #

Mit mehreren Importeuren kannst du verschiedene Synchronisationsmethoden für unterschiedliche Datentypen im selben Shop-Setup kombinieren.

Das ist hilfreich, wenn deine Daten an verschiedenen Orten gespeichert sind. Du importierst z.B. Produkte, Kategorien und Bestellungen aus Magento 1, während Kundendaten von einer Segmentierungsplattform und Seiten aus WordPress kommen.

Jeder Datentyp wird jeweils von einem Importer verarbeitet — du kannst denselben Typ nicht von zwei Quellen gleichzeitig importieren. Aber du hast volle Kontrolle, welcher Importer für welchen Typ zuständig ist.

Gehe zu Data > Configuration und nutze den Button + Add importer, um eine zweite Synchronisationsmethode neben der bestehenden hinzuzufügen.

Für jeden Importer kannst du einstellen, welche Datentypen er importieren soll. Wird ein Datentyp einem Importer zugewiesen, darf er nicht zusätzlich in einem anderen aktiviert werden — jeder Typ benötigt genau eine Quelle.

Produkte und Kategorien sind erforderlich, damit Clerk.io korrekt funktioniert. Stelle sicher, dass mindestens ein Importer für jeden dieser Typen zuständig ist.

Synchronisierungsprotokoll #

Dieser Abschnitt zeigt dir den Status der Synchronisierung während ihres Ablaufs und nach Abschluss. Das ist hilfreich, um zu bestätigen, dass alles reibungslos läuft und unterstützt dich bei der Fehlerbehebung, sollten Probleme auftreten.

Du erreichst das Protokoll über einen Klick auf Show latest sync log details.

Whitelisting der IP-Adresse #

Wenn auf deinem Server ein IP-Lock aktiv ist, musst du die IP-Adresse des Data Sync-Systems von Clerk auf die Whitelist setzen, um auf deine Daten zugreifen zu lassen.

Die IP-Adresse lautet 52.57.0.11

Diese IP kann sich ändern. Sollte Data Sync mit Fehler 403 oder ähnlichem antworten, schaue einfach auf dieser Seite nach der aktuellen Adresse.

Echtzeit-Updates #

Das ist die beste Möglichkeit, Clerk ohne Verzögerung immer aktuell mit deinem Webshop zu halten. Während die vollständige Datensynchronisierung ideal für große Mengen in regelmäßigen Abständen ist, dienen Echtzeit-Updates dazu, kleinere Änderungen direkt zu übertragen.

Die meisten unserer Extensions und Integrationen unterstützen diese Funktion ohne weitere Einrichtung. Für alle anderen Plattformen können sie per CRUD API eingerichtet werden.

Mit aktivierten Echtzeit-Updates kann Clerk Änderungen wie eine einfache Preisaktualisierung abrufen, aber auch Produkte vollständig hinzufügen oder entfernen.

Das bedeutet, Clerk muss nicht auf eine vollständige Synchronisierung warten, wenn du kleine Änderungen vornimmst – dein Setup bleibt so direkt aktuell.

Wenn ein Produkt über die Echtzeit-Synchronisation hinzugefügt wird, erscheint es unmittelbar nach dem Erscheinen im Clerk.io-Backend auch im Webshop.

Wird ein Produkt über die Echtzeit-Synchronisierung hinzugefügt, ist es sofort in Search, Recommendations und Email sichtbar, jedoch ohne Produkt-Ranking. Das heißt, es könnte nicht als beliebtes Produkt angezeigt werden, bis die vollständige Datensynchronisierung durchgeführt wurde.

CSV-Dateien #

Dies ist eine spezielle Synchronisationsmethode, die für die Demonstration von Clerk.io-Funktionen per Live Demo genutzt werden kann – mit einem einmaligen Upload eines Exports deines Katalogs. Du nutzt sie, indem du One-Time CSV Upload aus der Sync method-Auswahl wählst.

Generiere CSV-Dateien mindestens für deine Produkte, Kategorien und Bestellungen. Wenn du alle Möglichkeiten von Clerk sehen willst, lade außerdem auch Kunden und Seiten hoch.

Lade eine ZIP-Datei mit CSV-Vorlagendateien für alle Datentypen herunter.

Alle Dateien verwenden Kommatrennung. Werte, die ein Komma enthalten, müssen in doppelte Anführungszeichen gesetzt werden, z. B. "1,2,3" für eine Liste von IDs.

Produkte #

Jede Zeile steht für ein Produkt.

Kategorien #

Jede Zeile steht für eine Kategorie.

Bestellungen #

Jede Zeile steht für einen Bestellposten. Eine Bestellung mit mehreren Produkten umfasst entsprechend mehrere Zeilen mit derselben id.

Kunden #

Jede Zeile steht für einen Kunden. Entweder id oder Email muss ausgefüllt sein. Weitere Spalten werden als benutzerdefinierte Attribute importiert und können für Zielgruppen verwendet werden.

* Mindestens eine der Spalten id oder Email ist erforderlich.

Seiten #

Jede Zeile steht für eine Inhaltsseite.