Daten synchronisieren

Importieren Sie Ihre ideal.shop-Daten, bevor Sie Search und Recommendations konfigurieren. Zuerst Integration aktivieren, einschließlich Feed offentligt.

Feed konfigurieren #

Ohne explizite Begrenzungen liefert das Feed bis zu 50 Datensätze pro Datentyp. Legen Sie separate Limits für Produkte, Kategorien und Bestellungen für den ersten historischen Import fest.

1. Öffnen Sie in ideal.shop Indstillinger > Integrationer > Clerk.io.
2. Kopieren Sie die URL unter Sti til feed.
3. Für eine URL ohne Query-Parameter hängen Sie ?&products=10000&categories=10000&orders=10000 an:

https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000&orders=10000

Falls Ihre URL bereits eine Query-String enthält, fügen Sie die Parameter mit & an und behalten Sie alle bestehenden benötigten Parameter bei. Fügen Sie kein zweites ? hinzu und duplizieren Sie keine existierenden Limits.

Diese Werte fordern bis zu 10.000 Datensätze für jeden genannten Typ an. Erhöhen Sie jedes Limit nach Bedarf; 10.000 ist ein Beispiel und garantiert keinen vollständigen Export. Andere Datentypen behalten ihre Standardwerte, sofern sie nicht separat konfiguriert werden.

Zum Beispiel verwendet das Feed von Fodmagasinet die gleiche Syntax unter der eigenen Domain:

https://www.fodmagasinet.dk/feeds/clerk_io_feed.json?&products=10000&categories=10000&orders=10000

Sync starten #

Konfigurieren Sie Clerk.io so, dass die vollständige Feed-URL inklusive ihrer Limits gelesen wird.

1. Öffnen Sie in my.clerk.io den entsprechenden Shop und gehen Sie zu Data > Configuration.
2. Wählen Sie Clerk.io JSON Feed als Sync-Methode.
3. Fügen Sie die Feed-URL ein und speichern Sie die Konfiguration.
4. Klicken Sie auf Start New Data Sync und warten Sie auf den Abschluss.
5. Vergleichen Sie die importierten Mengen mit den exportierbaren Gesamtzahlen des Webshops, unter Berücksichtigung absichtlich ausgeschlossener Datensätze.

Eine Zahl, die dem angeforderten Limit entspricht, könnte eine Kürzung anzeigen. Erhöhen Sie das Limit und synchronisieren Sie erneut. Überprüfen Sie auch die älteste importierte Bestellung sowie die Gesamtzahl – ein erfolgreicher Sync kann dennoch nur einen Teil der Historie enthalten.

Siehe Data Sync für Status und Protokolle oder die Feed-FAQ zu Kürzungen und Timeouts.

Laufende Importe #

Nach dem ersten erfolgreichen historischen Import entfernen Sie &orders=10000. Behalten Sie die Katalog-Limits vollständig bei:

https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000

Durch das Entfernen von orders wird der Standardwert von 50 zuletzt eingegangenen Bestellungen wiederhergestellt. Dies deaktiviert den Bestellimport nicht. Clerk.io behält bereits importierte Bestellungen, sodass das laufende Feed nur aktuelle Bestellungen abdecken muss.

Vergleichen Sie vor der Nutzung des Standardwerts das Bestellvolumen des Webshops mit dem Zeitraum zwischen erfolgreichen Syncs, inkl. Verzögerungen oder fehlgeschlagenen Syncs. Überprüfen Sie, dass die älteste zurückgegebene Bestellung sich mit dem letzten erfolgreichen Import überschneidet und alle Bestellungen seitdem enthalten sind.

Wenn 50 Bestellungen diesen Zeitraum nicht abdecken können, setzen Sie ein explizites orders-Limit hoch genug, um ihn mit Überschneidung abzudecken. Zum Beispiel hängen Sie nur dann &orders=500 an, wenn das Ihr Volumen abdeckt. Überprüfen Sie dies nach einem Sync-Ausfall oder einem Bestellanstieg erneut.

Lassen Sie products und categories bei jedem Sync immer so hoch, dass der gesamte aktuelle Katalog abgedeckt ist. Reduzieren Sie sie nicht nach einmaligem Import auf den Standardwert.

Seiten importieren #

Artikel- und andere Inhaltsseiten benötigen eigene Datensätze, bevor sie in Search angezeigt werden oder Kontexte für seitenbasierte Recommendations bieten können.

Abdeckung prüfen #

Untersuchen Sie die native Feed-Collection pages und die importierten Seiten in Clerk.io. Vergleichen Sie bekannte Artikel-URLs und -IDs; ein Sitemap-Eintrag allein bedeutet nicht, dass das native Feed diese Seite exportiert.

Falls das native Feed den benötigten Inhalt bereits enthält, verwenden Sie diese Datensätze. Vermeiden Sie Mehrfachimporte derselben URL über andere Importeure.

Import erweitern #

Falls Seiten fehlen, öffnen Sie Ask Clerk.io und fordern Sie einen AI Integration für Inhaltsseiten an. Stellen Sie die Sitemap-URL des Webshops bereit und erläutern Sie, welche Seitentypen ein- oder ausgeschlossen werden sollen.

Bitten Sie darum, Sitemap-Indizes sowie deren Kind-Sitemaps zu entdecken, die gewünschten Seiten abzurufen und einen Musterimport zur Überprüfung vorzuschlagen. Bestätigen Sie, dass der Seitenimporteur parallel zum nativen Katalogimport laufen kann, ohne dessen Datensätze zu ersetzen oder zu duplizieren.

Für Fodmagasinet ist die Beispielquelle https://www.fodmagasinet.dk/sitemap.xml, wobei die Startseite und URLs, die /vare enthalten, ausgeschlossen werden. Diese Regeln sind auf die URL-Struktur dieses Webshops zugeschnitten; prüfen Sie Ihre eigene Sitemap, bevor Sie Filter auswählen.

Validieren Sie jeden Beispiel-Datensatz:

• Eine stabile, eindeutige ID, die der Artikel-ID im Storefront entspricht, wenn seitenbasierte Recommendations verwendet werden.
• Korrekte Titel, kanonische URL und nützlicher Artikelinhalt – ohne Header-, Footer- oder Navigations-Text.
• Keine doppelten URLs, Produktseiten, Kategorielisten oder andere unerwünschte Seitentypen.

Falls der Importer andere IDs als vom Theme ausgegeben generiert, stimmen Sie die Zuordnung mit dem Entwickler ab, bevor Sie Artikel-Recommendations konfigurieren. Überprüfen Sie importierte Muster und Mengen nach dem ersten Lauf.

Seiten zu importieren und darzustellen sind separate Schritte. Das Search-Design muss auch Seitenresultate darstellen; siehe Search.

Daten validieren #

Ein erfolgreicher Status und plausible Mengen beweisen nicht, dass die Daten mit dem Storefront übereinstimmen. Vergleichen Sie repräsentative importierte Datensätze mit dem tatsächlichen Webshop.

Siehe Kartendaten für die Preisanzeige und die FAQ für Bild- und Quell-Daten-Probleme.