Daten synchronisieren
Die empfohlene Methode, ideal.shop-Daten zu synchronisieren, ist eine AI Integration über die API des Shops. Richten Sie dies für alle Datentypen ein, wobei Inhaltsseiten über die Sitemap im Rahmen derselben Integration abgerufen werden.
API-Benutzer erstellen #
Erstellen Sie einen API-Benutzer in ideal.shop, um der AI Integration Zugriff auf die Daten Ihres Shops zu gewähren.
- Melden Sie sich im Backend von ideal.shop an.
- Gehen Sie zu Indstillinger > Integrationer > API.
- Erstellen Sie einen neuen API-Benutzer.
- Aktivieren Sie das Kontrollkästchen Aktiv neben dem API-Benutzer. API-Benutzer werden nicht automatisch aktiviert und die Integration funktioniert erst, wenn der Benutzer aktiv ist.
- Notieren Sie sich den API Username und den API code, die für den Benutzer angezeigt werden. Sie benötigen beide während der Einrichtung.
AI Integration #
Verwenden Sie die API-Anmeldedaten, um die Integration über Ask Clerk.io einzurichten.
- Öffnen Sie in my.clerk.io den passenden Store und gehen Sie zu Ask Clerk.io.
- Bitten Sie um die Einrichtung einer AI Integration für ideal.shop, die alle Datentypen abdeckt. Geben Sie Ihre Webshop-URL an.
- Geben Sie den API Username und den API code an, wenn Anmeldedaten angefordert werden.
- Geben Sie Ihre Sitemap-URL an und bitten Sie darum, Inhaltsseiten als Teil derselben Integration abzurufen, wie in Import Pages beschrieben.
- Überprüfen Sie die Testergebnisse und Beispieldatensätze, bevor Sie die Einrichtung abschließen und die Integration an Data Sync übergeben.
- Öffnen Sie Data > Configuration, starten Sie einen Datenabgleich und kontrollieren Sie importierte Mengen und Datensätze.
Stellen Sie sicher, dass der erste Import den gesamten Katalog und die gewünschte Bestellhistorie abdeckt und dass die laufenden Importe alle Bestellungen seit der letzten erfolgreichen Synchronisierung enthalten. Siehe Data Sync für Zeitplanung, Status und Protokolle.
Import Pages #
Artikel und andere Inhaltsseiten benötigen eigene Datensätze, bevor sie in Search angezeigt werden oder Kontext für seitenbasierte Empfehlungen bieten können.
Seiten müssen weiterhin über die Sitemap des Webshops abgerufen werden. Schließen Sie dies in dieselbe AI Integration wie den API-Import ein; eine separate Seitenintegration ist nicht erforderlich.
Geben Sie die Sitemap-URL in Ask Clerk.io an und erläutern Sie, welche Seitentypen eingeschlossen bzw. ausgeschlossen werden sollen. Bitten Sie darum, Sitemap-Indizes und deren Child-Sitemaps zu entdecken, die gewünschten Seiten abzurufen und Beispieldatensätze zur Überprüfung vorzuschlagen.
Für Fodmagasinet ist die Beispielquelle zur Entdeckung https://www.fodmagasinet.dk/sitemap.xml, wobei die Startseite und URLs mit /vare ausgeschlossen werden. Diese Regeln passen zur URL-Struktur dieses Webshops; prüfen Sie Ihre eigene Sitemap, bevor Sie Filter auswählen.
Validieren Sie jeden Beispieldatensatz:
- Eine stabile, eindeutige ID, die mit der Storefront-Artikel-ID übereinstimmt, wenn seitenbasierte Empfehlungen verwendet werden.
- Den korrekten Titel, die kanonische URL und nützlichen Artikelinhalt ohne Header-, Footer- oder Navigationstexte.
- Keine doppelten URLs, Produktseiten, Kategorielisten oder andere unerwünschte Seitentypen.
Falls der Importer abweichende IDs von denen aus dem Theme erzeugt, stimmen Sie mit dem Entwickler eine Zuordnung ab, bevor Sie Artikel-Empfehlungen konfigurieren. Überprüfen Sie importierte Beispiele und Mengen nach dem ersten Durchlauf.
Das Importieren und Anzeigen der Seiten sind getrennte Schritte. Das Search Design muss ebenfalls Seiten-Ergebnisse rendern; siehe Search.
Native Feed #
Der native JSON-Feed ist eine Alternative für bestehende feedbasierte Setups. Die untenstehenden Limits gelten für diesen Feed, nicht für die empfohlene API-basierte AI Integration.
Aktivieren Sie zunächst die Integration, einschließlich Feed offentligt.
Feed konfigurieren #
Ohne explizite Begrenzungen liefert der Feed pro Datentyp bis zu 50 Datensätze. Legen Sie separate Produkt-, Kategorie- und Bestelllimits für den ersten historischen Import fest.
- Öffnen Sie in ideal.shop Indstillinger > Integrationer > Clerk.io.
- Kopieren Sie die URL unter Sti til feed.
- Hängen Sie bei einer URL ohne Query-Parameter
?&products=10000&categories=10000&orders=10000an:
https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000&orders=10000
Falls Ihre URL bereits eine Query-String hat, hängen Sie die Parameter mit & an und behalten Sie alle erforderlichen existierenden Parameter. Fügen Sie kein zweites ? hinzu oder duplizieren Sie kein vorhandenes Limit.
Diese Werte fordern bis zu 10.000 Datensätze jedes genannten Typs an. Erhöhen Sie jedes Limit bei Bedarf; 10.000 ist ein Beispiel und garantiert keinen vollständigen Export. Andere Datentypen behalten ihre Standardwerte, sofern nicht separat konfiguriert.
Zum Beispiel nutzt Fodmagasinets Feed dieselbe Syntax auf 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 Limits gelesen wird.
- Öffnen Sie in my.clerk.io den passenden Store und gehen Sie zu Data > Configuration.
- Wählen Sie Clerk.io JSON Feed als Sync-Methode aus.
- Fügen Sie die Feed-URL ein und speichern Sie die Konfiguration.
- Klicken Sie auf Start New Data Sync und warten Sie auf den Abschluss.
- Vergleichen Sie die importierte Anzahl mit den exportierbaren Gesamtsummen des Webshops und berücksichtigen Sie absichtlich ausgeschlossene Datensätze.
Eine Anzahl, die dem angeforderten Limit entspricht, kann auf eine Kürzung hindeuten. Erhöhen Sie dann dieses Limit und synchronisieren Sie erneut. Überprüfen Sie sowohl die älteste importierte Bestellung als auch die Gesamtsumme; eine erfolgreiche Synchronisierung kann trotzdem nur einen Teil der Historie enthalten.
Siehe Data Sync für Status und Protokolle oder die feed FAQ zu Kürzung und Timeouts.
Laufende Importe #
Entfernen Sie nach dem ersten erfolgreichen historischen Import &orders=10000. Behalten Sie die Limits für den gesamten Katalog bei:
https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000
Durch das Entfernen von orders wird die Standardeinstellung von 50 neuesten Bestellungen wiederhergestellt. Die Bestellung-Importe werden dadurch nicht deaktiviert. Clerk.io behält bereits importierte Bestellungen, sodass der laufende Feed nur die neuesten Bestellungen abdecken muss.
Vergleichen Sie vor der Nutzung der Standardeinstellung das Bestellvolumen des Webshops mit dem Intervall zwischen erfolgreichen Synchronisierungen, einschließlich Verzögerungen oder fehlgeschlagenen Syncs. Prüfen Sie, dass die älteste zurückgegebene Bestellung mit dem letzten erfolgreichen Import überlappt und dass alle Bestellungen seitdem vorhanden sind.
Wenn 50 Bestellungen dieses Intervall nicht abdecken können, behalten Sie ein explizites orders-Limit bei, das groß genug ist, um es mit Überlappung abzudecken. Hängen Sie z.B. &orders=500 nur an, wenn dies Ihr Volumen abdeckt. Überprüfen Sie nach einer Sync-Störung oder einem erhöhten Bestellvolumen erneut.
Behalten Sie products und categories immer so hoch, dass der gesamte aktuelle Katalog bei jedem Sync abgedeckt ist. Reduzieren Sie diese Werte nach einmaligem Import nicht auf den Standard.
Daten validieren #
Ein erfolgreicher Status und plausible Mengen beweisen nicht, dass die Daten mit dem Shop-Frontend übereinstimmen. Vergleichen Sie repräsentative importierte Datensätze mit dem tatsächlichen Webshop.
| Prüfung | Was zu überprüfen ist |
|---|---|
| Kategorien | Versteckte oder unveröffentlichte Kategorien sind wie beabsichtigt ausgeschlossen. Produkt-Kategorie-Verweise lösen sich auf die richtigen importierten Kategorie-Datensätze auf. |
| Verfügbarkeit | Produkte mit Lagerbestand, ohne Lagerbestand und nicht verfügbare Produkte verhalten sich in Ergebnissen und beim Kauf wie beabsichtigt. Bestätigen Sie Bedeutung und Typ der Lagerbestandfelder. |
| Bilder | Bilder bleiben in der tatsächlichen Kartengröße auf Desktop und Mobilgeräten, einschließlich hochauflösender Bildschirme, scharf. |
| Preise | Eltern- und Variantenpreise stimmen mit der Währung, der Steuerbehandlung und den Rabatten des Webshops überein. Überprüfen Sie Nullpreise und Produkte mit mehreren Variantenpreisen. |
| Rabatte | Das Feld für den regulären Preis existiert und ist höher als der Verkaufspreis, bevor ein durchgestrichener Preis oder ein Rabatt-Badge angezeigt wird. |
| Seiten | Titel, URLs, Inhalte und Artikel-IDs stimmen mit den gewünschten Inhaltsseiten überein. |
Siehe Kartendaten für die Anzeige von Preisen und die FAQ für Bild- und Quell-Datenprobleme.
Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.