Wie können wir helfen?
Produktdaten als CSV Datei
CSV-Datei erstellen
Um Ihre Produktdaten als CSV-Datei für den Import vorzubereiten, haben Sie mehrere Möglichkeiten zur Auswahl. Wir empfehlen die Verwendung unseres Excel-Templates, mit welchem Sie ihre Spaltenbezeichnungen mit einen Klick validieren und anschließend die Datei als CSV exportieren können.
Alternativ steht Ihnen ein CSV-Template zur Verfügung, welches Sie idealerweise mit Libre Office öffnen können.
HINWEIS: Dateien im CSV-Format sollten nicht direkt mit Excel geöffnet und bearbeitet werden, da es beim Speichern zu Formatierungsfehlern aufgrund falscher Dekodierung kommen kann. So wird beispielsweise ä als ä angezeigt. Das liegt daran, dass Microsoft Excel den Unicode-Zeichensatz von CSV-Dateien nicht prüft und stattdessen ungeprüft annimmt, dass der Inhalt einer CSV-Datei einem Windows-spezifischen Zeichensatz (Windows-1252) entspricht.
Um dennoch eine CSV-Datei mit Microsoft Excel zu öffnen, die UTF-8 als Zeichenkodierung (wie die CSV) verwendet, befolgen Sie bitte folgende Schritte:
- Öffnen Sie Microsoft Excel
- Wählen Sie in der Menüleiste den Reiter „Daten“ aus
- Klicken Sie anschließend auf die Option „Aus Text/CSV“ in der linken oberen Ecke
- Nun öffnet sich ein Dialogfeld. Navigieren Sie zum Speicherort der CSV-Datei, die Sie importieren möchten und importieren Sie diese mittels Doppelklick. Alternativ wählen Sie den gewünschten Dateinamen und klicken anschließend auf „Importieren“.
- Nun bestimmen Sie das Format der CSV-Datei. Wählen Sie hierfür als Dateiursprung „65001: Unicode (UTF-8)“ aus der Dropdown-Liste aus. Anschließend wählen Sie als Trennzeichen in einem weiteren Dropdown „Semikolon“ aus.
- Bestätigen Sie den Import anschließend mit Klick auf „Laden“
Als weitere Alternative können Sie mit einem neu angelegten Excel-Dokument starten, welches Sie als CSV-Datei speichern müssen. Wählen Sie auch hier beim Speichern das Dateiformat CSV UTF-8 Zeichencode.
Ergebnisseite mittels CSV-Spaltennamen konfigurieren
Die Ergebnisseite können Sie bis zu einem bestimmten Grad frei konfigurieren. Die jeweiligen Spalten, die in Ihrer CSV-Datei benannt sind (zB. productName, shortDescription, usw.), können im Selector in der Zeile DataSourceColumn ausgewählt und zugeordnet werden. Diese Spalten können auf der Ergebnisseite angezeigt werden.
So gelangen Sie zur Option DataSourceColumn: Scrollen Sie im Menü unter Result Page zum Bereich Result Page Product Sections, klicken Sie auf Add Section und wählen Sie anschließend einen der angezeigten Bausteine aus. Beispielsweise können Sie mit dem Baustein Title die Produktnamen (productName) und mit dem Baustein Additional Data weitere Texte wie die Vorteile (benefits) und Beschreibungen (shortDescription) auf der Ergebnisseite für jedes empfohlene Produkt anzeigen lassen. Im Kapitel zur Ergebnisseite sind die weiteren Bausteine für die Result Page Product Sections erklärt.
Die Verbindung der CSV-Datei mit dem Backend zum Frontend sieht wie folgt aus:
Sie können die Produktempfehlung für den Nutzer im Frontend Stück für Stück konfigurieren. Die notwendigen Informationen legen Sie in der CSV-Datei an. Diese wird unter Product Upload hochgeladen. Per DataSourceColumn können Sie auf die Informationen in der Spalte zugreifen, indem Sie die Spaltenbezeichnung wählen. Im Frontend wird dann die entsprechende Produktinformation angezeigt.
Anforderungen an die CSV-Datei
Mit den folgenden Anforderungen erstellen Sie eine für Ihren Selector funktionierende CSV-Datei:
- Die Spalten in der CSV können beliebig benannt werden, es muss jedoch in der ersten Spalte die eindeutige “id” (ProduktID) gesetzt werden.
- Zusätzlich muss das Feld “productName” (der Produktname) geliefert werden, damit es in der Matrix angezeigt wird.
- Führen Sie eine Spalte “picture“ (URL zum Produktbild) auf, in der sie Ihre Produktbilder als Link zu einer öffentlich verfügbaren Quelle eintragen können.
- In den Spaltennamen dürfen keine Leerzeichen und Umlaute vorkommen. Wenn Sie mehrere Wörter als Spaltenname benutzen möchten, können Sie diese bspw. mit großen Anfangsbuchstaben zusammenschreiben („productName“) oder durch Unterstrich trennen („link_zum_Datenblatt“).
- Die Inhalte der CSV-Spalten können mit sauber formatiertem HTML-Code eingespielt und ausgelesen werden.
Sie möchten z.B. Produktvorteile auf der Ergebnisseite als Liste mit Stichpunkten darstellen? Listen können mit <ul><li>text1</li><li>text2</li></ul> als Stichpunkte oder mit <ol><li>text1</li><li>text2</li></ol> als Aufzählung dargestellt werden.
Absätze werden mit <br> eingefügt. Laden Sie oben unser Excel-Template herunter, um in Spalte E ein Beispiel für eine Stichpunktliste zu sehen.
- Die CSV-Datei muss mit dem Zeichencode UTF-8 abgespeichert und Semikolon als Trennzeichen verwenden. Unser CSV-Template ist bereits in diesem Format gespeichert.
