Sync

Starten einer Synchronisierung #

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

Damit werden alle aktuellen Daten aus deinem Webshop importiert, unter Verwendung der von dir gewählten Synchronisierungsmethode.

Nachdem du auf Start New Data Sync geklickt hast, zeigt Data Sync die erwartete Wartezeit und den Warteschlangenstatus an, bevor die Verarbeitung beginnt:

• Startet in [Zeit] bedeutet, dass die Synchronisierung auf das Ende der Abkühlphase wartet.
• Leichte Verzögerung in der Download-Warteschlange bedeutet, dass 20–99 Jobs davor liegen.
• Mäßige Verzögerung in der Download-Warteschlange bedeutet, dass 100–499 Jobs davor liegen.
• Erhebliche Verzögerung in der Download-Warteschlange bedeutet, dass 500 oder mehr Jobs davor liegen.
• Daten-Synchronisierung startet… bedeutet, dass es keine nennenswerte Verzögerung gibt.

Informationen #

Dieser Abschnitt bietet schnelle Einblicke in den Status deiner Synchronisierung:

• Die Anzahl der importierten Produkte, Kategorien, Seiten, Bestellungen und Kunden
• Die Dauer der letzten Synchronisierung und die durchschnittliche Dauer einer vollständigen Synchronisierung
• Zeitstempel, wann eine Synchronisierung oder Analyse zuletzt versucht und abgeschlossen wurde
• Zeitstempel, wann eine Synchronisierung oder Analyse zuletzt eine Änderung an einem Produkt festgestellt hat

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

Einstellungen #

Diese Einstellungen ermöglichen es dir, die Daten-Synchronisierung so zu konfigurieren, dass der Zugriff auf den Webshop möglich ist und Anpassungen am Datenabruf vorgenommen werden können.

Synchronisierungsmethode #

Clerk bietet eine Vielzahl von Integrationen und Synchronisierungsmethoden, sodass es möglich ist, von jeder eCommerce-Plattform zu synchronisieren. Die von uns entwickelten Integrationen nutzen ihre eigene Synchronisierungsmethode für Plattformen wie Shopify, Magento, WooCommerce usw.

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

Synchronisierungszeit #

Mit dieser Einstellung kannst du in 1-Stunden-Schritten festlegen, wann die Synchronisierung laufen soll. Wenn du eine Zeit auswählst, wird die Synchronisierung nur in diesem Zeitfenster (UTC Zeit) ausgeführt. Das ist praktisch, um Serverkapazitäten während Stoßzeiten zu sparen und die Synchronisierung nur dann laufen zu lassen, wenn der Server weniger ausgelastet ist.

Standardmäßig ist Bei Bedarf (empfohlen) eingestellt, was bedeutet, dass die Synchronisierung regelmäßig ausgeführt wird, abhängig davon, wie lange das Laden deiner Daten dauert. Wenn es weniger als 10 Minuten dauert, kann die Synchronisierung jede Stunde laufen, während Synchronisierungen, die länger als 60 Minuten dauern, möglicherweise nur einmal täglich ausgeführt werden.

Import #

Du kannst genau festlegen, welche Datenpunkte importiert werden sollen, indem du für jeden einzelnen 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 Haupttreiber für Clerks Ergebnisse sind.

Seiten, die über die Daten-Synchronisierung importiert werden, überschreiben alle Änderungen, die in my.clerk.io an diesen synchronisierten Seiten vorgenommen wurden, beim nächsten Synchronisieren der Seiten.

Seiten, die du manuell in Data > Pages hochlädst, gelten als geschützt und werden durch die Daten-Synchronisierung nicht überschrieben.

KI-Importeure #

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

Die Einrichtung erfolgt über Ask Clerk.io. Beschreibe, mit welcher Plattform du dich verbinden möchtest, und Ask Clerk.io führt dich durch die Berechtigungen, baut den Importer, testet die Verbindung und übergibt an Data Sync – mit kompletter Konfiguration.

Du kannst auch Importer- und Sync-Fragen im selben Ask Clerk.io-Chat klären. Falls bei einer Synchronisierung Zugangsdaten oder eine Entscheidung benötigt werden, erklärt Ask Clerk.io, was gebraucht wird, bevor es weitergeht.

KI-Importeure sind 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: die Standarddaten und alle zusätzlichen Felder, die du brauchst.

Sobald die Verbindung steht, kannst du den Import erweitern – zusätzliche Attribute hinzufügen, Daten aus Drittanbieter-Integrationen einbinden oder die Logik so anpassen, dass sie zu deinem Katalog passt – alles über Ask Clerk.io.

Mehr über den Einrichtungsablauf erfährst du im Abschnitt AI Importer.

Mehrere Importeure #

Mit mehreren Importeuren kannst du verschiedene Synchronisierungsmethoden für unterschiedliche Datentypen in einer einzigen Shop-Einrichtung kombinieren.

Das ist nützlich, wenn sich deine Daten an mehr als einem Ort befinden. Beispielsweise könntest du Produkte, Kategorien und Bestellungen aus Magento 1 importieren, Kundendaten aus einer Segmentierungsplattform und Seiten aus WordPress.

Jeder Datentyp wird jeweils von einem Importer verwaltet – du kannst denselben Typ nicht gleichzeitig aus zwei Quellen importieren. Aber du hast vollständige Kontrolle darüber, welcher Importer für welchen Typ zuständig ist.

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

Für jeden Importer kannst du konfigurieren, welche Datentypen importiert werden sollen. Ist ein Typ einem Importer zugeordnet, sollte er nicht auch in einem anderen aktiviert sein – jeder Typ sollte genau eine Quelle haben.

Produkte und Kategorien sind erforderlich, damit Clerk.io korrekt funktioniert. Stelle sicher, dass mindestens ein Importeur für jeden davon verantwortlich ist.

Sync-Protokoll #

In diesem Abschnitt siehst du den Status der Synchronisierung, während sie läuft und wenn sie abgeschlossen ist. Das ist hilfreich, um sicherzustellen, dass alles reibungslos läuft, und unterstützt dich bei der Fehlerbehebung, falls Probleme auftreten.

Du kannst darauf zugreifen, indem du auf Show latest sync log details klickst.

Whitelist für IP-Adresse #

Wenn dein Server nur von bestimmten IP-Adressen zugänglich ist, musst du die IP-Adresse des Clerk Data Sync-Systems auf die Whitelist setzen, um Zugriff auf deine Daten zu ermöglichen.

Die IP-Adresse ist 52.57.0.11

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

Echtzeit-Updates #

Dies ist die beste Möglichkeit, Clerk stets ohne Verzögerung mit deinem Webshop zu synchronisieren. Während die vollständige Daten-Synchronisierung optimal für größere Datenmengen in regelmäßigen Abständen ist, werden Echtzeit-Updates genutzt, um kleinere Änderungen sofort zu übermitteln.

Die meisten unserer Erweiterungen und Integrationen verfügen standardmäßig darüber 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 Preisaktualisierung abrufen oder auch Produkte ganz hinzufügen oder entfernen.

Das bedeutet, dass Clerk nicht auf eine vollständige Synchronisierung warten muss, wenn du kleinere Änderungen vornimmst – so bleibt dein Setup unmittelbar auf dem neuesten Stand.

Wenn du ein Produkt über die Echtzeit-Synchronisierung hinzufügst, erscheint es in deinem Webshop sofort, nachdem es im Clerk.io-Backend sichtbar wird.

Ein Produkt, das per Echtzeit-Sync hinzugefügt wird, ist sofort in Search, Recommendations und Email sichtbar, allerdings wird das Produktranking nicht übernommen. Das bedeutet, dass es eventuell erst nach einer vollständigen Daten-Synchronisierung als beliebtes Produkt angezeigt wird.

CSV-Dateien #

Dies ist eine spezielle Synchronisierungsmethode, mit der du die Funktionen von Clerk.io im Rahmen einer Live-Demo vorführen kannst, indem du einen einmaligen Export deines Katalogs hochlädst. Du verwendest das, indem du im Dropdown-Menü One-Time CSV Upload unter Sync method auswählst.

Der Uploadscreen zeigt während der Verarbeitung durch Clerk.io einen Echtzeit-Fortschrittsbalken an. Die Verarbeitung kann noch laufen, nachdem der Datei-Upload abgeschlossen ist – warte also, bis der Fortschritt abgeschlossen ist, bevor du fortfährst.

Erstelle CSV-Dateien mindestens für deine Produkte, Kategorien und Bestellungen und, wenn du alle Möglichkeiten von Clerk sehen möchtest, auch für deine Kunden und Seiten.

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

Alle Dateien sind kommagetrennt. Jeder Wert, der ein Komma enthält, muss in Anführungszeichen gesetzt werden – zum Beispiel "1,2,3" für eine Liste von IDs.

Produkte #

Jede Zeile entspricht einem Produkt.

Kategorien #

Jede Zeile entspricht einer Kategorie.

Bestellungen #

Jede Zeile entspricht einer Position. Eine Bestellung mit mehreren Produkten umfasst mehrere Zeilen und teilt sich jeweils die gleiche id.

Kunden #

Jede Zeile entspricht einem Kunden. Entweder id oder Email muss vorhanden sein. Jegliche weiteren Spalten werden als benutzerdefinierte Attribute importiert und können zur Segmentierung des Publikums verwendet werden.

* Mindestens eines von id oder Email ist erforderlich.

Seiten #

Jede Zeile entspricht einer Inhaltsseite.