Wenn Sie eine Kontaktliste hochladen und eine „Fehlerprotokoll“-Meldung im Aktionsprotokoll sehen, bedeutet dies, dass mit Ihrer Kontaktliste etwas nicht stimmt.
Gründe, die ein Fehlerprotokoll verursachen können:
● Falsch formatierte Kontakt-Datei (CSV) *
● Falsche Anzahl an Kopfspalten
● Zu wenige Spalten in einer bestimmten Zeile (oder fehlende Feldtrennzeichen)
● Eine oder mehrere E-Mail-Adressen sind nicht in folgendem Format: vorname@beispiel.de
● Doppelte E-Mail-Adressen (das Duplikat wird verworfen)
● Wert kann nicht konvertiert werden (Datumsformate inkorrekt)
● Der Import wurde vom System aufgrund eines „kritischen“ Fehlers abgebrochen
Um das Fehlerprotokoll herunterzuladen, klicken Sie auf den Button „Fehlerprotokoll herunterladen“. Überprüfen Sie die Fehlermeldungen in der Protokolldatei und korrigieren Sie Ihre Kontaktliste. Hinweis: Wenn bei Ihrem nächsten Upload keine Fehler auftreten, verschwindet das Fehlerprotokoll.
* Für Informationen zur Erstellung einer CSV-Datei, um Ihre Kontakte hochzuladen, lesen Sie bitte unsere FAQ.
Fehlerprotokolle erklärt
Die Anzahl der Kontakteigenschaften überschreitet das Limit von X
Ihr CSV-Import versucht, mehr Kontakteigenschaften (benutzerdefinierte Felder) zu erstellen/zuzuordnen, als das System zulässt. Das maximale Limit liegt bei 200 (einschließlich des E-Mail-Feldes).
Typisches Beispiel
Das Limit beträgt 200 Eigenschaften, aber Ihre Datei hat 260 benutzerdefinierte Spalten:
email,field_01,field_02,field_03,...,field_260 john@example.com,a,b,c,...,z
→ Der Importeur würde 260 Eigenschaften benötigen (eine pro Spalte), was über dem Limit liegt → Die Anzahl der Kontakteigenschaften überschreitet das Limit von 200.
Lösung: Entfernen/Zusammenführen von Spalten oder durchführen Sie mehrere Uploads, bei denen in jeder Datei unterschiedliche Eigenschaften angegeben werden:
- CSV 1 – Eigenschaften 1–199
- CSV 2 – Eigenschaften 200–260
E-Mail-Spalte nicht gefunden
Das bedeutet, dass das Importsystem keine Spalte in Ihrer CSV-Datei als E-Mail-Feld identifizieren konnte und daher nicht weiß, welcher Wert als eindeutiger Identifikator des Kontakts zu verwenden ist.
Dies geschieht in der Regel in einem der folgenden Fälle:
1) Die Datei hat überhaupt keine E-Mail-Spalte
Kopfzeile:
firstname,lastname,city
Es gibt einfach keine Spalte, die E-Mails enthält → E-Mail-Spalte nicht gefunden.
Lösung: Fügen Sie eine E-Mail-Spalte hinzu:
email,firstname,lastname,city
2) Die Datei enthält E-Mails, aber der Name der Kopfzeile wird nicht erkannt
Beispiel-Kopfzeile verwendet einen nicht standardmäßigen Namen:
contact_address,firstname,lastname john@example.com,John,Doe
Der Importeur erkennt nur Kopfzeilen wie email / Email automatisch → E-Mail-Spalte nicht gefunden.
Lösung: Benennen Sie die Kopfzeile in email um.
3) Die Datei hat keine Kopfzeile (die erste Zeile enthält Daten)
john@example.com,John,Doe jane@example.com,Jane,Doe
Wenn der Importeur eine Kopfzeile erwartet, kann er keine E-Mail-Spalte „sehen“ → E-Mail-Spalte nicht gefunden.
Lösung: Fügen Sie eine Kopfzeile hinzu:
email,firstname,lastname john@example.com,John,Doe
4) Ein falsches Trennzeichen macht die Kopfzeile unlesbar
Die Kopfzeile ist semikolongetrennt, aber der Rest der CSV-Datei ist kommagetrennt (oder umgekehrt):
email;firstname;lastname john@example.com,John,Doe
Dies führt dazu, dass Zeilen anders als die Kopfzeile geparst werden und ein Fehler auftritt.
Lösung: Verwenden Sie nur ein Trennzeichen in der gesamten Datei (Kopfzeile + alle Zeilen).
Import abgebrochen
Normalerweise, wenn zu viele Fehler auftreten (1000 Fehler oder 10 % der importierten Liste, je nachdem, welcher Wert höher ist).
Ungültiges UTF-8-Zeichen in Zeile X
Die Datei ist in dieser Zeile kein gültiges UTF-8 (falsche Kodierung oder fehlerhafte Zeichen).
Beispiel 1 (typisch): Datei in Windows-1252 gespeichert, enthält „intelligente Anführungszeichen“
Ihre CSV-Zeile mag in Excel gut aussehen, aber die Anführungszeichen sind „geschweift“:
john@example.com,John,“Marketing team”
Diese geschweiften Anführungszeichen (“ ”) sind üblich, wenn Text aus Word/Outlook kopiert wird und die Datei nicht als UTF-8 gespeichert wird. Der Importeur meldet dann: Ungültiges UTF-8-Zeichen in Zeile X.
Lösung: Erneut als CSV UTF-8 exportieren (oder in einem Texteditor öffnen und als UTF-8 speichern).
Beispiel 2 (häufig bei Kyrillisch): Datei in Windows-1251 gespeichert, enthält Kyrillisch
ivan@example.com,Иван,София
Wenn die Datei Windows-1251 ist, der Importeur aber UTF-8 erwartet, werden die Bytes für Иван / София nicht korrekt dekodiert, und Sie erhalten: Ungültiges UTF-8-Zeichen in Zeile X.
Lösung: Speichern/exportieren Sie die CSV-Datei als UTF-8.
Beispiel 3 (beschädigtes Byte): „Ersatzzeichen“ oder seltsames Symbol erscheint
john@example.com,John,ACME Ltd
Das weist oft auf beschädigte/ungültige Bytes während der Konvertierung hin. Diese Zeile kann den UTF-8-Fehler auslösen.
Lösung: Entfernen/ersetzen Sie das fehlerhafte Symbol und speichern Sie die Datei als UTF-8.
Zu viele Spalten in Zeile X
Diese Zeile enthält mehr Werte, als die Kopfzeile erfordert, normalerweise aufgrund fehlender Trennzeichen oder fehlerhafter Anführungszeichen/Zeilenumbrüche.
Wie das in der Praxis aussieht
Kopfzeile (erwartet 3 Spalten, kommagetrennt):
email,firstname,lastname
Fehlerhafte Zeile (zusätzliches , → 4 Spalten):
john@example.com,John,,Doe
Wenn der mittlere Wert nicht beabsichtigt ist, korrigieren Sie ihn:
john@example.com,John,Doe
Wenn es sich um ein leeres mittleres Feld handelt, das beabsichtigt ist, muss Ihre Kopfzeile/Zuordnung diese Spalte ebenfalls enthalten.
Zu wenige Spalten in Zeile X
Diese Zeile enthält weniger Werte, als die Kopfzeile erfordert, normalerweise aufgrund fehlender Trennzeichen oder fehlerhafter Anführungszeichen/Zeilenumbrüche.
Wie das in der Praxis aussieht
Kopfzeile (erwartet 4 Spalten):
email,firstname,lastname,city
Fehlerhafte Zeile (nur 3 Spalten → „zu wenige Spalten“):
john@example.com,John,Sofia
Hier fehlt der lastname-Wert (oder ein Trennzeichen), sodass die Zeile nur 3 anstelle von 4 Feldern hat.
Falsches E-Mail-Format (Feld: email)
Der E-Mail-Wert in dieser Zeile ist keine gültige E-Mail-Adresse (fehlendes @, Leerzeichen, ungültige Zeichen, mehrere E-Mails usw.).
Häufige Beispiele, die dies auslösen
Fehlendes @:
john.example.com
Fehlender Domain-Teil:
john@
Leerzeichen (oft durch Kopieren/Einfügen):
john @example.com
Nachgestellte/vorangestellte Leerzeichen (können unsichtbar sein):
" john@example.com "
Ungültige Zeichen:
john<>@example.com
Zwei E-Mails in einer Zelle:
john@example.com; jane@example.com
Anzeigename anstelle der reinen Adresse:
John Doe <john@example.com>
Lösung
Stellen Sie sicher, dass die Zelle nur eine E-Mail im Standardformat enthält:
john@example.com
(Leerzeichen entfernen, Namen/Klammern entfernen und mehrere E-Mails in separate Zeilen aufteilen.)
Doppelte E-Mail (Feld: email)
Dieselbe E-Mail erscheint mehr als einmal in der hochgeladenen Datei.
Lokaler Teil zu lang (Feld: E-Mail)
Der Teil vor dem @ ist länger als erlaubt, was oft durch eine falsche Spaltenzuordnung oder ungültige Daten in der E-Mail-Spalte verursacht wird. Ordnen Sie die richtige E-Mail-Spalte zu und korrigieren Sie den Wert.
Domain zu lang (Feld: E-Mail)
Der Teil nach dem @ ist länger als erlaubt, was oft durch eine falsche Zuordnung oder falsch formatierte E-Mail-Werte verursacht wird. Ordnen Sie korrekt zu und korrigieren Sie die E-Mail.
Wert konnte nicht konvertiert werden (FieldName)
Diese Fehler bedeuten, dass die Eigenschaft existiert, aber der Wert in der Zeile nicht gespeichert werden kann, weil er nicht mit dem Typ der Eigenschaft in der Datenbank übereinstimmt. Formatieren Sie den Wert korrekt (z. B. gültige Daten, rein numerische Zahlen).
Beispiel (Ganzzahl-Eigenschaft)
Eigenschaft: age ist Ganzzahl
CSV-Zeile enthält:
email,age john@example.com,abc
→ Die Konvertierung schlägt fehl, da abc keine Ganzzahl ist.
Lösung:
john@example.com,43
Beispiel (Datumseigenschaft)
Eigenschaft: birthdate erwartet ein Datum
email,birthdate john@example.com,today
→ ungültiges Datumsformat/Wert.
Lösung (erwartetes Format verwenden):
john@example.com,2026-03-06
Fehler bei der Eigenschaftsvalidierung (FieldName)
Dieser Fehler bedeutet, dass der von Ihrer CSV-Kopfzeile übernommene Name der Kontakteigenschaft nicht zulässig ist, sodass das System diese Eigenschaft nicht erstellen/zuordnen kann.
1) Ungültiges Zeichen im Namen an Position N: X
Bedeutung: Der Eigenschaftsname (Spaltenkopfzeile) enthält ein verbotenes Zeichen an Position N.
Beispiel (fehlerhafte Kopfzeile):
email,first-name john@example.com,John
Wenn - nicht erlaubt ist → ungültiges Zeichen.
Lösung: Benennen Sie die Kopfzeile um und verwenden Sie zulässige Zeichen (normalerweise Buchstaben/Unterstrich):
email,first_name
2) Zahlen können nicht als Namen verwendet werden: X
Bedeutung: Der Eigenschaftsname darf nicht nur aus Zahlen bestehen (oder je nach Regeln nicht mit einer Zahl beginnen).
Beispiel (fehlerhafte Kopfzeile):
email,123 john@example.com,test
Lösung:
email,field_123
3) Ungültiger Name: X ist ein reserviertes Wort.
Bedeutung: Die Kopfzeile stimmt mit einem reservierten Schlüsselwort überein, das das System nicht als Eigenschaftsnamen zulässt.
Beispiel (fehlerhafte Kopfzeile):
email,class john@example.com,A
Lösung: Benennen Sie die Kopfzeile um:
email,customer_class
Zugeordnete Kopfzeile hat weniger Spalten als die Kopfzeile in der Datei
Wenn Sie eine CSV-Datei importieren, liest das System zuerst die Kopfzeile – die Spaltennamen am Anfang der Datei. Auf dem Importbildschirm wird dann versucht, jede Spalte einer vorhandenen Kontakteigenschaft zuzuordnen, oder es wird vorgeschlagen, eine neue mit einem geeigneten Datentyp zu erstellen.
Dieser Vorgang wird als zugeordnete Kopfzeile bezeichnet. Sie legt fest, wie die Spalten in Ihrer CSV-Datei den Feldern entsprechen, die Mailjet während des Imports verwenden wird.
Wenn die zugeordnete Kopfzeile nicht mit der tatsächlichen Kopfzeile in der Datei übereinstimmt, kann der Import nicht fortgesetzt werden und wird sofort beendet.
Wenn dieser Fehler auftritt, kontaktieren Sie bitte unser Supportteam für weitere Unterstützung.
Zugeordnete Kopfzeile hat mehr Spalten als die Kopfzeile in der Datei
Wenn Sie eine CSV-Datei importieren, liest das System zuerst die Kopfzeile – die Spaltennamen am Anfang der Datei. Auf dem Importbildschirm wird dann versucht, jede Spalte einer vorhandenen Kontakteigenschaft zuzuordnen, oder es wird vorgeschlagen, eine neue mit einem geeigneten Datentyp zu erstellen.
Dieser Vorgang wird als zugeordnete Kopfzeile bezeichnet. Sie legt fest, wie die Spalten in Ihrer CSV-Datei den Feldern entsprechen, die Mailjet während des Imports verwenden wird.
Wenn die zugeordnete Kopfzeile nicht mit der tatsächlichen Kopfzeile in der Datei übereinstimmt, kann der Import nicht fortgesetzt werden und wird sofort beendet.
Wenn dieser Fehler auftritt, kontaktieren Sie bitte unser Supportteam für weitere Unterstützung.