Dieser Leitfaden beschreibt die Formatierungsregeln für den CSV-/XLSX-Import, die Sie beachten müssen, bevor Sie Dateien in das System hochladen. Sie erfahren, welche Struktur Ihre Daten haben sollten, welche Felder erforderlich sind und wie Werte formatiert werden müssen, um beim Import korrekt erkannt zu werden. Durch die Einhaltung dieser Regeln lassen sich häufige Probleme wie fehlende Spalten, ungültige Datentypen oder unerwartete Zuordnungsfehler vermeiden. Nutzen Sie diesen Artikel als Checkliste, um Ihre Datei zu prüfen und jederzeit einen schnellen und zuverlässigen Import sicherzustellen.
Derzeit ermöglicht die Anwendung das Hochladen von Daten aus zwei Dateitypen:
CSV
XLSX
Ihre Datei muss eines der Standard-Trennzeichen verwenden. Andernfalls kann die Datei abgelehnt werden.
Zulässige Optionen:
Komma (,)
Semikolon (;)
Tabulator
Vermeiden Sie:
Doppelte Kommas (,,)
Kommas an unregelmäßigen Stellen
Ungewöhnliche Trennzeichen
Wenn Sie ein Komma als Trennzeichen verwenden, dürfen Sie es nicht innerhalb der Werte einsetzen. So ist beispielsweise „Baker street, 20" im Attribut „Adresse" nicht zulässig.
Die Kodierung ist das Verfahren, mit dem Text als digitale Daten dargestellt wird. Sie legt fest, wie Buchstaben, Zahlen, Symbole und Sonderzeichen von einem System gespeichert und angezeigt werden. Die Wahl der richtigen Kodierung ist entscheidend, um die Genauigkeit des Textes zu bewahren – insbesondere bei mehrsprachigen Inhalten. Wird die falsche Kodierung gewählt, können Zeichen fehlerhaft oder unleserlich erscheinen, ein Problem, das häufig als Mojibake bezeichnet wird.
Zu den am häufigsten verwendeten Optionen zählt UTF-8, der moderne Standard. Er unterstützt eine große Bandbreite an Zeichen aus verschiedenen Schriftsystemen und wird aufgrund seiner Kompatibilität und Flexibilität für internationale Inhalte allgemein empfohlen.
Kyrillisch (Windows-1251) ist eine ältere Kodierung, die häufig für Texte in kyrillischen Sprachen verwendet wird, insbesondere in älteren Windows-Umgebungen. Kyrillisch (ISO-8859-5) ist ein weiterer älterer Standard für kyrillischen Text, der heute jedoch weniger verbreitet ist als Windows-1251 oder Unicode-basierte Kodierungen.
Für mittel- und osteuropäische Sprachen wird häufig Osteuropa (Windows-1250) in älteren Windows-Anwendungen eingesetzt. Sie unterstützt Sprachen, die auf lateinischen Schriften mit zusätzlichen diakritischen Zeichen basieren, etwa Polnisch, Tschechisch und Ungarisch. Ebenso ist Osteuropa (ISO-8859-2) ein älterer internationaler Standard für dieselbe Sprachgruppe, der in modernen Systemen jedoch weitgehend durch Unicode ersetzt wurde.
Schließlich ist US ASCII eine der ältesten und eingeschränktesten Kodierungen. Sie umfasst nur die englischen Grundbuchstaben, Zahlen und Satzzeichen und eignet sich daher nur für einfache Klartextinhalte ohne Akzente oder nicht-lateinische Zeichen.
In den meisten modernen Anwendungsfällen ist UTF-8 die sicherste und universellste Wahl, während ältere Kodierungen vor allem für die Kompatibilität mit älteren Dateien und Systemen nützlich bleiben.
Jede Spaltenüberschrift sollte ein Attribut darstellen, und jede Zelle sollte nur den Wert für dieses Attribut enthalten.
Wenn Sie in einer Zeile zusätzliche Werte belassen, die keinem Attribut zugeordnet werden können, versucht der Importer möglicherweise, Werte zusammenzuführen und als ein einzelnes Feld zu behandeln. Dies kann zu irreführenden Validierungsfehlern führen (z. B. einer Meldung „last_name zu lang", obwohl der Nachname korrekt aussieht).
Checkliste
Jede Spalte hat eine eindeutige Überschrift (Attributname).
Jeder Wert gehört zu einem vorhandenen Attribut (oder einem, das Sie erstellen möchten).
Keine „zusätzlichen" Werte nach der letzten erwarteten Spalte.
Die korrekte Formatierung ist wichtig, da die Import-Engine die Werttypen validiert.
Bevor Sie neue Attribute erstellen, sehen Sie sich an, welche Attributtypen zur Verfügung stehen:
Typ | Beschreibung | Beispiel |
Boolean | Stellt binäre Optionen dar: true / false. | Attribut „Marketing-Einwilligung", Wert „True" |
Datum | Feld zum Speichern von Informationen zu einem bestimmten Datum. Format: ISO 8601. | Attribut „Geburtstag", Wert „1996-01-20" |
Datetime | Feld zum Speichern zeitspezifischer Angaben wie Anmelde- oder letzter Aktivitätsinformationen. Erfordert das ISO-8601-Format. | Attribut „Zuletzt gesehen", Wert „2016-08-03 12:00:00+00:00" |
Feste Auswahl | Satz möglicher Optionen, die die Werte für ein bestimmtes Feld einschränken. Solche Attribute können auch die Variante „Mehrfachauswahl zulassen" enthalten. Wenn diese Option aktiviert ist, können Sie mehr als einen Wert in eine Zelle eintragen, getrennt durch das Symbol „|". | Attribut „Bevorzugte Sprache", Wert „Englisch", „Polnisch", „Spanisch" |
Gleitkommazahl | Numerische Daten mit Dezimalstellen, geeignet zur Darstellung von Preisen oder statistischen Kennzahlen. | Attribut „Lifetime Value", Wert „1000.59" |
Ganzzahl | Numerische Daten, enthält ausschließlich ganze Zahlen. | Attribut „Gesamtanzahl der Bestellungen", Wert „9" |
JSON-Dateiformat | Eignet sich für längere Werte, die in anderen Datenformaten nicht abgelegt werden können. Nicht verfügbar für Produkt Events. | Attribut „Zusätzliche Bestellinformationen", Wert (gültiges JSON-Objekt): „key": „value" |
Zahl | Nur für Events (!). Dieses Feld wird speziell für Event-Attribute verwendet. Es umfasst sowohl Ganzzahl- als auch Gleitkommaoptionen. | Attribut „Gesammelte Punkte", Wert „15" |
String | Beliebige Zeichenkette, begrenzt auf 255 Elemente. Perfekt für textbasierte Informationen wie Namen, E-Mail-Adressen oder andere textuelle Daten. | Attribut „Abonnementplan", Wert „Standard" |
Boolean-Felder müssen gültige Boolean-Werte enthalten:
- Verwenden Sie TRUE oder FALSE
- Lassen Sie Boolean-Felder nicht leer (leere Werte können Validierungsfehler auslösen)
Mehr über Attribute erfahren Sie hier.
Einige Felder erwarten spezifische, vordefinierte Werte. Stellen Sie sicher, dass Sie das korrekte Format verwenden.
Attribut | Beschreibung | Erforderliche Werte |
Geschlecht (Kontakt-Attribut) | Standard-Attribut, das Sie mit Ihren eigenen Werten aktualisieren können. Standardmäßig leer. |
|
Telefonnummer (Kontakt-Attribut) | Standard-Attribut, das Sie mit Ihren eigenen Werten aktualisieren können. Standardmäßig leer. Empfohlenes Format, das für alle Anbieter geeignet ist: E.164 | E.164-Format. Beispiel: +44754123434 |
Status (Deal-Attribut) | Dieses Feld definiert den Status Ihres Deals. |
|
Status der Aufgabe (Deal-Attribut) | Diese definieren Ihren Aufgabenstatus. |
|
Zugewiesen an (Kontakt-Attribut) | Definiert, welchem Nutzer der Kontakt zugewiesen ist. | Muss einer vorhandenen Nutzer-ID oder einem Nutzer-/Gruppennamen entsprechen (abhängig von Ihrer Systemkonfiguration). |
Status (Ticket-Attribut) | Dieses Feld definiert den Status des Tickets. |
|
Um mehr über den Import bestimmter Objekte in die Anwendung zu erfahren, sehen Sie sich den entsprechenden Bereich in unserer Wissensdatenbank an: Datenimport & -export
