Überblick über Custom CSV Datenquellen
Custom CSV Datenquellen ermöglichen es Ihnen, Produktdaten in einem standardisierten CSV-Format (Comma-Separated Values) zu importieren und zu verarbeiten. Diese Lösung eignet sich besonders für Unternehmen, die ihre Daten in einem eigenen Format verwalten oder eine flexible Alternative zu vordefinierten Kanälen benötigen. Mit Custom CSV können Sie die Feldstruktur vollständig selbst bestimmen und an Ihre spezifischen Anforderungen anpassen.
Die CSV-Integration bietet maximale Flexibilität bei der Datenimport-Einrichtung. Sie definieren, welche Spalten in Ihrer CSV-Datei vorhanden sind und wie diese auf Ihr internes Datenmodell abgebildet werden. Dies ermöglicht es Ihnen, Daten aus verschiedensten Quellen zu konsolidieren und in einem einheitlichen Format zu verarbeiten.
Grundstruktur und Anforderungen an CSV-Dateien
Eine gültige CSV-Datei für den Datenimport muss folgende Bedingungen erfüllen:
- Kopfzeile erforderlich: Die erste Zeile der Datei muss die Feldnamen enthalten. Diese Feldnamen werden später für das Mapping verwendet.
- Konsistente Spaltenanzahl: Jede Datenzeile muss die gleiche Anzahl von Spalten aufweisen wie die Kopfzeile.
- Zeichenkodierung: UTF-8 Kodierung wird empfohlen, um Sonderzeichen korrekt zu verarbeiten.
- Feldtrennzeichen: Das Komma ist das Standard-Trennzeichen. Sollten Ihre Daten Kommas enthalten, müssen diese Felder in Anführungszeichen eingeschlossen sein.
- Zeilenenumbrüche: Verwenden Sie konsistente Zeilenenumbrüche (LF oder CRLF).
Beispiel einer gültigen CSV-Struktur:
product_id,product_name,price,availability,category
"SKU001","Blaue Laufschuhe","89.99","in_stock","Sportschuhe"
"SKU002","Schwarze Laufschuhe","94.99","in_stock","Sportschuhe"
Die Feldnamen in der Kopfzeile können beliebig gewählt werden, da Sie diese später beim Feldmapping definieren.
Feldmapping und Datenquellen konfigurieren
Nach dem Upload Ihrer CSV-Datei müssen Sie die Feldmappings einrichten. Dabei ordnen Sie die Spalten aus Ihrer CSV-Datei den erforderlichen Zielfeldern zu. Das Mapping bestimmt, wie die Rohdaten interpretiert und verarbeitet werden.
Pflichtfelder beim Mapping
Bestimmte Felder sind essentiell für die Datenverarbeitung:
| Feld | Beschreibung | Auswirkung auf Datenqualität |
|---|---|---|
| id | Eindeutige Produktkennung | Ohne id können Produkte nicht eindeutig identifiziert werden. Duplikate entstehen. |
| title | Produktname oder Titel | Fehlende oder unvollständige Titel führen zu Ablehnungen bei Zielkanälen. |
| price | Verkaufspreis | Ungültige oder fehlende Preise verhindern die Listung in den meisten Kanälen. |
| availability | Verfügbarkeitsstatus | Falsche Verfügbarkeitsinformationen führen zu Bestellungsausfällen und Kundenbeschwerden. |
| link | URL zur Produktseite | Ohne link können Kunden nicht auf die Produktseite gelangen. |
| image_link | URL zum Produktbild | Fehlende Bilder reduzieren die Konversionsrate erheblich. |
| description | Produktbeschreibung | Detaillierte Beschreibungen verbessern SEO und Verständlichkeit. |
| brand | Herstellermarke | Markenfeldmappings sind für Filterung und Suche notwendig. |
| condition | Produktzustand (neu, gebraucht) | Falsche Zustandsangaben führen zu Rückgaben und Ablehnungen. |
| product_type | Produktkategorie oder Typ | Korrekte Kategorisierung ist für Navigation und Targeting wichtig. |
| google_product_category | Google Produktkategorie | Viele Zielkanäle benötigen die standardisierte Google-Kategorie. |
| gtin | Barcode oder EAN | GTIN-Felder sind für Deduplizierung und Kanalintegration erforderlich. |
| mpn | Herstellerteile-Nummer | MPN ermöglicht Produktabstimmung über verschiedene Datenquellen hinweg. |
| item_group_id | Varianten-Gruppierungs-ID | item_group_id verbindet Varianten desselben Produkts. |
Optionale und erweiterte Felder
Zusätzlich zu den Pflichtfeldern können Sie weitere Felder mappen, um die Datenqualität zu erhöhen:
- Größe und Gewicht für versandrelevante Berechnungen
- Farbe und Materialangaben für bessere Filterung
- Lagerbestände für Verfügbarkeitsprognosen
- Kundenbewertungen und Rezensionen
- Rabatte und Aktionspreise
- Lieferzeit und Versandkosten
Das Mapping dieser optionalen Felder verbessert die Listungsqualität und kann zu höheren Konversionsraten führen.
Praktische Anleitung zur Datenimport-Einrichtung
Folgen Sie diesen Schritten, um Custom CSV Datenquellen erfolgreich zu konfigurieren:
Schritt 1: CSV-Datei vorbereiten
Exportieren Sie Ihre Produktdaten aus Ihrem Quellsystem (ERP, Shop-Datenbank, Katalog-Management-System) in das CSV-Format. Überprüfen Sie, dass:
- Alle erforderlichen Spalten vorhanden sind
- Die Daten konsistent und vollständig sind
- Keine Formatierungsfehler vorliegen
- Die Dateicodierung UTF-8 ist
Schritt 2: CSV-Datei hochladen
Laden Sie die CSV-Datei in das System hoch. Das System analysiert automatisch die Kopfzeile und erkennt die verfügbaren Spalten. Überprüfen Sie in der Vorschau, ob alle Spalten korrekt erkannt wurden.
Schritt 3: Feldmappings definieren
Ordnen Sie jede Spalte aus Ihrer CSV-Datei einem Zielfeld zu. Für kritische Felder wie id, title, price und availability ist das Mapping obligatorisch. Alle anderen Felder sind optional, aber das Mapping zusätzlicher Felder verbessert die Datenqualität.
Beispiel eines Mappings:
- CSV-Spalte "product_id" → Zielfeld id
- CSV-Spalte "product_name" → Zielfeld title
- CSV-Spalte "sale_price" → Zielfeld price
- CSV-Spalte "stock_status" → Zielfeld availability
- CSV-Spalte "product_url" → Zielfeld link
- CSV-Spalte "image_url" → Zielfeld image_link
- CSV-Spalte "long_description" → Zielfeld description
- CSV-Spalte "manufacturer" → Zielfeld brand
- CSV-Spalte "ean_code" → Zielfeld gtin
Schritt 4: Datenvalidierung und Vorschau
Nach dem Mapping zeigt das System eine Vorschau der verarbeiteten Daten. Überprüfen Sie:
- Dass Preise korrekt formatiert sind (Dezimalstellen, Währung)
- Dass Verfügbarkeitswerte erkannt werden
- Dass URLs gültig sind
- Dass Bilder korrekt zugeordnet sind
Fehlerhafte Zeilen werden markiert und können vor dem Import korrigiert werden.
Schritt 5: Regelmäßige Aktualisierungen
Nach dem initialen Import können Sie die CSV-Datei regelmäßig aktualisieren. Das System erkennt neue und geänderte Produkte anhand der id und aktualisiert bestehende Einträge oder fügt neue hinzu.
CSV-Dateien verarbeiten und Fehlerbehandlung
Bei der Verarbeitung von CSV-Dateien können verschiedene Fehler auftreten. Das System validiert die Daten automatisch und meldet Probleme:
Häufige Fehler und Lösungen
Fehlende Pflichtfelder: Wenn id, title, price oder availability nicht gemappt sind, wird der Import blockiert. Überprüfen Sie das Mapping und stellen Sie sicher, dass alle erforderlichen Felder zugeordnet sind.
Ungültige Datenformate: Preise müssen numerisch sein (z.B. "89.99", nicht "EUR 89,99"). Verfügbarkeitswerte sollten standardisiert sein (z.B. "in_stock", "out_of_stock"). Korrigieren Sie die Daten in der Quelle und laden Sie die Datei erneut hoch.
Duplizierte IDs: Wenn mehrere Zeilen die gleiche id haben, wird nur eine verarbeitet. Überprüfen Sie Ihre Datenquelle auf Duplikate und stellen Sie sicher, dass jedes Produkt eine eindeutige ID hat.
Ungültige URLs: Bild- und Produktlinks (image_link, link) müssen gültige URLs sein. Überprüfen Sie, dass URLs mit "http://" oder "https://" beginnen.
Zeichenkodierungsfehler: Sonderzeichen (Umlaute, Akzente) können falsch angezeigt werden, wenn die Datei nicht in UTF-8 codiert ist. Speichern Sie die CSV-Datei in UTF-8 Kodierung.
Das System generiert einen Fehler-Report nach jedem Import. Überprüfen Sie diesen Report und beheben Sie Fehler, bevor Sie den Import erneut ausführen.
Technische Datenverbindungen und erweiterte Konfiguration
Für fortgeschrittene Anwendungen können Sie automatisierte Datenquellen-Verbindungen einrichten. Dies ermöglicht es Ihnen, CSV-Dateien automatisch zu bestimmten Zeiten hochzuladen und zu verarbeiten.
Automatisierter Datenimport
Wenn Sie regelmäßig aktualisierte Daten benötigen, können Sie einen automatisierten Importprozess konfigurieren:
- Zeitplan: Legen Sie fest, wie oft die Datei aktualisiert wird (täglich, wöchentlich, monatlich).
- Quelle: Verbinden Sie eine externe Datenquelle (FTP-Server, Cloud-Storage, API) zum automatischen Download.
- Validierung: Das System validiert die Datei automatisch und benachrichtigt Sie bei Fehlern.
- Versionskontrolle: Frühere Versionen werden gespeichert, falls Sie auf eine vorherige Version zurückgreifen müssen.
Transformation und Bereinigung
Bei der Verarbeitung können Sie Daten transformieren:
- Standardisierung: Konvertieren Sie Verfügbarkeitswerte in standardisierte Formate.
- Bereinigung: Entfernen Sie Leerzeichen und Sonderzeichen aus Feldern.
- Berechnung: Leiten Sie Felder ab (z.B. Verkaufspreis aus Listenpreis und Rabatt).
- Filterung: Importieren Sie nur Produkte, die bestimmte Kriterien erfüllen.
Zusammenfassung und Best Practices
Custom CSV Integration bietet Ihnen vollständige Kontrolle über Ihre Datenimport-Einrichtung. Durch sorgfältiges Mapping und regelmäßige Validierung stellen Sie sicher, dass Ihre Produktdaten korrekt verarbeitet werden.
Beachten Sie diese Best Practices:
- Überprüfen Sie regelmäßig die Datenqualität Ihrer CSV-Dateien.
- Mappen Sie mindestens alle Pflichtfelder (id, title, price, availability, link, image_link).
- Verwenden Sie konsistente Datenformate (Preise, Verfügbarkeit, URLs).
- Testen Sie neue Mappings mit einer kleinen Datenmenge, bevor Sie den vollständigen Import durchführen.
- Überwachen Sie die Fehler-Reports nach jedem Import und beheben Sie Probleme zeitnah.
- Dokumentieren Sie Ihre Mappings, damit andere Benutzer diese verstehen und warten können.
- Nutzen Sie automatisierte Importe für regelmäßige Datenaktualisierungen.
Durch die Befolgung dieser Richtlinien optimieren Sie Ihre Datenqualität und stellen sicher, dass Ihre Produkte in allen Zielkanälen korrekt dargestellt werden.