So formatieren Sie Ihre CSV-Datei für einen Import

Dieser Artikel erklärt, wie Sie die Werte in einer CSV-Datei schreiben, die Sie über Data → Importe importieren: richtig oder falsch, Zahlen, Beträge, Datumsangaben, Auswahlmöglichkeiten und die Standardfelder eines Kontakts. Die Regeln für die Datei gelten für jede Importart. Die Regeln pro Datentyp gelten überall dort, wo Sie eine Spalte einem Attribut zuordnen, also bei Kontakt- und Voucher-Importen.

Ein Wert, der nicht zu dem passt, was eine Spalte erwartet, wird nicht immer mit einer Fehlermeldung abgelehnt. Manchmal wird er als etwas anderes gespeichert, oft leer oder 0. Prüfen Sie Ihre Datei deshalb vor dem Import anhand der Regeln unten.

Die Schritte eines Kontaktimports finden Sie unter Wie man eine Kontaktliste importiert.

Die Datei selbst

• Eine Kopfzeile ist Pflicht. Jede Spalte braucht in der ersten Zeile einen Namen. Fehlt einer, bricht der Upload ab und Sie werden gebeten, ihn zu ergänzen.
• Spaltennamen sollten eindeutig sein. Kommt ein Name zweimal vor, nummeriert Leat die doppelten, damit Sie sie beim Zuordnen auseinanderhalten können.
• Bis zu 100.000 Zeilen pro Datei. Teilen Sie eine größere Datei auf und importieren Sie die Teile nacheinander.
• Komma, Semikolon, Tabulator oder senkrechter Strich als Trennzeichen. Leat erkennt selbst, welches Zeichen Ihre Datei verwendet.
• Speichern Sie die Datei als UTF-8, damit Umlaute und Akzente korrekt ankommen.
• Leere Zeilen werden übersprungen.

Eine einfache Kontaktdatei sieht so aus:

email,firstname,lastname,newsletter_opt_in
anna@example.com,Anna,de Vries,true
ben@example.com,Ben,Janssen,false

Automatische Festlegung der Datentypen oder Alle Datentypen auf Text setzen

Im Schritt Datei-Upload wählen Sie, wie Ihre Datei gelesen wird.

• Automatische Festlegung der Datentypen (Empfohlen) macht aus allem, was wie eine Zahl aussieht, eine Zahl. Dabei gehen führende Nullen verloren: Die Telefonnummer 0612345678 wird zu 612345678, und eine Postleitzahl, Mitgliedsnummer oder ein Code 00123 wird zu 123.
• Alle Datentypen auf Text setzen übernimmt jeden Wert genau so, wie er geschrieben ist.

Enthält eine Spalte Werte, die mit einer Null beginnen, wählen Sie Alle Datentypen auf Text setzen. Zahlen, Datumsangaben und richtig oder falsch werden trotzdem korrekt gelesen, weil Leat jeden Wert nach der Spalte liest, der Sie ihn zuordnen.

Datumsangaben und Datumsnotation

Der Schritt Überprüfen Sie Ihre Daten hat die Einstellung Datumsnotation:

• Tag / Monat / Jahr, zum Beispiel 31-05-2025
• Jahr / Monat / Tag, zum Beispiel 2025-05-31

Verwenden Sie -, / oder . zwischen den Teilen des Datums. Ein Datum, das nicht zur gewählten Notation passt, kann nicht gelesen werden. Leat rät nicht.

Welche Datumsangaben der Notation folgen:

• Aktivierungs-Datum und Verfallsdatum, wenn Sie neue Vouchers importieren. Schreiben Sie nur das Datum. Eine Zelle mit einer Uhrzeit kann nicht gelesen werden, und ein Datum, das nicht gelesen werden kann, entfällt. Der Voucher wird dann ohne dieses Datum erstellt.
• Verfallsdatum, wenn Sie bestehende Vouchers aktualisieren und wenn Sie Geschenkkarten importieren oder aktualisieren. Eine Uhrzeit ist hier optional: 31-12-2025 18:00. Ohne Uhrzeit gilt 23:59 an diesem Tag.
• Startet um, Endet am und Eingecheckt am, wenn Sie Buchungen importieren. Geben Sie die Uhrzeit mit an: 31-05-2025 19:30.
• Attribute vom Typ Datum und Uhrzeit bei Kontakt- und Voucher-Importen. Siehe Datum und Uhrzeit unten.

Uhrzeiten schreiben Sie im 24-Stunden-Format, und sie gelten in der Zeitzone Ihres Accounts.

Attribute vom Typ Datum und Geburtsdatum folgen der Datumsnotation nicht. Siehe die Abschnitte unten.

Beträge und Zahlen bei anderen Importen

• Betrag in Cent (Prepaid-Transaktionen und Geschenkkarten-Transaktionen) ist eine ganze Zahl von Cent. Für 25 € schreiben Sie 2500. Ein Wert mit Komma, Punkt, Währungszeichen oder Text, etwa 25,00 oder €25, lässt die Zeile fehlschlagen.
• Punkte (Punkte mit festem Betrag) ist eine Anzahl von Punkten: 700. Ein Komma oder Punkt wird als Dezimaltrennzeichen gelesen, und die Nachkommastellen entfallen. 389,5 ergibt also 389 Punkte. Lassen Sie Tausendertrennzeichen weg.
• Basisbetrag (Punkte auf Basis eines Betrags) ist ein Betrag mit Komma oder Punkt für die Nachkommastellen: 12,50 und 12.50 werden beide als 12,50 gelesen. Lassen Sie Tausendertrennzeichen und Währungszeichen weg.

Ein Wert bei Punkte oder Basisbetrag, der keine Zahl ist, lässt die Zeile fehlschlagen.

Werte pro Datentyp

Diese Regeln gelten für jede Spalte, die Sie einem benutzerdefinierten Attribut zuordnen, bei Kontakt- und Voucher-Importen, sowie für die Standardfelder eines Kontakts.

(Boolean) Richtig oder falsch

• true und 1 werden als richtig importiert.
• false und 0 werden als falsch importiert.
• Groß- und Kleinschreibung spielt keine Rolle: True, TRUE und FALSE funktionieren auch.

email,newsletter_opt_in
anna@example.com,true
ben@example.com,false

Jeder andere Wert, etwa ja, nein, yes oder x, wird weder als richtig noch als falsch gelesen. Er zählt als leere Zelle. Bei einem Kontaktimport entscheidet dann der Schreibmodus, was passiert (siehe „Leere Zellen und der Schreibmodus“ unten). Verwendet Ihre Datei ja und nein, ersetzen Sie diese vor dem Import durch true und false.

Nummer und Dezimalzahl

• Schreiben Sie nur die Zahl: 12, -3, 12.5.
• Verwenden Sie ein Komma oder einen Punkt für Nachkommastellen: 12,5 und 12.5 werden beide als 12,5 gelesen.
• Lassen Sie Tausendertrennzeichen weg. 1.234 wird als 1,234 gelesen, nicht als 1234. 1.234,56 und 1,234.56 werden beide als 1234,56 gelesen.
• Lassen Sie Währungszeichen und Einheiten weg. Ein Wert, der nicht mit einer Zahl beginnt, etwa € 12 oder abc, wird als 0 importiert.
• Verwenden Sie ganze Zahlen für ein Attribut vom Typ Nummer. Verwenden Sie Dezimalzahl für Werte mit Nachkommastellen.

Geburtsdatum

• Schreiben Sie den Tag oder das Jahr zuerst: 31-05-1999, 31/05/1999, 31.05.1999 oder 1999-05-31.
• Datumsangaben mit dem Monat zuerst werden nicht unterstützt. 12/25/1990 kann nicht gelesen werden, und 03/04/2025 wird als 3. April gelesen, nicht als 4. März.
• Das Datum muss zwischen dem 1. Januar 1900 und heute liegen. Ein Geburtsdatum außerhalb dieses Bereichs wird leer importiert.
• Die Datumsnotation gilt nicht für Geburtsdaten.

Datum

Wie ein Geburtsdatum, ohne die zeitliche Grenze: Tag oder Jahr zuerst, mit -, / oder . zwischen den Teilen. 31-05-2025 und 2025-05-31 funktionieren beide. Datumsangaben mit dem Monat zuerst werden nicht unterstützt, und die Datumsnotation gilt nicht.

Datum und Uhrzeit

Ein Wert vom Typ Datum und Uhrzeit wird in der Reihenfolge gelesen, die Sie unter Datumsnotation wählen, zum Beispiel 31-05-2025 14:30 oder 2025-05-31 14:30.

• Schreiben Sie die Uhrzeit im 24-Stunden-Format, mit oder ohne Sekunden: 14:30 oder 14:30:00. AM und PM werden nicht unterstützt.
• Ein Datum ohne Uhrzeit wird als 23:59 an diesem Tag gespeichert.
• Die Uhrzeit wird in der Zeitzone Ihres Accounts gelesen. Ein Wert mit einer Zeitzone am Ende, etwa 2025-05-31T14:30:00Z oder +02:00, kann nicht gelesen werden.

Auswählen

Verwenden Sie den internen Wert der Option, nicht ihre Bezeichnung. Sie finden ihn unter Auswahlmöglichkeiten auf der Seite des Attributs. Klicken Sie dazu oben rechts im Dashboard auf das Zahnrad, um die Einstellungen zu öffnen, dann unter Management auf Attribute, und öffnen Sie das Attribut.

Der Wert muss genau übereinstimmen, auch in der Groß- und Kleinschreibung. Ein Wert, der zu keiner Option passt, wird leer importiert.

Mehrfachauswahl

Verwenden Sie die internen Werte der Optionen und trennen Sie sie mit einem Semikolon: wein;bier;kaffee. Werte, die zu keiner Option passen, entfallen, der Rest wird importiert.

Verwendet Ihre Datei das Semikolon als Trennzeichen, setzen Sie die Zelle in doppelte Anführungszeichen: "wein;bier".

Bei einem Kontaktimport entscheidet der Schreibmodus, was mit den Optionen passiert, die der Kontakt bereits hat:

• Überspringen, wenn leer und Immer überschreiben ersetzen die Optionen des Kontakts durch die aus Ihrer Datei.
• Anhängen fügt die Optionen aus Ihrer Datei zu denen des Kontakts hinzu. Dieser Modus steht nur bei Attributen vom Typ Mehrfachauswahl zur Verfügung.

Text, Langer Text, E-Mail, URL, Farbe und Kennung

Werden so importiert, wie sie geschrieben sind. Leerzeichen am Anfang und Ende werden entfernt. Mit Automatische Festlegung der Datentypen (Empfohlen) verliert ein Wert, der nur aus Ziffern besteht, seine führenden Nullen. Wählen Sie deshalb Alle Datentypen auf Text setzen für Codes wie 00123.

Nummernschild

Alles außer Buchstaben und Ziffern wird entfernt: AB-12-CD wird als AB12CD gespeichert.

Datei- und Medien-Uploads

Diese Attribute lassen sich nicht aus einer CSV-Datei füllen und werden beim Zuordnen der Spalten nicht angeboten.

Standardfelder eines Kontakts

• E-Mail ist Pflicht. Daran erkennt Leat einen Kontakt: Eine Zeile mit einer E-Mail-Adresse, die bereits in Ihrem Account existiert, aktualisiert diesen Kontakt, jede andere Zeile legt einen neuen an. Eine Zeile mit leerer oder ungültiger E-Mail-Adresse schlägt fehl.
• Vorname, Nachname und Adresse sind Text.
• Telefon funktioniert am besten im internationalen Format mit + am Anfang, zum Beispiel +491701234567. Eine Nummer ohne Ländervorwahl wird als Nummer aus dem Land Ihres Accounts gelesen. Eine Nummer, die ein anderer Kontakt bereits hat oder die keine gültige Telefonnummer ist, wird nicht als Telefonnummer des Kontakts gesetzt.
• Geburtsdatum folgt den Regeln für Geburtsdatum oben.
• Bevorzugte Sprache ist ein Sprachcode aus 2 Buchstaben: en (Englisch), nl (Niederländisch), fr (Französisch), de (Deutsch), it (Italienisch), pl (Polnisch), pt (Portugiesisch), es (Spanisch) oder sv (Schwedisch). Verwenden Sie den Code in Kleinbuchstaben, nicht den Namen der Sprache. Jeder andere Wert lässt die Sprache des Kontakts unverändert.
• Kontaktart wird einer Ihrer Kontaktarten zugeordnet. Wählen Sie nach dem Zuordnen der Spalte unter Beziehung, ob sie die ID oder den Name der Kontaktart enthält. Namen werden unabhängig von der Groß- und Kleinschreibung erkannt. Ein Wert, der zu keiner Kontaktart passt, lässt die Zeile fehlschlagen, und eine leere Zelle lässt die Kontaktart unverändert.

Leere Zellen und der Schreibmodus

Bei einem Kontaktimport entscheidet der Schreibmodus, den Sie beim Zuordnen einer Spalte wählen, was eine leere Zelle bei einem Kontakt bewirkt, der bereits einen Wert hat:

• Überspringen, wenn leer (Standard): Der Kontakt behält seinen aktuellen Wert.
• Immer überschreiben: Der aktuelle Wert wird entfernt.

Bei einem neuen Kontakt bleibt das Attribut bei einer leeren Zelle einfach leer.

Wenn Werte nicht ankommen

• Ein Attribut vom Typ richtig oder falsch blieb leer oder hat sich nicht geändert. Ihre Datei verwendet einen anderen Wert als true, false, 1 oder 0, etwa ja. Ersetzen Sie ihn und importieren Sie erneut.
• Ein Wert bei Auswählen, Mehrfachauswahl, Datum oder Geburtsdatum ist verschwunden. Ein Wert, den Leat in einer solchen Spalte nicht lesen kann, wird leer gespeichert. Bei einem Kontaktimport entfernt das den Wert, den der Kontakt hatte, auch mit Überspringen, wenn leer. Prüfen Sie, ob Sie den internen Wert der Option verwendet haben oder ein Datum mit Tag oder Jahr zuerst.
• Vouchers haben kein Aktivierungs- oder Verfallsdatum. Das Datum passte nicht zu Ihrer Datumsnotation, oder es enthielt eine Uhrzeit.
• Führende Nullen fehlen. Importieren Sie erneut mit Alle Datentypen auf Text setzen.
• Ein Zahlenattribut ist 0. Vor der Zahl stand ein Währungszeichen, eine Einheit oder Text.
• Einige Zeilen sind fehlgeschlagen. Öffnen Sie den Import unter Data → Importe, um zu sehen, welche Zeilen fehlgeschlagen sind und warum. Häufige Ursachen sind eine ungültige E-Mail-Adresse, eine Kontaktart, die nicht existiert, ein Betrag in Cent, der keine ganze Zahl ist, und ein Voucher-Code, den ein anderer Voucher bereits verwendet. Ein gelöschter Voucher zählt nicht: Sein Code ist wieder frei.