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 die Überschriften.
• Jede Zeile ist entweder mit einer E-Mail-Adresse oder einer Telefonnummer verknüpft.
• 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 Importprozess proaktiv zu beschleunigen, besteht jedoch darin, vor dem Import alle doppelten E-Mail-Adressen aus deiner CSV zu entfernen. Wir empfehlen dringend, den Import einer neuen Liste mindestens einen Tag im Voraus zu planen, bevor du beabsichtigst, den Kontakten auf der Liste eine E-Mail zu senden.

Nachdem ein Import begonnen hat, siehst du zunächst eine Statusleiste. Wenn du wegklickst, kannst du den Fortschritt des Imports immer noch verfolgen, indem du beobachtest, wie die Anzahl der Listen im Laufe der Zeit steigt. Wir senden dir eine E-Mail, sobald der Listenimport abgeschlossen ist.

Fehlerbehebung beim Import

Wenn sich deine Liste nicht hochladen lässt, suche in deiner CSV-Datei nach den folgenden häufigen Fehlern, die diese Hürde verursachen könnten:

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.

Überprüf außerdem, ob deine CSV mit den Formatierungsanforderungen von Klaviyo übereinstimmt. Falls noch nicht geschehen, sieh dir unsere Dokumentation zum Formatieren deiner Daten an. Ein erforderliches Feld ist zum Beispiel für E-Mail-Adressen.

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, zulässigen Formate und 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 $
• Numerisch
  Alle Nummern. Füge 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"]
• Einwilligung
  Die Einwilligung ist als Kanal (E-Mail, SMS usw.) und als Art der Einwilligung formatiert (falls in Klaviyo mehrere Arten verfügbar sind). Die einzige Option für E-Mail ist Einwilligung für E-Mail-Marketing; für SMS wäre es entweder Einwilligung für SMS-Marketing oder Einwilligung für transaktionale SMS; usw. Der Wert dieses Feldes muss „abonnieren“, „Never Subscribed“ oder „abgemeldet“ sein. 

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.

Fehlerbehebung bei Fehlermeldungen zu doppelten oder fehlenden eindeutigen Kennungen

Doppelte Kennungen

Datensätze, die aufgrund von „Doppelte eindeutige ID“ übersprungen wurden, bedeuten, dass eine E-Mail-Adresse oder Telefonnummer in deiner Datei wiederholt wurde. In diesen Fällen verarbeitet Klaviyo die Daten aus der ersten Zeile, die die wiederholte Kennung enthält, und stellt alle nicht verarbeiteten Datensätze in einer herunterladbaren Datei bereit.

Klicke auf Übersprungene Datensätze herunterladen, um die Kontakte zu sehen, die aufgrund doppelter Kennungen übersprungen wurden, und lade diese übersprungenen Datensätze bei Bedarf erneut hoch.

Fehlende eindeutige Kennungen

Datensätze, die aufgrund von „Missing Unique ID“ übersprungen wurden, bedeuten, dass die übersprungenen Zeilen keine E-Mail-Adresse, Telefonnummer oder andere akzeptierte eindeutige Kennung enthielten.

Klicke auf Übersprungene Datensätze herunterladen, um die Kontakte zu sehen, die aufgrund fehlender Identifikatoren übersprungen wurden, füge für jede*n eine E-Mail-Adresse oder Telefonnummer hinzu, und lade deine neue Datei erneut hoch.

Fehlender Wert in einem erforderlichen Feld

Stell sicher, dass alle erforderlichen Felder Werte zugewiesen haben. Wenn zum Beispiel bei einem deiner aufgeführten Kontakte in der E-Mail-Spalte eine E-Mail-Adresse fehlt, wird beim Hochladen ein Fehler angezeigt. Prüfe, ob jeder Kontakt, den du hochladen möchtest, für alle erforderlichen Felder einen Wert hat. Wenn sie leer sind, fülle sie vor deinem nächsten Versuch zum Hochladen aus.

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.