Daten-Import per XML und CSV

Sie können Ihren Datenbestand via XML oder CSV zu unserem Newslettersystem importieren. Für verschiedene Software existieren bereits Plugins, welche Sie kostenfrei benutzen dürfen. Bei der Generierung der XML- oder CSV-Datei ist darauf zu achten, dass diese im UTF8-Zeichensatz erstellt wird.

Die XML-Datei besteht aus einem Root-Element mit dem Namen "recipients" und beliebig vielen "recipient"-Elementen, die einen Empfänger repräsentieren. Um einen Empfänger korrekt an unser System zu übermitteln, muss mindestens eine valide E-Mailadresse angegeben werden.


  
    alice@example.com
  
  
    peter@example.org
  

Darüber hinaus bieten wir diverse Zusatzfelder an, welche Ihnen helfen, Ihre Adressliste zu pflegen
Sie können folgende Variablen anhängen

key
Identifizierungsmerkmale des Kunden. Sie können Beispielsweise die Kundennummer oder eine UserID übergeben. Falls Sie keinen key übergeben, so wird automatisch die E-Mailadresse verwendet. Der Key wird für den AbmeldeCallBack benötigt, damit eine Referenz zum recipient hergestellt werden kann.
firstname
Der Vorname des recipient.
lastname
Der Nachname des recipient.
name
Sollte Ihr Datenbestand keine separaten Namensfelder aufweisen, können Sie hier den gesamten Namen übergeben. Beispiel: "Steve Martin Balmer".
gender
Das Geschlecht des recipient. Übergeben Sie "m" für männlich und "f" für weiblich.
birthdate
Das Geburtsdatum eines recipient. Das korrekte Format ist Jahr-Monat-Tag.
street
Die Straße inklusive der Hausnummer.
pcode
Eine Postleitzahl.
city
Die Stadt, in der der recipient wohnt.
ccode
Der Ländercode. Beispiel: "DE" für Deutschland.
tag_list
Hier können Sie Tags vergeben. Wollen Sie mehrere vergeben, so sind diese mit einem Komma zu trennen. Beispiel: "Kunde, Rabattgruppe1, Premium".
only_text
Entscheiden Sie, ob der User nur Text-Emails bekommen soll. 1 = nur Text, 0 = Mutlipart. Standardmäßig wird via Multipart verschickt.
approved
Speichern Sie, ob der User über das DoubleOptIn Verfahren seine Adressdaten freigegeben hat. Sollte dies nicht der Fall sein, so bekommt er eine E-Mail in der er seine Anmeldung nochmals bestätigt.

Beispiel für einen Datensatz mit allen Parametern:


  
    12123
    ceo@microsoft.com
    Steve
    Balmer
    f
    1984-12-02
    Hannover
    Hannoversche Straße 1
    DE
    Kunden, Reseller
    30669
    1
    1
  

Möchten Sie Ihren Datenbestand via CSV importieren, so geben Sie in der ersten Zeile bitte die Spaltenüberschrift an. Achten Sie darauf, dass das Pflichtfeld "email" angegeben sein muss, ansonsten wird der Import abgebrochen. Zustäzlich können Sie noch die Felder "firstname", "lastname", "name", "gender", "birthdate", "street", "pcode", "city", "ccode", "approved" angeben.

Beispiel für eine korrekte CSV-Datei

email;firstname;lastname;gender;birthdate;city;pcode;approved
ceo@microsoft.com;Steve;Balmer;f;1984-12-02;Hannover;30669;1
alice@example.com;Alice;Bush;;;Berlin;0
alice@example.com

Zurück zu: API