Sync

Starten einer Synchronisierung #

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

Dadurch werden alle aktuellen Daten aus deinem Webshop importiert, wobei die von dir ausgewählte Synchronisierungsmethode verwendet wird.

Informationen #

Dieser Abschnitt bietet einen schnellen Überblick über den Status deiner Synchronisierung:

• Die Anzahl der importierten Produkte, Kategorien, Seiten, Bestellungen und Kunden
• Zeitstempel, wann eine Synchronisierung oder Analyse zuletzt versucht und abgeschlossen wurde
• 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 Analysis Details darauf beziehen, wann Clerk die Daten zuletzt verarbeitet und gespeichert hat.

Einstellungen #

Diese Einstellungen ermöglichen dir, die Datensynchronisierung zu konfigurieren, um Zugriff auf den Webshop zu erhalten und Anpassungen daran vorzunehmen, wie die Daten abgerufen werden.

Synchronisierungsmethode #

Clerk bietet eine Reihe von Integrationen und Synchronisierungsmethoden, sodass eine Synchronisierung von jeder E-Commerce-Plattform möglich ist. Die von uns entwickelten Integrationen nutzen jeweils eine eigene Synchronisierungsmethode für Plattformen wie Shopify, Magento, WooCommerce und so weiter.

Es ist auch möglich, Demo Data als Synchronisierungsmethode auszuwählen. Damit synchronisiert Clerk einen vordefinierten Datensatz, den du zu Testzwecken verwenden kannst. Das ist nützlich, wenn du zunächst mit my.clerk.io und unserer API herumspielen möchtest, bevor du eine echte Konfiguration startest.

Synchronisierungszeit #

Mit dieser Einstellung kannst du auswählen, in welchen 1-Stunden-Intervallen die Synchronisierung ausgeführt werden soll. Mit der Auswahl einer Uhrzeit wird die Synchronisierung nur innerhalb dieses Zeitfensters (UTC) durchgeführt. Dies ist nützlich, wenn du Serverkapazitäten während Hauptlastzeiten sparen und nur synchronisieren möchtest, wenn der Server weniger ausgelastet ist.

Standardmäßig ist When Needed (Recommended) ausgewählt, wodurch die Synchronisierung regelmäßig entsprechend der Dauer des Ladevorgangs deiner Daten durchgeführt wird. Dauert der Vorgang weniger als 10 Minuten, kann die Synchronisierung jede Stunde ausgeführt werden. Synchronisierungen, die 60+ Minuten benötigen, werden möglicherweise nur einmal am Tag durchgeführt.

Importieren #

Du kannst für jeden einzelnen Punkt exakt auswählen, welche Daten importiert werden sollen, indem du Ja oder Nein auswählst:

• Produkte
• Kategorien
• Bestellungen
• Kunden
• Seiten

Clerk benötigt Produkte und Kategorien für eine korrekte Funktion und es wird dringend empfohlen, auch Bestellungen zu importieren, da diese die Hauptantriebsquelle für die Ergebnisse von Clerk sind.

Über die Datensynchronisierung importierte Seiten überschreiben synchronisierte Seiten in my.clerk.io das nächste Mal, wenn Seiten synchronisiert werden, unabhängig von dort vorgenommenen Änderungen.

Seiten, die du manuell in Data > Pages hochlädst, gelten als geschützt und werden nicht von der Datensynchronisierung überschrieben.

KI-Importer #

KI-Importer ermöglichen es dir, eine benutzerdefinierte Integration von Grund auf ohne vordefinierte Konfiguration zu erstellen. Wenn deine Plattform eine API bereitstellt, kann Clerk.io sich damit verbinden.

Anstatt ein festes Set an Feldern auszufüllen, beschreibst du in Alltagssprache, was du importieren möchtest.

Die KI generiert dann die notwendigen Eingabefelder, um die Verbindung herzustellen — wie zum Beispiel eine URL, einen API-Schlüssel oder Zugangsdaten — abhängig davon, was die Plattform benötigt.

Wenn du einen neuen KI-Importer hinzufügst, sind standardmäßig keine Konfigurationsfelder vorhanden. Um zu starten, teile der KI mit, auf welche Plattform du zugreifen möchtest, und gib eine URL zu deinem Shop an.

Anschließend fragt die KI nach den benötigten Zugangsdaten und baut die Konfiguration auf. In vielen Fällen kann sie die relevante API-Dokumentation selbst finden, aber du kannst Dokumente auch direkt bereitstellen, um mehr Kontext zu liefern.

Sobald die Verbindung hergestellt ist, kannst du festlegen und anpassen, was importiert werden soll — zusätzliche Attribute hinzufügen, Daten aus Drittanbieter-Integrationen abrufen oder die Logik an deinen Katalog anpassen.

KI-Importer sind momentan eigenständige Integrationen. Wenn dein Shop beispielsweise auf Shopify läuft und du zusätzliche Daten importieren möchtest, die der Standard-Shopify-Importer nicht abdeckt, richtest du einen neuen KI-Importer ein, der direkt mit Shopify kommuniziert.

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

Zukünftig wird es möglich sein, Standard-Importer direkt zu erweitern — sodass du angeben kannst: „Importiere außerdem Langify-Übersetzungsdaten“ oder „Hole Daten von diesem Magento-Modul für Drittanbieter-Lagerbestände“, ohne ganz von vorn beginnen zu müssen.

Mehrere Importeure #

Mehrere Importeure ermöglichen es dir, verschiedene Synchronisierungsmethoden für unterschiedliche Datentypen in einer einzigen Shop-Konfiguration zu kombinieren.

Das ist hilfreich, wenn deine Daten aus mehreren Quellen stammen. Du kannst zum Beispiel Produkte, Kategorien und Bestellungen aus Magento 1 importieren, während Kundendaten aus einer Segmentierungsplattform und Seiten aus WordPress stammen.

Jeder Datentyp wird immer nur von einem Importeur bearbeitet — du kannst denselben Typ nicht simultan aus zwei Quellen importieren. Du hast jedoch die volle Kontrolle darüber, welcher Importeur für welche Daten verantwortlich ist.

Gehe zu Data > Configuration und nutze die Schaltfläche + Add importer, um neben der bestehenden eine zweite Synchronisierungsmethode hinzuzufügen.

Für jeden Importeur kannst du konfigurieren, welche Datentypen importiert werden sollen. Wenn ein Datentyp einem Importeur zugeordnet ist, sollte er nicht zusätzlich bei einem anderen aktiviert sein — jeder Typ sollte genau eine Quelle haben.

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

Synchronisierungsprotokoll #

Dieser Abschnitt zeigt dir den Status der Synchronisierung während der Ausführung und nach deren Abschluss. Das ist nützlich, um zu bestätigen, dass alles reibungslos läuft, und hilft dir bei der Fehlersuche, falls Probleme auftreten.

Du kannst sie anzeigen, indem du auf Show latest sync log details klickst.

Whitelisting der IP-Adresse #

Wenn dein Server mit einem IP-Lock gesichert ist, musst du die IP-Adresse des Data Sync-Systems von Clerk auf die Whitelist setzen, um den Zugriff auf deine Daten zu ermöglichen.

Die IP-Adresse lautet 52.57.0.11

Diese IP kann sich ändern. Falls Data Sync mit einem 403-Fehler oder einem ähnlichen Fehler antwortet, kehre einfach auf diese Seite zurück, um die aktuelle IP-Adresse zu finden.

Echtzeit-Updates #

Das ist die beste Möglichkeit, Clerk ohne Verzögerung stets auf dem aktuellen Stand mit deinem Webshop zu halten. Während die vollständige Datensynchronisierung ideal für das Laden großer Datenmengen in regelmäßigen Abständen ist, werden Echtzeit-Updates verwendet, um kleinere Änderungen direkt zu übertragen.

Die meisten unserer Extensions und Integrationen haben diese Funktion bereits integriert und benötigen keine zusätzliche Einrichtung. Für andere Plattformen können sie über unsere CRUD API eingerichtet werden.

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

Das bedeutet, dass Clerk nicht auf eine vollständige Synchronisierung warten muss, sobald du kleinere Änderungen vornimmst – so bleibt deine Konfiguration jederzeit sofort aktuell.

Wenn ein Produkt über die Echtzeit-Synchronisierung hinzugefügt wird, erscheint es sofort nach Anzeige im Backend von Clerk.io in deinem Webshop.

Wird ein Produkt über die Echtzeit-Sync hinzugefügt, ist es sofort in Search, Recommendations und Email sichtbar, aber das Produkt-Ranking ist nicht enthalten. Das bedeutet, dass es erst als beliebtes Produkt erscheinen kann, wenn eine vollständige Daten-Synchronisierung läuft.

CSV-Dateien #

Dies ist eine spezielle Synchronisierungsmethode, mit der du die Funktionen von Clerk.io in einer Live-Demo präsentieren kannst, indem du einen einmaligen Export deines Katalogs hochlädst. Wähle dazu im Dropdown-Menü Sync method die Option One-Time CSV Upload.

Erstelle CSV-Dateien mindestens für deine Produkte, Kategorien und Bestellungen und – um die vollständigen Möglichkeiten von Clerk zu testen – auch für deine Kunden und Seiten.

Eine ZIP-Datei mit CSV-Vorlagendateien für alle Datentypen herunterladen.