Kontakte importieren und exportieren

Mit dem Import-Assistenten übernehmen Sie Kontakte aus einer Tabelle, und mit dem Export laden Sie die Kontakte herunter, die Ihren aktuellen Filtern entsprechen. Diese Seite behandelt auch die Massenaktionen und den Export-Endpunkt der API, mit denen Sie dasselbe per Code erledigen.

Voraussetzungen

• Erstellen Sie alle eigenen Felder, die Sie aus der Datei füllen möchten. Der Assistent kann Spalten nur bereits vorhandenen Feldern zuordnen.
• Erstellen Sie die Kontaktlisten, denen die Kontakte beitreten sollen. Importe zählen zum Abonnentenlimit jeder Kontaktliste.
• Importieren Sie nur Personen, die zugestimmt haben, von Ihnen zu hören. Bei der Prüfung des Produktionszugangs wird gefragt, wie Sie Abonnenten gewinnen. Siehe Produktionszugang.

Datei vorbereiten

Der Assistent liest .csv-, .xlsx- und .xls-Dateien mit bis zu 2.500 Kontakten pro Datei. Teilen Sie größere Listen auf mehrere Dateien auf.

email,first_name,last_name,company,birthday
ada@example.com,Ada,Lovelace,Acme,1990-04-12
grace@example.com,Grace,Hopper,Acme,1906-12-09
alan@example.com,Alan,Turing,,

Tipps für einen sauberen Import:

• Ein Kontakt pro Zeile, die Spaltennamen in der ersten Zeile. Aus Excel-Dateien wird nur das erste Tabellenblatt gelesen.
• Benennen Sie Spalten nach Ihren Feldern, damit der Assistent sie automatisch zuordnet. Eine Spaltenüberschrift wird automatisch zugeordnet, wenn sie ohne Beachtung der Groß-/Kleinschreibung dem Namen oder Schlüssel eines Felds entspricht, zum Beispiel email, First name, first_name oder ein Schlüssel eines eigenen Felds wie company.
• Speichern Sie CSV-Dateien als UTF-8, damit Namen mit Akzenten korrekt übernommen werden.
• Schreiben Sie Datumsangaben als YYYY-MM-DD. Datumszellen in Excel-Dateien funktionieren ebenfalls. Andere Datumsformate werden abgelehnt.
• Prüfen Sie die Adressen. Eine einzige ungültige E-Mail-Adresse stoppt den gesamten Import mit einem Fehler, der die Zeile nennt, zum Beispiel „Contact #12 has an invalid email address.“ Zeilen mit leerer E-Mail-Zelle werden übersprungen.
• Werte für Mehrfachauswahl werden als einzelner Textwert importiert. Um mehrere Optionen als Liste zu speichern, setzen Sie sie per API.

Kontakte importieren

1. Assistenten öffnen. Öffnen Sie Email Marketing›Contacts und wählen Sie Import.

2. Datei auswählen. Wählen Sie unter CSV File Ihre Datei. Lassen Sie File has header angehakt, wenn die erste Zeile Spaltennamen enthält. Der Assistent zeigt die ersten Zeilen und die Gesamtzahl der Zeilen, mit einer Warnung, wenn die Datei mehr als 2.500 Zeilen hat. Wählen Sie Continue.

3. Spalten zuordnen. Wählen Sie für jede Spalte das Kontaktfeld, das sie füllt: Email, First name, Last name, eines Ihrer eigenen Felder oder Exclude, um sie zu überspringen. Eine Spalte müssen Sie Email zuordnen. Jede Zeile zeigt Beispielwerte, damit Sie die Zuordnung prüfen können.

4. Kontaktlisten auswählen. Wählen Sie unter Audiences die Kontaktlisten, denen die Kontakte beitreten sollen, oder lassen Sie das Feld leer, um Kontakte zu importieren, ohne sie einer Liste hinzuzufügen. Wählen Sie Continue.

5. Prüfen und importieren. Die Vorschau zeigt die Datei, die Anzahl der Kontakte, die Kontaktlisten, die Spaltenzuordnung und die ersten 10 Kontakte so, wie sie gespeichert werden. Wählen Sie Import.

Emailit validiert zuerst die gesamte Datei. Stimmt etwas nicht, etwa eine ungültige Adresse, ein unbekanntes eigenes Feld oder eine volle Kontaktliste, wird nichts importiert, und die Fehler werden aufgelistet, damit Sie die Datei korrigieren können. Andernfalls läuft der Import im Hintergrund in Batches von 500. Aktualisieren Sie die Seite Contacts nach einem Moment, um die neuen Kontakte zu sehen.

Was mit bestehenden Kontakten passiert

Kontakte werden anhand der E-Mail-Adresse abgeglichen, ohne Beachtung der Groß-/Kleinschreibung.

Außerdem wichtig:

• Die Zuordnungsliste enthält Unsubscribed, der Import wendet es aber nicht an. Um importierte Personen als abgemeldet zu kennzeichnen, wählen Sie sie danach auf der Seite Contacts aus und nutzen Sie die Massenaktion Unsubscribe.
• Importe senden keine Webhook-Events contact.* oder subscriber.* und starten keine Automatisierungen wie Added to audience.
• Würde eine Kontaktliste ihr Abonnentenlimit überschreiten, wird der Import mit dem Limit in der Meldung abgelehnt, zum Beispiel „Pay as you go includes 10,000 subscribers per audience.“ Siehe Kontaktlisten.

Kontakte exportieren

1. Liste eingrenzen. Nutzen Sie unter Email Marketing›Contacts die Suche und Filter, um die gewünschten Kontakte anzuzeigen. Ohne Suche und Filter enthält der Export alle Kontakte.

2. Exportieren. Wählen Sie Export und dann CSV oder XLSX. Ihr Browser lädt contacts.csv oder contacts.xlsx herunter.

Ein Export kann bis zu 10.000 Kontakte enthalten. Entsprechen mehr Kontakte den Filtern, schlägt der Export fehl. Fügen Sie dann Filter hinzu, etwa eine Kontaktliste oder einen Zeitraum für das Erstellungsdatum, und exportieren Sie in Teilen.

Die Datei hat eine Zeile pro Kontakt und diese Spalten:

Per API nutzen

Die API hat keinen Dateiimport. Um viele Kontakte per Code hinzuzufügen, rufen Sie für jeden Kontakt erstellen auf oder Abonnent hinzufügen, um den Kontakt und seine Mitgliedschaft in der Kontaktliste mit einem Aufruf anzulegen.

Massenaktionen

POST /v2/contacts/bulk führt eine Aktion für bis zu 100 Kontakte aus, angegeben über ihre con_-ID:

curl https://api.emailit.com/v2/contacts/bulk \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "add_to_audience",
    "ids": ["con_2kq8Vt4xLm7Rz", "con_9fW3pQ1nBc6Yt"],
    "audience_id": "aud_5hJ2kL8mNp4Qr"
  }'

{
  "object": "contact_bulk",
  "action": "add_to_audience",
  "processed": 2,
  "ids": ["con_2kq8Vt4xLm7Rz", "con_9fW3pQ1nBc6Yt"]
}

Die Anfrage schlägt insgesamt fehl, wenn ids mehr als 100 Einträge hat (400) oder wenn ein Kontakt oder die Kontaktliste nicht existiert (404, mit den unbekannten IDs in missing). Um mehr Kontakte zu verarbeiten, blättern Sie durch Kontakte auflisten und senden Sie Batches von 100.

Export

GET /v2/contacts/export liefert dieselbe Datei wie die Weboberfläche. Setzen Sie format auf csv (Standard) oder xlsx und fügen Sie beliebige Filter, Suche und Sortierung von Kontakte auflisten hinzu:

curl "https://api.emailit.com/v2/contacts/export?format=csv&audience_id=aud_5hJ2kL8mNp4Qr&unsubscribed=false" \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o contacts.csv

Entsprechen mehr als 10.000 Kontakte den Filtern, gibt der Endpunkt 422 mit „Export is limited to 10000 contacts. Narrow your filters and try again.“ zurück.

Siehe auch