Produktdaten mittels CSV-Datei exportieren

Wenn Sie sich für das CSV Steht für „Comma-Separated Values“. Eine Textdatei mit Tabellendaten, die durch Kommazeichen voneinander getrennt sind.-Format entscheiden, stellen Sie Ihre Produktdaten in zwei Schritten bereit:

  1. Sie exportieren Ihre Produktdaten aus Ihrem E-Commerce-System oder aus einer anderen Datenquelle in eine CSV-Datei.
  2. Sie übertragen die CSV-Datei in Ihr persönliches Verzeichnis auf dem Server. Von dort holt Optimizely Campaign die CSV-Datei ab und stellt Ihnen die darin enthaltenen Produktdaten im Template-Kit für Ihre Nachrichten zur Verfügung.

Wenn Sie keinen Zugriff und ein persönliches Verzeichnis auf dem Server besitzen, wenden Sie sich an die Kundenbetreuung.

Exportieren Sie Ihre Produktdaten als CSV-Datei aus Ihrem System. Aus unterschiedlichen Systemen exportierte CSV-Dateien können sich stark unterscheiden. Beispielweise sind die Benennungen und die Reihenfolge der Spaltenüberschriften anders. Abweichungen führen zu Problemen beim Import Ihrer Produktdaten. Wenn nicht festgelegt ist, in welcher Spalte genau sich welche Art von Datensatz befindet, kann Optimizely Campaign Ihre CSV-Dateien nicht entsprechend auslesen und die einzelnen Datensätze korrekt zuordnen.

Wenn Sie eine Optimizely Integration für eins der folgenden E-Commerce-Systeme nutzen, erkennt die Content-Schnittstelle unterschiedlich aufgebaute CSV-Dateien und verarbeitet diese fehlerfrei:

  • Magento
  • OXID
  • Shopware

Wenn Sie eine Optimizely Integration für eins der genannten Systeme verwenden, können Sie Ihre Produktdaten ohne weitere Anpassung mit Hilfe des Optimizely Plugins exportieren.

Wenn Sie keine Optimizely Integration nutzen, müssen Sie den von Optimizely Campaign generischen CSV-Aufbau verwenden.

Generischer CSV-Aufbau

Der generische CSV-Aufbau von Optimizely Campaign standardisiert die Struktur und das Benennungsschema der Spaltenüberschriften Ihrer CSV-Dateien.

Wenn Ihr System/Ihre Datenquelle über eine Export-Funktion von Datensätzen in eine CSV-Datei verfügt (z. B. ein Plugin), konfigurieren Sie die Export-Funktion Ihres Systems nach dem folgenden Aufbau und mit den folgenden Spaltenüberschriften:

"id";"name";"category";
"text1";"text2";"text3";"text4";"text5";
"text6";"text7";"text8";"text9";"text10";
"link1Text";"link1Url";
"link2Text";"link2Url";
"link3Text";"link3Url";
"image1ImageUrl";"image1AltText";"image1Link";
"image2ImageUrl";"image2AltText";"image2Link";
"image3ImageUrl";"image3AltText";"image3Link";
"image4ImageUrl";"image4AltText";"image4Link";
"image5ImageUrl";"image5AltText";"image5Link";
"image6ImageUrl";"image6AltText";"image6Link";
"additionalData1";"additionalData2";"additionalData3";"additionalData4";"additionalData5";
"additionalData6";"additionalData7";"additionalData8";"additionalData9";"additionalData10";
"additionalData11";"additionalData12";"additionalData13";"additionalData14";"additionalData15";
"additionalData16";"additionalData17";"additionalData18";"additionalData19";"additionalData20";

Die Konfiguration einer Export-Funktion ist in der Regel mit Programmieraufwand verbunden.

Wenn Sie die Export-Funktion Ihres Systems konfigurieren, achten Sie auf die folgenden Punkte:

  • Die CSV-Datei muss RFC-konform formatiert sein. Technische Hinweise finden Sie im RFC 4180.
  • Sie müssen die Zeichenkodierung der CSV-Datei auf UTF-8 without BOM einstellen.
  • Sie müssen das Semikolon (;) als Trennzeichen verwenden.
  • Wenn einzelne Produktdaten Anführungszeichen enthalten, müssen Sie diese mit Fluchtsymbolen, mit sogenannten Escaped Characters, maskieren. Wenn Sie Anführungszeichen in Ihren Textbausteinen nicht maskieren, werden diese als Code fehlinterpretiert und der Import Ihrer Produktdaten schlägt fehl. Verwenden Sie als Fluchtsymbol das Anführungszeichen ".

    Beispiel: Wenn Sie in Ihrem Text ein Wort oder eine Wortgruppe in Anführungszeichen setzen, zum Beispiel "Savoir Vivre", dann müssen Sie "Savoir Vivre" in Ihrer CSV-Datei mit doppelten Anführungszeichen umrahmen, also ""Savoir Vivre"". Die äußeren Anführungszeichen werden automatisch als Fluchtsymbole erkannt und später nicht in Ihrem Nachrichtentext dargestellt.

CSV-Datei manuell aufbereiten

Falls Ihr System über keine Export-Funktion von Produktdatensätzen in eine CSV-Datei verfügt und Sie manuell eine CSV-Datei mit Ihren Produktdaten erstellen möchten, führen Sie die folgenden Schritte aus:

  1. Laden Sie die Vorlage für den generischen CSV-Aufbau hier herunter: Optimizely Vorlage generischer Aufbau.csv
  2. Öffnen Sie die Vorlage mithilfe eines Tabellenkalkulationsprogramms, beispielsweise mit Microsoft Excel oder LibreOffice Calc.

    Bild: Tabellenvorlage

    Wenn Sie beim Öffnen der Vorlage zunächst das Trennzeichen und die Zeichenkodierung angeben müssen, wählen Sie das Semikolon als Trennzeichen und UTF 8 without BOM für die Zeichenkodierung aus. Manche Programme wie Microsoft Excel bieten nicht die Option UTF-8 without BOM an. In diesem Fall wählen Sie UTF-8 aus.

    Wenn Sie die Optimizely Vorlage für den generischen CSV-Aufbau ausfüllen, müssen Sie stets folgenden Punkt beachten:

    Falls einzelne Ihrer Produktdaten im Text Anführungszeichen enthalten, müssen Sie die Anführungszeichen mit Fluchtsymbolen, mit sogenannten Escaped Characters, maskieren. Verwenden Sie als Fluchtsymbol das Anführungszeichen ". Wenn Sie die Anführungszeichen in Ihren Texten nicht mit weiteren Anführungszeichen maskieren, werden diese als Code fehlinterpretiert und der Import Ihrer Produktdaten schlägt fehl.
    Beispiel: Einer Ihrer Textbausteine Ihres Produktangebots lautet: Genießen Sie in Paris das "Savoir Vivre". Das "Savoir Vivre" steht hier in Anführungszeichen. Sie müssen das "Savoir Vivre" in Ihrer CSV-Datei mit doppelten Anführungszeichen umrahmen, also ""Savoir Vivre"". Die äußeren Anführungszeichen werden automatisch als Fluchtsymbole erkannt und später nicht in Ihrem Nachrichtentext dargestellt.

  3. Beginnen Sie in Zeile 2 mit dem Ausfüllen Ihrer Produktdaten. Die einzelnen Daten jedes einzelnen Produkts werden nebeneinander eingetragen (siehe Bild).

    Verändern Sie nicht die Spaltenbeschriftungen und deren Reihenfolge in Zeile 1. Andernfalls können Ihre Produktdaten später nicht ins Template-Kit geladen werden.

    Bild: Produktdaten eingeben

    Wenn Sie ein weiteres Produktangebot hinzufügen möchten, setzen Sie die Daten wieder nebeneinander in die nächste Zeile (siehe Bild).

    Bild: Weitere Produktdaten eingeben

    4. Spaltenbeschriftung in der Vorlage Einzutragende Produktdaten
    id Tragen Sie hier die eindeutige Produkt-ID ein. Die Produkt-ID wird später nicht angezeigt in Ihren Nachrichten. Sie dürfen eine Produkt-ID innerhalb des Dokuments nur ein einziges Mal vergeben.
    name Vergeben Sie hier einen Namen für Ihr Produktangebot. Anhand des Namens wählen Sie später im Template-Kit das Produktangebot aus, um es in Ihre Nachrichten zu übernehmen (nur statischer CSV-Artikel). Der Produktname selbst wird später nicht in Ihren Nachrichten angezeigt.

    category

    		Tragen Sie hier die Produktkategorie ein. Die Produktkategorie wird später nicht angezeigt in Ihren Nachrichten. Mit Hilfe der Produktkategorie können Sie im Template-Kit übersichtliche Kategorie-Bäume anlegen und z. B. verwandte Produkte zusammenfassen, um einzelne Produkte schnell wiederzufinden (nur statischer CSV-Artikel). Die einzelnen Unterkategorien tragen Sie per Raute in dieses Feld ein.
    Beispiel: Mittelmeerreisen#Italien#Sizilien

    Eine Kategorie darf maximal 10 Unterkategorien haben.
    text1 – text10 Ihnen stehen insgesamt 10 Textfelder zur Verfügung. Tragen Sie hier jeweils eine Information ein. Zum Beispiel:
    • die Überschrift Ihres Produktangebots, bspw. in das Textfeld text1
    • den Namen des Produkts, der in Ihrer Nachricht angezeigt werden soll, bspw. in das Textfeld text2
    • die Beschreibung Ihres Produkts, bspw. in das Textfeld text3
    • den alten Preis Ihres Produkts, bspw. in das Textfeld text4
    • den aktuellen Preis Ihres Produkts, bspw. in das Textfeld text5
    • den Anbieter/Hersteller Ihres Produkts, bspw. in das Textfeld text6

    Sie sind frei in der Wahl, was Sie in die Textfelder setzen möchten. Passen Sie die Inhalte entsprechend Ihren Wünschen und den Erfordernissen Ihres Produkts/Ihrer Dienstleistung an.

    In der Regel empfiehlt sich, die einzelnen Bestandteile Ihres Produktangebots chronologisch von text1 bis text 10 zu verteilen, wie diese später auch von oben nach unten im fertigen Produktangebot angezeigt werden sollen. Wenn Sie sich nicht sicher sind, welche Reihenfolge sich für Sie am besten empfiehlt, wenden Sie sich an die Kundenbetreuung.

    Die Formatierung (zum Beispiel Schriftgröße und Schriftfarbe) der einzelnen Textfeld-Inhalte werden später gesondert über ein HTML-Layout gesteuert.
    link1Text – link3Text Geben Sie hier die Beschriftung des oder der Links zu Ihrem Produktangebot ein.

    Zum Beispiel: Zum Angebot, Mehr Informationen oder Jetzt kaufen.
    link1Url – link3Url Geben Sie hier den Link oder die Links zu der Seite beziehungsweise den Seiten ein, auf die der Empfänger geleitet werden soll, wenn er den Link klickt (z. B. die entsprechende Produkt-Seite in Ihrem Webshop).
    image1ImageUrl –
    image6ImageUrl         		Geben Sie hier die URLs zu den entsprechenden Produktbildern an. Die Produktbilder werden später automatisch von Optimizely Campaign geladen und in Ihren Nachrichten angezeigt.
    image1AltText – image6AltText Geben Sie hier die Alternativ-Texte Ihrer Bilder ein. Ein Alternativ-Text ist der Text, der angezeigt wird, wenn ein Bild nicht geladen werden kann. Tragen Sie stets Alternativ-Texte ein, denn diese können auch sehbehinderten Menschen von speziellen Programmen vorgelesen werden und fördern die Barrierefreiheit im Internet.
    image1Link – image6Link Tragen Sie hier einen Link ein, der mit dem Produktbild verknüpft werden soll. Wenn ein Empfänger später auf das Bild klickt, wird er zum Ziel des verknüpften Links geführt. Dies kann Ihr Webshop sein oder auch jede andere Adresse, die Sie mit dem Bild in Zusammenhang bringen möchten.

    Verwechseln Sie nicht den ImageLink mit der ImageURL, die zum Speicherort des Bildes führt.

    additionalData1 –
    additionalData20         		Geben Sie hier weitere Datensätze an, die Sie zum Beispiel als Metadaten für die Programmlogik der HTML-Layouts nutzen können.
  4. Speichern Sie die Datei und benennen Sie die Datei um.

    Sie müssen die Datei mit dem Namen umbenennen, den Sie bei der Einrichtung des Content-Schnittstellen-Paragraphen für Ihre CSV-Datei angegeben haben. Wenn Sie einen anderen Namen verwenden, schlägt der Import Ihrer Produktdaten fehl. Wenn Sie den korrekten Namen vergessen haben, wenden Sie sich an die Kundenbetreuung.

    Achten Sie zudem beim Speichern der Datei darauf, dass das Tabellenkalkulationsprogramm keinen neuen Dateitypen vergibt. Sie müssen die Datei stets mit dem Dateitypen CSV beziehungsweise der Dateiendung .csv speichern.

CSV-Datei auf den Optimizely Server übertragen

Wenn Sie die ausgefüllte und umbenannte CSV-Vorlage gespeichert haben, müssen Sie diese in Ihr persönliches Verzeichnis auf dem Optimizely Server übertragen.

Wenn Sie eine Optimizely Integration für Magento, OXID oder Shopware nutzen, erfolgt die Übertragung automatisch. Wenn Sie keine Optimizely Integration nutzen, aber dennoch die Übertragung automatisieren möchten, können Sie dies bspw. mit Hilfe eines Skripts tun. Für die Programmierung einer entsprechenden Lösung wenden Sie sich an Ihren System-Administrator beziehungsweise Ihren Software-Dienstleister.

Um die ausgefüllte und umbenannte Optimizely Vorlage in Ihr Verzeichnis auf dem Optimizely Server zu übertragen, führen Sie die folgenden Schritte aus:

  1. Melden Sie sich mit Ihren Benutzerdaten am Optimizely Server an.

    Wenn Sie noch kein eingerichtetes Benutzerkonto auf dem Optimizely Server besitzen, wenden Sie sich an die Kundenbetreuung. Informationen zur Anmeldung am Optimizely Server finden Sie für Windows hier: FTP-API (Windows) beziehungsweise bzw. FTP-API (macOS/OS X).

  2. Laden Sie die ausgefüllte und umbenannte Optimizely Vorlage in Ihr persönliches Verzeichnis auf dem Optimizely Server.

    Wenn Sie auf dem Optimizely Server mehrere Verzeichnisse (Ordner) haben, speichern Sie die ausgefüllte und umbenannte Vorlage in das Verzeichnis, das bei Einrichtung der Content-Schnittstelle für Ihre CSV-Dateien eingerichtet worden ist. Wenn Sie die ausgefüllte und umbenannte Vorlage in ein anderes Verzeichnis legen, schlägt der Import Ihrer Produktdaten fehl.

    Wenn Sie die ausgefüllte und umbenannte Vorlage in das korrekte Verzeichnis geladen haben, stehen Ihnen Ihre aktuellen Produkt-Angebote im Template-Kit zur Verfügung, um diese in Ihre Nachrichten einzubinden.

    Es kann einige Zeit dauern kann, bis Ihre als CSV-Datei übertragenen Produkt-Angebote im Template-Kit zur Verfügung stehen. Sie sollten daher die Dateiübertragung automatisiert in der Nacht durchführen.