Alle eingehenden Datendateien müssen UTF-8 Unicode-kodierte Dateien des Typs .csv (comma separated values) sein.

Wenn Sie Predict oder Smart Insight verwenden, sollten Sie sich zudem beim Emarsys Support vergewissern, dass Ihre Datenstruktur den Anforderungen Ihrer speziellen Konfiguration entspricht, insbesondere in Bezug auf benutzerdefinierte Felder.

Die wichtigste Regel beim Hochladen von Daten ist, dass das Format aller hochgeladenen Dateien einheitlich sein muss. Sobald ein Format definiert ist, sollte es nicht mehr geändert werden. Wenn Sie das Format dennoch ändern wollen oder müssen, kontaktieren Sie den Emarsys Support, bevor die Änderung in Kraft tritt.

Das sind unsere grundlegenden Regeln für .csv-Dateien:

• Trennzeichen ist immer das Komma. (Das ist das Zeichen, das die Felder trennt.)
• Werte, die selbst Kommas enthalten, können in doppelte Anführungszeichen gesetzt werden.
• Felder dürfen keine Zeilenumbrüche enthalten (auch nicht, wenn sie in Anführungszeichen gesetzt sind).
• Anführungszeichen innerhalb von Feldern können durch Verdoppelung ausgeblendet werden: "".
• Die erste Zeile muss der Header (die Kopfzeile) sein und den Feldnamen enthalten; die folgenden Zeilen enthalten die Felder in der im Header festgelegten Reihenfolge.
• Redundante Leerzeichen (am Anfang und am Ende) werden automatisch entfernt, es sei denn, sie stehen in Anführungszeichen (so ist zum Beispiel 1, 2, 3 dasselbe wie 1,2,3).

Bitte beachten Sie, dass Werte die Groß- und Kleinschreibung beachten. example@address.com und EXample@address.com werden als unterschiedlich behandelt.

Um die Fremdsprachenunterstützung zu maximieren und sicherzustellen, dass Content korrekt angezeigt werden, besteht Emarsys auf der UTF-8-Kodierung als Standard.

• Für Fließkommazahlen (Floats) müssen Sie immer einen Punkt (.) als Dezimaltrennzeichen verwenden, auch in Ländern, die ein anderes Zeichen - wie das Komma - verwenden.
• Importierte Dateien müssen in den ersten 265 KB ein Newline-Steuerzeichen enthalten. Damit wird das versehentliche Hochladen von Binärdateien vermieden. Das Hochladen von Dateien ohne dieses Zeichen führt zu einer Fehlermeldung und dazu, dass die Datei nicht hochgeladen wird.

Der Produktkategoriepfad besteht aus einer Reihe von Begriffen, die das Produkt immer genauer beschreiben. So kann zum Beispiel The Hitchhiker's Guide to the Galaxy als Literature > Fiction > Sci-Fi kategorisiert werden. In der Produktkatalogdatei werden die Elemente des Kategoriepfads durch das Zeichen > getrennt. In einem Buchladen würden sich all diese Produkte in der Kategorie Literature befinden; wenn es eine Kategorie gibt, die alle Artikel umfasst, nennen wir sie Root Category. Im Feld category sollte diese Root Category nicht enthalten sein.

Einige Artikel können zu mehreren Kategorien gehören. So könnte The Hitchhiker's Guide beispielsweise auch als Literature > British literature > Contemporary kategorisiert sein. Mehrere Kategorien sollten durch das Pipe-Zeichen (|) getrennt werden.

In diesem Fall wäre der korrekte Wert für das Feld catalog wie folgt:

Fiction > Sci-Fi | British literature > Contemporary

So würde in Smart Insight "chocolate flavoured instant coffee" in derselben Kategorie aufscheinen wie "regular instant coffee". Predict würde beim Erstellen der Empfehlungen den Unterschied jedoch berücksichtigen.

Wenn Sie Datumsfelder verwenden, unterstützt Emarsys die folgenden Formate für das Importieren und Exportieren von Daten:

Wenn Sie ein Timestamp-Feld verwenden, um zum Beispiel einzelne Käufe zu identifizieren, müssen Sie das folgende UTC-Format verwenden:

• JJJJ-MM-TTTHH:MM:SSZ

Wenn die Daten selbst das Trennzeichen enthalten, müssen Sie dem Importmechanismus signalisieren, dass dieses Zeichen ein Teil des Feldwerts ist und nicht als Zeichen für den Beginn einer neuen Datenzeile gewertet werden darf. Dafür müssen Sie den gesamten Feldwert in doppelte Anführungszeichen einschließen. Im folgenden Beispiel erscheint das Trennzeichen , im Text des zweiten Feldwerts. Wenn das Feld also importiert werden soll, wird der gesamte Wert in Anführungszeichen gesetzt.

Ähnlich wie beim Trennzeichen: Wenn der importierte Text Anführungszeichen enthält, muss das dem Importmechanismus signalisiert werden; dafür wird das Anführungszeichen in Escape-Zeichen gesetzt. Beim "Escapen" wird das vorhandene Anführungszeichen um ein weiteres Anführungszeichen ergänzt; zusätzlich wird der gesamte Wert in Anführungszeichen gesetzt. Im ersten unten angeführten Beispiel wird das Anführungszeichen im Text als Abkürzung für die Maßeinheit Inch verwendet. Im zweiten Beispiel werden Anführungszeichen nicht nur verwendet, um das Inch-Symbol zu escapen, sondern auch, um anzuzeigen, dass der Wert zudem das Trennzeichen , enthält:

Hinweis: Sowohl das Trennzeichen als auch die Anführungszeichen können angepasst werden; in jedem Fall sollte das verwendete Zeichen mit Bedacht gewählt werden.

Damit die Struktur der Daten nicht beeinträchtigt wird, müssen Felder, die keine Werte enthalten, als leerer Wert ohne Anführungszeichen exportiert werden.

Beispiel

Hier finden Sie einige Beispieldateien mit einer Auswahl typischer Felder, die Sie herunterladen und für Ihren eigenen Gebrauch anpassen können:

• Beispiel für Kontaktdatendatei
• Beispiel für Produktdatendatei
• Beispiel für Salesdatendatei

Die Änderung der Struktur einer CSV-Datei, die in einer Arbeitsumgebung aktiv verwendet wird, ist immer eine komplexe Aufgabe, die viel Aufmerksamkeit erfordert. Das Ändern von Spalten in den CSV-Dateien für Kontakte, Produkte oder Sales kann leicht zu Datenbeschädigung oder -verlust führen.

Die beste und sicherste Methode ist die Vorbereitung und Durchführung eines vollständigen Daten-Reloads.

Wenn Sie die Spaltenstruktur einer in Verwendung befindlichen CSV-Datei ändern wollen, ohne danach einen vollständigen Reload durchführen zu müssen, beachten Sie bitte Folgendes:

• Das Entfernen und das Hinzufügen von Spalten sind die einzigen gültigen Aktionen.
• Wenn Sie eine Spalte entfernen, gehen Daten verloren; wenn Sie Daten zu einer neuen Spalte hinzufügen, werden ältere Daten möglicherweise überschrieben. Sowohl das Entfernen als auch das Hinzufügen können die Qualität der Daten vermindern.

Es kommt zwar zu keinem Datenverlust, wenn nach der letzten bestehenden Spalte weitere Spalten hinzugefügt werden, es werden jedoch die Daten für die bereits hochgeladenen früheren Salesdaten in den neuen Spalten auch nicht wieder aufgefüllt. Die neuen Spalten beginnen am Tag nach ihrer Erstellung mit der Aufzeichnung von Daten.