Fehlerbehebung bei Listenimporten

Übersicht

Erfahre, wie du Fehler behebst, die auftreten, wenn du eine CSV-Datei mit Kontakten in eine neue oder bestehende Liste in Klaviyo hochlädst. Bewertungen hochladen? Sieh dir unseren Artikel zum Importieren von Bewertungen an.

Bevor du anfängst

Möchtest du sicherstellen, dass deine Datei importiert wird? Prüfe die folgende Liste der Anforderungen, bevor du deine Liste importierst.

• CSV-Datei (kein anderes Format)
• Die Dateigröße beträgt 50 MB oder weniger.
• Die erste Zeile enthält für jede Spalte eine eindeutige, nicht leere Kopfzeile.
• Jede Zeile hat eine gültige eindeutige Kennung, z. B. eine E-Mail-Adresse, Telefonnummer oder externe ID.
• Es gibt keine doppelten E-Mail-Adressen oder Telefonnummern

Unser Support-Team kann keine CSV-Dateien in deinem Namen in Klaviyo importieren. Wenn du Hilfe beim Import brauchst, sieh dir bitte den Abschnitt zur Fehlerbehebung unten an. Dort findest du Tipps, wie du Probleme beim Listenimport erfolgreich beheben kannst.

Inhalt

• Importverzögerung
• Fehlerbehebung beim Import
• Alle Spalten als einzelnes Feld importiert
• Fehlermeldungen für ungültiges Format
• Falsche Datums- oder Zeitstempelformatierung
• Fehlermeldungen zu duplizierten oder fehlenden eindeutigen Kennungen
• Fehlender Wert in einem erforderlichen Feld
• Probleme mit der Formatierung von Telefonnummern

Importverzögerung

Wenn du eine große Datei mit einer erheblichen Datenmenge importierst, kann der Importvorgang mehrere Stunden dauern, bis er abgeschlossen ist. Leider gibt es keine Möglichkeit, diesen Vorgang zu beschleunigen, sobald er begonnen hat. Eine Möglichkeit, den Importvorgang vorab zu beschleunigen, besteht jedoch darin, vor dem Import alle doppelten E-Mail-Adressen aus deiner CSV zu entfernen. Wir empfehlen dir dringend, den Import einer neuen Liste mindestens 1 Tag im Voraus zu planen, bevor du den Kontakten auf der Liste E-Mails senden möchtest.

Nachdem ein Import gestartet wurde, siehst du zunächst eine Statusleiste. Wenn du wegklickst, öffne die Liste und wähle den Tab Importe aus, um den Fortschritt und die Ergebnisse zu prüfen. Wir senden dir eine E-Mail, sobald ein Listenimport abgeschlossen ist.

Fehlerbehebung beim Import

Wenn deine Datei nicht hochgeladen werden kann oder einige Zeilen übersprungen werden, sieh dir die häufigen Fehler unten an. So findest und korrigierst du übersprungene Zeilen, nachdem ein Import abgeschlossen ist:

1. Öffne die Liste und wähle den Tab Importe aus.
2. Klicke bei einem Import, der als Mit Fehlern abgeschlossen markiert ist, auf Fehlerdatei herunterladen, wenn die Schaltfläche verfügbar ist.
3. Verwende die Spalte Fehler in der heruntergeladenen CSV, um die betroffenen Zeilen zu identifizieren und zu korrigieren. Entferne die Spalten Fehler und Warnungen aus der korrigierten Datei, damit sie nicht als Profileigenschaften importiert werden.
4. Klicke auf Neue Datei hochladen und lade deine korrigierte CSV hoch. Ordne die Spalten zu, überprüfe die Einwilligungseinstellungen und klicke auf Importieren, um den Import zu starten.

Wenn Fehlerdatei herunterladen nicht verfügbar ist, prüfe deine ursprüngliche CSV anhand der Fehlerbehebungsanleitung unten und korrigiere sie, bevor du sie erneut hochlädst.

Alle Spalten als einzelnes Feld importiert

Wenn du eine Version von Excel verwendest, die Englisch nicht als Standardsprache verwendet, kann deine Software Semikolons statt Kommas als Trennzeichen in deiner Datei verwenden. Falls das der Fall ist, kann deine Datei beim Import so aussehen:

Um das zu beheben, gehe zur Einstellung Zahlenformat oder Listentrennzeichen (oder Zahlentrennzeichen) deines Computers. Diese Einstellung befindet sich wahrscheinlich in den Sprach- und Region -Einstellungen und möglicherweise im Abschnitt Erweiterte Einstellungen. Ersetze das Semikolon durch ein Komma und speichere. Wenn du jetzt Dateien als CSV exportierst, wird das Kommaformat verwendet. Beachte, dass sich der genaue Ort dieser Einstellung je nach Betriebssystem unterscheiden kann.

Prüfe außerdem, ob deine CSV mit den Formatierungsanforderungen von Klaviyo übereinstimmt. Wenn du das noch nicht getan hast, sieh dir unsere Dokumentation zum Formatieren deiner Daten an. Jede Zeile braucht eine gültige eindeutige Kennung; eine E-Mail-Adresse ist nicht erforderlich, wenn eine andere akzeptierte Kennung angegeben wird.

Behebung von Fehlermeldungen zum ungültigen Format

Wenn du eine Liste in Klaviyo importierst, kannst du auf der Feldzuordnungsseite alle Eigenschaften dem entsprechenden Datentyp in Klaviyo zuordnen. Beispielsweise hat E-Mail immer den Datentyp Text; wenn du hingegen eine benutzerdefinierte Eigenschaft für Geburtstag hochlädst, solltest du den Datentyp auf Datum festlegen.

Sieh dir unten die Datentypen, die Formate der Zustimmungseigenschaft und die Beispiele an.

• Text
  Beliebiger Text oder eine Kombination aus Text und Zahlen. Wenn du dir nicht sicher bist, in welchem Format deine Daten vorliegen, wähle diese Option.
  • Beispiele:
    email@example.com
    Hallo, Welt
    5,00 $
• Nummer
  Alle Nummern. Gib in numerischen Feldern keine Währungssymbole ein.
  • Beispiele:
    2
    5,0031
    130,0
• Boolean
  Werte „True“ oder „False“.
  • Beispiele:
    wahr
    falsch
• Datum
  Sieh dir unseren Leitfaden zu Zulässige Datums- und Zeitstempelformate für Profil- und Ereigniseigenschaften an, um mehr über zulässige Datumsformate zu erfahren.
  • Beispiel:
    2014-09-01 13:34:08
• Liste
  Daten müssen als JSON-Array formatiert sein.
  • Beispiele:
    ["Äpfel","Bananen","Orangen"]
    ["Äpfel"]
• Einwilligungseigenschaften
  Ordne jede Einwilligungsspalte der Eigenschaft für ihren Kanal und Einwilligungstyp zu, z. B. E-Mail-Marketing-Einwilligung, SMS-Marketing-Einwilligung oder SMS-Transaktions-Einwilligung. Diese Eigenschaften verwenden den Datentyp Text. Gib als Wert „abonnieren“, „Niemals abonniert“ oder „abmelden“ ein.

Weitere Informationen dazu, was die verschiedenen Datentypen bedeuten und welchen du beim Importieren deiner Liste auswählen solltest, findest du in unserem Leitfaden zum Verständnis von Datentypen.

Weitere Informationen zu Fehlermeldungen vom Typ „Ungültiges Format [Datentyp]“ (z. B. „Ungültiges Listenformat“) findest du in unserem Leitfaden zur Fehlerbehebung bei Fehlermeldungen zu ungültigen Formaten.

Falsche Datums- oder Zeitstempelformatierung

Möglicherweise verwendest du das falsche Format für Datums- oder Zeitstempel. Wenn du eines davon hinzugefügt hast und dir nicht sicher bist, welche Formate Klaviyo akzeptiert, sieh dir unseren Leitfaden zu zulässigen Datums- und Zeitstempelformaten für Profil- und Ereigniseigenschaften an.

Wenn du eine Fehlermeldung zu einem ungültigen Zeitstempel für die Einwilligung erhältst, überprüfe, ob der Zeitstempel widerspiegelt, wann die Einwilligung erteilt wurde, und ob er am oder nach dem 1. Januar 1990 liegt. Überprüfe auch die Zeitzone: Ein Zeitstempel ohne Offset wird als UTC gelesen, wodurch eine lokale Zeit so aussehen kann, als läge sie in der Zukunft.

Fehlerbehebung bei Fehlermeldungen zu doppelten oder fehlenden eindeutigen Kennungen

Doppelte Kennungen

Fehler aufgrund doppelter Kennungen bedeuten, dass mehrere Zeilen dieselbe Profilkennung verwenden, z. B. eine E-Mail-Adresse oder Telefonnummer. Klaviyo kann doppelte Zeilen überspringen, und du solltest dich nicht darauf verlassen, dass die erste Zeile in deiner Datei importiert wird. Fasse die Details jeder Kontaktperson in 1 Zeile zusammen, bevor du erneut importierst.

Klicke auf Fehlerdatei herunterladen, falls verfügbar, um übersprungene Zeilen aufgrund doppelter Kennungen zu prüfen. Prüfe die Details, die du behalten möchtest, bevor du sie erneut hochlädst, da importierte Werte ein bestehendes Profil aktualisieren können.

Fehlende eindeutige Kennungen

Ein Fehler wegen einer fehlenden eindeutigen Kennung bedeutet, dass eine übersprungene Zeile keine E-Mail-Adresse, Telefonnummer oder eine andere akzeptierte eindeutige Kennung enthielt.

Klicke, falls verfügbar, auf Fehlerdatei herunterladen, um Zeilen zu überprüfen, die aufgrund fehlender Identifikatoren übersprungen wurden. Füge für jede*n Kontakt*in einen gültigen Identifikator hinzu und stelle sicher, dass die Spalte vor dem erneuten Hochladen der entsprechenden Klaviyo-Eigenschaft zugeordnet ist.

Fehlender Wert in einem erforderlichen Feld

Überprüfe die für die Informationen erforderlichen Felder, die du importierst. Beispielsweise benötigt eine Zeile mit E-Mail-Einwilligung eine E-Mail-Adresse, und eine Zeile mit SMS-Einwilligung benötigt eine Telefonnummer. Fülle den fehlenden Wert aus oder entferne Einwilligungsinformationen, die nicht auf diesen Kontakt zutreffen, bevor du erneut hochlädst.

Ungültige E-Mail-Adresse oder nicht erkannte Zeichen

Wenn du diese Fehlermeldung erhältst, überprüfe die E-Mail-Adressen in deiner Datei auf ungültige Zeichen. Zu den ungültigen Zeichen gehören ( ) , : ; [ ] sowie Leerzeichen.

Übertragung von Profilen zwischen Konten

Beim Übertragen von Profilen von einem Konto in ein anderes gibt es einige Eigenschaften, die nicht in ein anderes Konto hochgeladen werden können.

Beispielsweise kann Profil erstellt am nicht übertragen werden, weil es auf das Datum festgelegt ist, an dem ein Profil im Konto erstellt wird. Ein weiteres Beispiel sind Zuerst aktiv und Zuletzt aktiv, da diese automatisch basierend auf der Profilaktivität im Konto festgelegt werden.

Probleme mit der Formatierung von Telefonnummern

Telefonnummern müssen eine Ländervorwahl enthalten oder eine separate Spalte, die ihr Land angibt, und müssen einem akzeptierten Telefonnummernformat entsprechen. Erfahre, wie du Telefonnummern korrekt formatierst und hochlädst.

Weitere Ressourcen