Sync

Einen Sync starten #

Du kannst jederzeit einen vollständigen Sync von 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 gewählte Sync-Methode verwendet wird.

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

• Starts in [time] bedeutet, dass der Sync auf das Ende der Abkühlzeit wartet.
• Slight delay in the download queue bedeutet, dass sich 20–99 Jobs in der Warteschlange befinden.
• Moderate delay in the download queue bedeutet, dass sich 100–499 Jobs in der Warteschlange befinden.
• Significant delay in the download queue bedeutet, dass 500 oder mehr Jobs vor dir in der Warteschlange sind.
• Data sync starting… bedeutet, dass es keine nennenswerte Verzögerung gibt.

Information #

Dieser Abschnitt bietet schnelle Einblicke in den Stand deines Syncs:

• Die Anzahl der importierten Produkte, Kategorien, Seiten, Bestellungen und Kunden
• Die Dauer des letzten Syncs und die durchschnittliche Dauer eines vollständigen Syncs
• Zeitstempel, wann ein Sync oder eine Analyse zuletzt versucht und abgeschlossen wurde
• Zeitstempel, wann ein Sync oder eine Analyse zuletzt eine Änderung an einem Produkt registriert hat

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

Einstellungen #

Mit diesen Einstellungen kannst du den Daten-Sync konfigurieren, um Zugriff auf den Webshop zu erhalten und Anpassungen daran vorzunehmen, wie die Daten abgeholt werden.

Sync-Methode #

Clerk enthält eine Reihe von Integrationen und Sync-Methoden, sodass ein Sync von jeder E-Commerce-Plattform aus möglich ist. Die von uns entwickelten Integrationen verwenden eigene Sync-Methoden für Plattformen wie Shopify, Magento, WooCommerce usw.

Es ist auch möglich, Demo Data als Sync-Methode zu wählen. Damit synchronisiert Clerk einen vordefinierten Datensatz, den du zu Testzwecken verwenden kannst. Das ist nützlich, wenn du dich erst mit my.clerk.io und unserer API vertraut machen möchtest, bevor du ein echtes Setup startest.

Sync-Zeit #

Mit dieser Einstellung kannst du Zeitfenster in 1-Stunden-Schritten auswählen, in denen der Sync laufen soll. Wenn du eine Zeit auswählst, läuft der Sync nur in diesem Zeitrahmen in UTC-Zeit. Dies ist nützlich, wenn du Serverkapazitäten während Zeiten hoher Auslastung sparen möchtest und der Sync nur laufen soll, wenn der Server weniger ausgelastet ist.

Standardmäßig ist When Needed (Recommended) eingestellt, wodurch der Sync regelmäßig ausgeführt wird, abhängig davon, wie lange das Laden deiner Daten dauert. Dauert es weniger als 10 Minuten, kann der Sync jede Stunde laufen, während Syncs, die über 60 Minuten dauern, eventuell nur einmal täglich laufen.

Import #

Du kannst genau festlegen, welche Datenpunkte importiert werden sollen, indem du für jede der folgenden Optionen Ja oder Nein auswählst:

• Produkte
• Kategorien
• Bestellungen
• Kunden
• Seiten

Clerk benötigt Produkte und Kategorien für einen korrekten Betrieb, und es wird dringend empfohlen, auch Bestellungen zu importieren, da diese die Hauptgrundlage für die Ergebnisse von Clerk darstellen.

Seiten, die über den Daten-Sync importiert werden, überschreiben bei der nächsten Synchronisierung alle in my.clerk.io vorgenommenen Änderungen an diesen synchronisierten Seiten.

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

KI-Importer #

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

Die Einrichtung läuft über Ask Clerk.io. Beschreibe, zu welcher Plattform du eine Verbindung herstellen möchtest, und Ask Clerk.io führt dich durch die Zugangsdaten, baut den Importer, testet die Verbindung und übergibt mit der vollständigen Konfiguration an Data Sync.

Du kannst in derselben Ask Clerk.io-Konversation auch Fragen zum Importer oder Sync klären. Falls ein Sync Zugangsdaten oder andere Entscheidungen benötigt, erklärt Ask Clerk.io, was benötigt wird, bevor es weitergeht.

KI-Importer 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 explizit auf Shopify zugreift.

Der KI-Importer übernimmt dann alles: die Standarddaten sowie alle zusätzlichen Felder, die du benötigst.

Sobald die Verbindung steht, kannst du den Import nach Belieben erweitern – zusätzliche Attribute hinzufügen, Daten aus Drittsystemen einbinden oder die Logik an deinen Katalog anpassen – alles über Ask Clerk.io.

Mehr zum Ablauf findest du im AI Importer.

Mehrere Importer #

Mit mehreren Importern kannst du verschiedene Sync-Methoden für verschiedene Datentypen in einem einzigen Shop-Setup kombinieren.

Das ist praktisch, wenn deine Daten an mehreren Orten liegen. Du könntest z. B. Produkte, Kategorien und Bestellungen aus Magento 1 importieren, während du Kundendaten aus einer Segmentierungsplattform und Seiten aus WordPress importierst.

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

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

Für jeden Importer kannst du konfigurieren, welche Datentypen er importieren soll. Wenn ein Datentyp einem Importer zugewiesen ist, sollte er nicht auch in einem anderen aktiviert sein – jeder Typ sollte exakt eine Quelle haben.

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

Sync-Protokoll #

In diesem Abschnitt siehst du den Status des Syncs während der Ausführung und nach Abschluss. Dies ist nützlich, um zu bestätigen, dass alles reibungslos läuft, und hilft dir bei der Fehlersuche, falls Probleme auftreten.

Du erreichst diesen Bereich, indem du auf Show latest sync log details klickst.

IP-Adresse auf die Whitelist setzen #

Wenn dein Server eine IP-Sperre verwendet, 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 ist 52.57.0.11

Diese IP-Adresse kann sich ändern. Wenn Data Sync mit einem 403 oder einem ähnlichen Fehler antwortet, schau einfach auf dieser Seite nach der aktuellen IP-Adresse nach.

Echtzeit-Updates #

Dies ist die beste Möglichkeit, Clerk ohne Verzögerung auf dem neuesten Stand mit deinem Webshop zu halten. Während der vollständige Daten-Sync ideal ist, um regelmäßig große Datenmengen zu laden, werden Echtzeit-Updates genutzt, um kleinere Änderungen direkt zu übertragen.

Die meisten unserer Erweiterungen und Integrationen haben diese Funktionalität bereits integriert, ohne dass eine zusätzliche Einrichtung nötig ist. Für alle anderen Plattformen kann dies über unsere 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, dass Clerk nicht auf den nächsten vollständigen Sync warten muss, wenn kleinere Änderungen gemacht werden, sodass dein Setup sofort auf dem neuesten Stand bleibt.

Wenn ein Produkt über den Echtzeit-Sync hinzugefügt wird, erscheint es sofort in deinem Webshop, sobald es im Clerk.io-Backend dargestellt wird.

Ein per Echtzeit-Sync hinzugefügtes Produkt ist sofort in Search, Recommendations und Email sichtbar, aber das Ranking des Produkts ist noch nicht enthalten. Das bedeutet, es könnte nicht als beliebtes Produkt erscheinen, bis der vollständige Daten-Sync durchgeführt wurde.

CSV-Dateien #

Dies ist eine spezielle Sync-Methode, die für die Demonstration der Funktionen von Clerk.io über eine Live-Demo genutzt werden kann, indem ein einmaliger Export deines Katalogs hochgeladen wird. Du kannst dies verwenden, indem du im Dropdown-Menü Sync method auf One-Time CSV Upload auswählst.

Auf dem Upload-Bildschirm siehst du einen Echtzeit-Fortschrittsbalken, während Clerk.io die Dateien verarbeitet. Die Verarbeitung kann nach Abschluss des Datei-Uploads noch weiterlaufen, warte daher, bis der Fortschritt vollständig abgeschlossen ist.

Erzeuge CSV-Dateien zumindest für deine Produkte, Kategorien und Bestellungen – und wenn du die vollständigen Möglichkeiten von Clerk sehen möchtest, auch für deine Kunden und Seiten.

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

Alle Dateien sind komma-separiert. Jeder Wert, der ein Komma enthält, muss in doppelte Anführungszeichen gesetzt werden, z.B. "1,2,3" für eine ID-Liste.

Produkte #

Jede Zeile steht für ein Produkt.

Kategorien #

Jede Zeile steht für eine Kategorie.

Bestellungen #

Jede Zeile steht für einen Positionseintrag. Eine Bestellung mit mehreren Produkten erstreckt sich über mehrere Zeilen, die alle dieselbe id teilen.

Kunden #

Jede Zeile steht für einen Kunden. Es muss entweder id oder Email vorhanden sein. Alle zusätzlichen Spalten werden als benutzerdefinierte Attribute importiert und können für Audience-Segmentierung genutzt werden.

* Mindestens eines von id oder Email ist erforderlich.

Seiten #

Jede Zeile steht für eine Inhaltsseite.