Sync

Einen Sync starten #

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

Damit werden alle aktuellen Daten aus deinem Webshop importiert, und zwar mit der von dir gewählten Sync-Methode.

Nachdem du auf Start New Data Sync geklickt hast, zeigt Data Sync die erwartete Wartezeit sowie den Status der Warteschlange an, bevor die Verarbeitung beginnt:

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

Sync-Status #

Öffne Data > Configuration, um die importierten Anzahl von Produkten, Kategorien, Seiten, Kunden und Bestellungen zu sehen.

Für die Datensynchronisierung und Datenanalyse gibt es getrennte Statusbereiche. Jeder zeigt das letzte Ergebnis und Timing-Informationen an. Die Synchronisierung holt Daten aus deinem Webshop; die Analyse verarbeitet die Daten für Clerk.io.

Die Synchronisierung zeigt außerdem ihre Dauer und die durchschnittliche Dauer eines vollständigen Syncs an. Nutze diese Informationen, um einzuschätzen, wie lange ein Durchlauf normalerweise dauert.

Nutze Start new data sync oder Start new data analysis neben dem jeweiligen Status, um die jeweilige Aktion zu starten. Während ein Lauf gestartet wird oder läuft, kannst du den Fortschritt im Statusbereich verfolgen.

Einstellungen #

Mit diesen Einstellungen kannst du den Zugriff auf deinen Webshop und die Art, wie Daten abgerufen werden, konfigurieren. Die allgemeinen Sync settings, inklusive Sync Time, folgen nach Sync platform und erscheinen vor den importer-spezifischen Einstellungen.

Sync-Methode #

Clerk bietet eine Reihe von Integrationen und Sync-Methoden, sodass du von jeder eCommerce-Plattform synchronisieren kannst. Die von uns entwickelten Integrationen nutzen jeweils ihre eigene Sync-Methode für Plattformen wie Shopify, Magento, WooCommerce und andere.

Es ist auch möglich, Demo Data als Sync-Methode zu wählen. Damit synchronisiert Clerk einen vordefinierten Datensatz, den du zum Testen nutzen kannst. Das ist sinnvoll, wenn du mit my.clerk.io und unserer API herumprobieren möchtest, bevor du eine reale Einrichtung beginnst.

Sync Time #

Mit dieser Einstellung kannst du in 1-Stunden-Intervallen festlegen, wann der Sync ausgeführt werden soll. Durch die Auswahl einer Zeit läuft der Sync nur innerhalb dieses Zeitrahmens in UTC-Zeit. Das ist sinnvoll, wenn du Serverkapazität während Zeiten hoher Auslastung sparen und nur synchronisieren möchtest, wenn der Server weniger beschäftigt ist.

Standardmäßig ist When Needed (Recommended) aktiviert, wodurch der Sync regelmäßig ausgeführt wird, je nachdem, wie lange das Laden deiner Daten dauert. Dauert der Sync weniger als 10 Minuten, findet er eventuell stündlich statt, während längere Syncs, die 60+ Minuten benötigen, wahrscheinlich nur einmal täglich laufen.

Import #

Du kannst genau festlegen, welche Datenpunkte importiert werden sollen, indem du für jeden der folgenden Punkte entweder 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 der Hauptantrieb hinter Clerks Ergebnissen sind.

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

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

AI-Importer #

Mit AI-Importern kannst du eine eigene Integration von Grund auf erstellen, ohne vordefinierte Konfiguration. Wenn deine Plattform eine API zur Verfügung stellt, kann Clerk.io eine Verbindung herstellen.

Die Einrichtung erfolgt über Ask Clerk.io. Beschreibe, mit welcher Plattform du verbinden möchtest, und Ask Clerk.io führt dich durch die Zugangsdaten, erstellt den Importer, testet die Verbindung und übergibt dann an Data Sync mit der fertigen Konfiguration.

Du kannst Importer- und Sync-Fragen auch im gleichen Ask Clerk.io Gespräch bearbeiten. Falls für einen Sync Zugangsdaten oder eine andere Entscheidung nötig sind, erklärt Ask Clerk.io, was benötigt wird, bevor es weitergeht.

AI-Importer sind eigenständige Integrationen. Falls 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 AI-Importer ein, der direkt mit Shopify kommuniziert.

Dieser AI-Importer übernimmt dann alle Aufgaben: Die Standarddaten sowie alle zusätzlichen Felder, die du benötigst.

Sobald die Verbindung hergestellt ist, kannst du den Import erweitern – zusätzliche Attribute hinzufügen, Daten von Drittanbieter-Integrationen einbeziehen oder die Logik an deinen Katalog anpassen – alles über Ask Clerk.io.

Um einen bestehenden AI-Importer zu testen oder zu ändern, nutze Test importer oder Edit importer in Data > Configuration. Siehe Einen Importer verwalten für den vollständigen Ablauf.

Mehr zur Einrichtung findest du unter AI Integration.

Mehrere Importer #

Mit mehreren Importern kannst du verschiedene Sync-Methoden für unterschiedliche Datentypen in einer einzigen Shop-Konfiguration kombinieren.

Das ist nützlich, wenn deine Daten an mehreren Orten vorliegen. Du könntest beispielsweise Produkte, Kategorien und Bestellungen aus Magento 1 importieren, während Kundendaten von einer Segmentierungsplattform und Seiten aus WordPress stammen.

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

Öffne Data > Configuration und finde Your importers unter den allgemeinen Sync settings. Wähle einen bestehenden Importer-Tab, um seine Einstellungen anzuzeigen. Die anderen Tabs bleiben verfügbar, sodass du einfach wechseln kannst.

Mit dem separaten Add importer Dropdown kannst du den Typ des Importers auswählen, den du hinzufügen möchtest. Einstellungen und Aktionen beziehen sich auf den gewählten Importer.

Für jeden Importer kannst du einstellen, welche Datentypen er importieren soll. Ist ein Datentyp einem Importer zugewiesen, sollte er nicht gleichzeitig 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 Importer für jeden dieser Typen zuständig ist.

Einen Lauf beheben #

Aus einem Sync- oder Analyse-Statusbereich heraus öffnest du die Log-Details-Aktion, um genau diesen Lauf in Developers > Logs anzuzeigen. Du musst den Lauf nicht erst in der vollständigen Log-Liste suchen.

Siehe Developer Logs für Filter, Log-Zeiträume und Event-Details.

Freischaltung der IP-Adresse #

Wenn dein Server eine IP-Sperre hat, musst du die IP-Adresse des Data Sync-Systems von Clerk auf die Whitelist setzen, um Zugriff auf deine Daten zu ermöglichen.

Die IP-Adresse lautet 52.57.0.11

Diese IP kann sich ändern. Wenn Data Sync mit einem 403 oder ähnlichem 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 mit deinem Webshop aktuell zu halten. Während der vollständige Daten-Sync ideal ist, um große Datenmengen in regelmäßigen Abständen zu laden, werden mit Echtzeit-Updates kleinere Änderungen beim Eintreten direkt gesendet.

Die meisten unserer Erweiterungen und Integrationen haben dies bereits integriert, ohne dass zusätzliche Einrichtung nötig ist. Für alle anderen Plattformen können sie über unsere CRUD API eingerichtet werden.

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

Das bedeutet, Clerk muss nicht auf einen vollständigen Sync warten, sobald du kleinere Änderungen vornimmst, sodass dein Setup immer sofort aktuell bleibt.

Beim Hinzufügen eines Produkts über den Echtzeit-Sync erscheint es sofort in deinem Webshop, nachdem es im Clerk.io Backend angezeigt wird.

Wenn ein Produkt über den Echtzeit-Sync hinzugefügt wurde, ist es sofort in Search, Recommendations und Email sichtbar, jedoch ist das Produkt-Ranking nicht enthalten. Das bedeutet, es könnte bis zum nächsten vollständigen Sync nicht als beliebtes Produkt erscheinen.

CSV-Dateien #

Das ist eine spezielle Sync-Methode, die für Demos der Clerk.io-Funktionen über eine Live-Demo genutzt werden kann, indem du einen einmaligen Export deines Katalogs hochlädst. Du kannst sie nutzen, indem du One-Time CSV Upload aus dem Sync method Dropdown auswählst.

Der Upload-Bildschirm zeigt einen Echtzeit-Fortschrittsbalken, während Clerk.io die Dateien verarbeitet. Die Verarbeitung kann nach Abschluss des Datei-Uploads fortgesetzt werden, darum warte, bis der Fortschritt abgeschlossen ist, bevor du fortfährst.

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

Eine Zip-Datei mit CSV-Template-Dateien für alle Datentypen herunterladen.

Alle Dateien verwenden das Komma als Trennzeichen. Jeder Wert, der ein Komma enthält, muss in doppelte Anführungszeichen gesetzt werden, zum Beispiel "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 eine Bestellposition. Eine Bestellung mit mehreren Produkten erstreckt sich über mehrere Zeilen mit derselben id.

Kunden #

Jede Zeile steht für einen Kunden. Entweder id oder Email müssen vorhanden sein. Zusätzliche Spalten werden als benutzerdefinierte Attribute importiert und können für die Zielgruppen-Segmentierung verwendet werden.

* Mindestens eines der Felder id oder Email ist erforderlich.

Um bestehende Abonnenten zu synchronisieren, gib deren E-Mail-Adresse und eine subscribed-Spalte mit Wert true an. So wird der Kunde mit dem Attribut subscribed: true importiert und kann E-Mail-Marketing von Clerk.io erhalten.

Email,subscribed
luke@example.com,true

Seiten #

Jede Zeile steht für eine Inhaltsseite.