Diese Anleitung zeigt dir, wie du Empfänger aus einer oder mehreren CSV-Dateien in einen One-Shot hochlädst.

Du kannst für jede Variante eine oder mehrere CSV-Dateien hochladen. Du kannst CSV-Dateien auch mit Empfängern kombinieren, die du per API oder aus deiner Marketing-Integration sendest. Alle Empfänger landen im selben One-Shot und warten auf die Empfängervalidierung.

Bevor du startest

• Du brauchst einen One-Shot mit dem Status Wartet auf Empfänger. Diesen Status bekommt ein One-Shot, wenn du am Ende der Einrichtung auf Empfänger hinzufügen klickst.
• Du brauchst eine oder mehrere CSV-Dateien mit UTF-8-Kodierung.
• Beim Start des Uploads darf keine Validierung laufen.

Was deine Datei braucht

Der Abschnitt Empfänger-Upload auf der One-Shot-Seite zeigt diese Regeln. Klicke neben Was deine Datei braucht auf Mehr erfahren, um sie zu öffnen.

Dateiformat

• UTF-8-Kodierung.
• Komma oder Semikolon als Trennzeichen.
• Bis zu 500.000 Zeilen pro Datei.
• Bis zu 200 MB pro Datei.
• Der Dateiname muss auf .csv enden.

Spalten

Die erste Zeile deiner Datei ist die Kopfzeile. Sie enthält die Spaltennamen. Die Spaltennamen sind englisch und werden nicht übersetzt. Schreibe sie genau wie hier, mit derselben Groß- und Kleinschreibung. zipcode oder ZipCode funktioniert nicht. Verwende zipCode.

Jede Datei braucht diese Spalten:

Kombiniere nicht beide Formen einer Gruppe:

• firstName und fullName dürfen nicht zusammen in einer Datei stehen.
• address1 darf nicht zusammen mit street oder houseNumber in einer Datei stehen.

Du kannst außerdem diese Spalten verwenden:

• title, otherTitles, gender, jobTitle
• companyName1, companyName2, companyName3
• address2, address3, country, careOf
• Für die Personalisierung: individualisation1 bis individualisation100

Verwende jeden Spaltennamen nur einmal. Das Dashboard lehnt eine Datei mit jedem anderen Spaltennamen ab. Lösche oder benenne Spalten um, die nicht in dieser Liste stehen.

Beispiel

Eine Kopfzeile für eine Datei mit Vor- und Nachnamen:

• firstName,lastName,street,houseNumber,zipCode,city

Dieselbe Datei als Tabelle:

Weitere gültige Kopfzeilen:

• fullName,street,houseNumber,zipCode,city
• fullName,address1,zipCode,city

Schritt 1: Dateien hinzufügen

1. Öffne deinen One-Shot auf der Seite Mailings.
2. Gehe zum Abschnitt Empfänger-Upload.
3. Ziehe deine CSV-Dateien auf CSV-Dateien hier ablegen. Du kannst auch auf die Fläche klicken und die Dateien auswählen.

Du kannst viele Dateien gleichzeitig hinzufügen.

Schritt 2: Jeder Datei eine Variante zuordnen

Das Dashboard prüft jede Datei, bevor es etwas sendet. Die Zeile zeigt Spaltennamen werden geprüft …. Danach zeigt die Zeile den Dateinamen und die Anzahl der Zeilen.

Hat dein One-Shot mehr als eine Variante, braucht jede Datei eine Variante:

• Benenne die Datei nach der Variante. Das Dashboard wählt die Variante dann für dich aus. Nutze den Namen, den du der Variante gegeben hast, zum Beispiel Rabatt.csv für Variante A · Rabatt. Auch der Name mit dem Buchstaben funktioniert, zum Beispiel Variante A.csv. Groß- und Kleinschreibung und Leerzeichen spielen keine Rolle.
• Wähle für alle anderen Dateien die Variante unter Variante aus. Die Liste zeigt Variante A, Variante B und so weiter, und den Namen der Variante, wenn du ihr einen gegeben hast.
• Eine Datei, die die Prüfung der Spalten besteht, aber keine Variante hat, zeigt Wähle eine Variante für diese Datei.

Hat dein One-Shot nur eine Variante, gibt es kein Feld Variante. Alle Dateien gehen an diese Variante.

Um eine Datei aus der Liste zu entfernen, klicke auf das Papierkorb-Symbol in ihrer Zeile.

Schritt 3: Probleme beheben

Hat eine Datei ein Problem, zeigt die Zeile eine rote Meldung unter dem Dateinamen. Der Upload-Button bleibt deaktiviert. Sein Tooltip sagt Korrigiere oder entferne fehlerhafte Dateien, um hochzuladen.

So korrigierst du eine Datei:

1. Entferne die Datei mit dem Papierkorb-Symbol aus der Liste.
2. Korrigiere die Datei auf deinem Computer. Siehe Probleme beheben.
3. Füge die korrigierte Datei erneut hinzu.

Im Beispiel nutzt die Datei den Spaltennamen zipcode. Die Zeile zeigt zipcode ist kein optilyz-Feldname und zipCode fehlt.

Schritt 4: Upload starten

Klicke auf den Upload-Button. Er zeigt die Anzahl der Dateien, zum Beispiel 2 Dateien hochladen.

Läuft gerade eine Validierung, kannst du den Upload nicht starten. Der Abschnitt zeigt Eine Validierung läuft. Lade deine Dateien hoch, sobald die Validierung abgeschlossen ist. Du kannst deine Dateien in der Zwischenzeit hinzufügen und prüfen lassen.

Die Dateien werden nacheinander hochgeladen. Ein Fortschrittsbalken zeigt, wie viele Dateien fertig sind, zum Beispiel 0 von 2 Dateien fertig.

Lass diesen Tab offen, bis deine Dateien hochgeladen sind. Schließt du den Tab, stoppen die Dateien, die noch nicht gesendet sind.

Jede Datei zeigt einen Status:

Schritt 5: Ergebnis prüfen

Sind alle Dateien fertig, leert sich die Liste. Eine Meldung zeigt das Ergebnis:

• Grün, zum Beispiel: 2.000 Empfänger verarbeitet. Sie stehen in Kürze zur Validierung bereit.
• Rot: 1 Datei wurde nicht hinzugefügt, oder die Anzahl der Dateien. Jede Zeile zeigt den Dateinamen und den Grund.
• Orange: Wir konnten 1 Datei nicht bestätigen, oder die Anzahl der Dateien, mit Lade die Seite neu, um zu sehen, ob diese Dateien angekommen sind.

Wie es weitergeht

Die hochgeladenen Empfänger warten auf die Empfängervalidierung. Im Abschnitt Empfängervalidierung zählen sie zu … warten auf Validierung.

Klicke auf Empfänger validieren, um sie zu prüfen. Du kannst später weitere Dateien hochladen und erneut validieren. Die Schritt-für-Schritt-Anleitung zeigt dir, wie Validierung, Postauflieferungsdatum und Buchung funktionieren.

Probleme beheben

Gut zu wissen

• Ein Upload sperrt andere Aktionen. Während der Upload läuft, kannst du nicht auf Empfänger validieren oder Bearbeiten klicken. Der Tooltip von Bearbeiten sagt Du kannst deinen One-Shot nicht bearbeiten, während ein CSV-Upload läuft.
• Eine Validierung sperrt den Upload. Während eine Validierung läuft, sagt der Tooltip des Upload-Buttons Du kannst nicht hochladen, während eine Validierung läuft.
• Jeder Upload fügt Empfänger hinzu. Eine neue Datei ersetzt keinen früheren Upload. Zwei Dateien für dieselbe Variante sind erlaubt. Die Empfänger werden zusammengezählt.
• Bearbeiten löscht deine hochgeladenen Empfänger. Bearbeiten löscht alle Empfänger des One-Shots, auch die Empfänger aus CSV-Dateien. Der Dialog sagt Alle von dir übertragenen Empfänger werden gelöscht. Klicke nach dem Bearbeiten erneut auf Empfänger hinzufügen, und lade deine Dateien erneut hoch.
• CSV-Dateien brauchen keine Datenzuordnung. Die Spaltennamen sagen optilyz, welcher Wert wohin gehört.
• Uploads legen die Datenzuordnung fest. Das gilt nur, wenn du auch Empfänger aus Emarsys oder Salesforce Marketing Cloud sendest. Hat dein One-Shot eine Datenzuordnung, legen die ersten Empfänger sie fest. Empfänger aus CSV-Dateien zählen auch. Danach kannst du die Datenzuordnung nur noch über Bearbeiten ändern. Richte die Datenzuordnung darum vor dem Upload ein.
• Die Zahlen sind Summen. Der Abschnitt Empfängervalidierung zeigt eine Zahl für alle Quellen zusammen. Er zeigt nicht, wie viele Empfänger aus CSV-Dateien kommen. Konnten Empfänger aus CSV-Dateien nicht validiert werden, nennt der Abschnitt CSV als Quelle.

Weitere Artikel

• One-Shot: Schritt-für-Schritt-Anleitung
• Empfänger per API an einen One-Shot senden
• Eine CSV-Datei erstellen
• Eine CSV-Datei öffnen (Windows)
• Demo-Kit