• Ihre Produktdatendatei sollte eine einfache .csv-Tabelle sein; eine Zeile sollte jeweils alle Attribute eines bestimmten Produkts enthalten, wie die Artikel-ID, die URL der Produktseite, den Link zum Produktbild etc.
• Verwenden Sie eine CSV-Exportbibliothek, die mit dem Standard-CSV-Format kompatibel ist.
• Verwenden Sie Kommazeichen für das Trennen der Felder in einer Zeile.
• In Feldern, die mehrere Werte enthalten, verwenden Sie zum Trennen dieser Werte einen senkrechten Strich (|). Beispiel: ,John Lennon|Paul McCartney|George Harrison|Ringo Starr,...
• Wenn ein Feld keinen Wert hat, lassen Sie es leer. Beispiel: value1,,value3,value4
• Verwenden Sie in den Feldern keine Neue-Zeile-Zeichen, weder ohne noch mit Anführungszeichen.
• Verwenden Sie UTF-8-Codierung.
• Schließen Sie die Feldnamen in der ersten Zeile (Header) ein und vergewissern Sie sich, dass alle nachfolgenden Zeilen jene Werte enthalten, die den im Header gelisteten Feldern entsprechen.
• Verwenden Sie nicht mehr als 255 Spalten.
• Verwenden Sie keine Feldwerte, die größer als 64 KB sind.
• Überflüssige (vorangestellte oder nachgestellte) Leerzeichen werden automatisch getrimmt, außer sie werden in Anführungszeichen gesetzt (so ist z.B. 1, 2, 3 dasselbe wie 1,2,3).
• Selbst wenn die Produktdatendatei üblicherweise Informationen enthält, die auf Ihrer Website öffentlich zugänglich sind, wollen Sie vielleicht durch einen Passwortschutz für mehr Sicherheit sorgen. Das Hochladen von passwortgeschützten Produktdatendateien über eine sichere Verbindung wird von Emarsys in vollem Umfang unterstützt.

Im Feld 'category' übergeben Sie den Produktkategoriepfad Ihrer Artikel, und zwar basierend auf dem Produktkategorisierungssystem Ihres Onlineshops.

Ein Kategoriepfad beschreibt, wo in der Kategoriehierarchie ein Produkt angesiedelt ist. Dabei handelt es sich um eine durch das Zeichen > separierte Liste von Subkategorien; begonnen wird mit der Top-Level-Kategorie.

Ein kleiner Radshop könnte beispielsweise folgende Kategoriehierarchie verwenden:

In dieser Struktur sind sowohl Bikes als auch Bikes > Road Bikes gültige Kategoriepfade, während Road Bikes für sich allein kein gültiger Kategoriepfad ist, weil die Top-Level-Kategorie fehlt.

Der Kategoriepfad für bike1, ein 'Awesome Road Bike', ist Bikes > Road Bikes, und das kann in der Produktdatendatei wie folgt dargestellt werden:

* In diesem Feld können Sie mehrere Werte verwenden.

* In diesen Feldern können Sie mehrere Werte verwenden.

Neben den Standard- und vordefinierten Produktdatenfeldern können Sie benutzerdefinierte Felder verwenden, um weitere Produktinformationen zur Datendatei hinzuzufügen. Die Namen von benutzerdefinierten Feldern müssen mit dem Präfix c_* beginnen (z.B. c_color oder c_size).

Wenn Sie Ihre benutzerdefinierten Felder planen, denken Sie an die Art der Segmentierung, die Sie in Ihrem Emarsys Account verfügbar haben wollen, und arbeiten Sie sich dann nach hinten, um jene Felder zu identifizieren, mit deren Hilfe Sie dieses Ziel erreichen können.

Das ist besonders wichtig, wenn Sie Smart Insight verwenden, da Ihnen diese Felder ermöglichen, Segmente auf Basis der Produktattribute zu erstellen.

Wenn Ihr Webshop in verschiedenen Märkten und mehreren Sprachen präsent ist, kann es erforderlich sein, die lokalisierten Versionen der Standard-Produktdatenfelder in der Produktdatendatei anzuführen. Benennen Sie Ihre lokalisierten Felder nach dem Muster [field name]_[language identifier]; das bedeutet, auf den Namen des Standard-Produktdatenfelds müssen ein Unterstrich und das Sprachkennzeichen folgen (zum Beispiel title_it für den italienischen Titel eines Buchs).

Es können alle Standard-Produktdatenfelder und alle benutzerdefinierten Produktdatenfelder lokalisiert werden, mit Ausnahme von item.

Da 'categories', 'authors' und 'actors' in statistischen Modellen verwendet werden können, sollte kanonisch auf sie verwiesen werden. So sollte zum Beispiel die Autorin J. K. Rowling in der Produktdatendatei immer genau gleich geschrieben werden. Wenn es mehrere identische Strings gibt, die verschiedene Werte eines bestimmten Attributs repräsentieren, sollten sie konsequent unterschieden werden, zum Beispiel in J. Doe und J. Doe(2).

Bestimmte Emarsys Apps, wie zum Beispiel die Produktempfehlungen, funktionieren mit kleineren Bildern. Wenn Sie nur hochauflösende Produktbilder haben, kann Emarsys die Miniaturbilder automatisch für Sie erstellen. Um diesen automatischen Dienst für die Bildgrößenanpassung zu verwenden, ersetzen Sie einfach im Feld image die Bild-URL durch folgendes URL-Muster:

Vergewissern Sie sich, dass die URL des ursprünglichen Bildes mit dem Protokoll beginnt; das kann http oder https sein. Es muss die Standard URL Syntax verwendet werden.

So sieht eine Produktdatendatei im Emarsys CSV-Format aus: Beispieldatei herunterladen.

Die oben angeführte Datei ohne Leerzeichen:

Bitte beachten Sie, dass beide Dateien genau dasselbe Ergebnis haben werden; überflüssige Leerzeichen und Anführungszeichen werden ignoriert. Bitte beachten Sie auch, dass Werte, die das Trennzeichen enthalten, in doppelte Anführungszeichen eingeschlossen sein müssen (z.B. "Foo, Bar").