Die Seite 'Datenimport' bietet Funktionalitäten für manuelle Ad-hoc-Importe und das Planen von regelmäßigen Auto-Importen; beide Importtypen übertragen Ihre Kontaktdaten in die Emarsys Marketing Plattform.
Benutzeranleitungen
Weitere Informationen
Zur Erinnerung: Hier ist das Onboarding-Video zum Import und Export von Kontaktdaten:
Was bedeutet Datenimport?
Der Emarsys Datenimport basiert auf einem einfach zu bedienenden Wizard, mit dem Sie externe Datendateien nach Emarsys importieren und die Zuordnung der Felder überprüfen können.
Es gibt zwei Arten von Importen: manuelle Importe und Auto-Importe. Manuelle Importe ermöglichen einmalige Uploads, während Auto-Importe für regelmäßige Synchronisierungsvorgänge eingerichtet werden können.
Es ist die Methode, mit der Sie aller Wahrscheinlichkeit nach Ihren ersten Kontakt-Upload während Ihres Onboardings vornehmen werden (dieser Upload kann sowohl ein manueller als auch ein Auto-Import sein, je nach der Größe Ihrer Datenbank).
Mit einem manuellen Import können Sie auch all Ihre Offline-Registrierungen aus Flyern, von Messen etc. hochladen.
Der Datenimport wurde für Benutzer mit wenig technischem Know-how entwickelt. Wenn Sie über ausreichende technische Ressourcen verfügen, um das Emarsys API zu verwenden, empfehlen wir diese Methode, die eine bessere Performance und Echtzeit-Synchronisierung ermöglicht.
Wie funktioniert es?
Manuelle Importe
Bei einem manuellen Import laden Sie eine CSV-Datei aus einer lokalen Quelle hoch, ordnen die Felder und Werte Ihren Emarsys Feldern zu und importieren die Datei. Der Import wird im Hintergrund verarbeitet und Sie erhalten eine Benachrichtigung, sobald er abgeschlossen ist.
Für den Import ist ein Feld erforderlich, das als eindeutiger Bezeichner fungiert; anhand dieses Feldes wird überprüft, ob ein Kontakt existiert oder nicht. Neue Kontakte werden in Ihrer Emarsys Datenbank erstellt, bestehende Kontakte werden aktualisiert. Für alle Felder überschreiben die neuen Werte jeweils die alten Werte, mit Ausnahme des Feldes E-Mail Opt-in.
Weitere Informationen erhalten Sie in: Felder und Werte der Upload-Datei zuordnen
Auto-Importe
Bei einem Auto-Import definieren Sie einen Pfad, unter dem Emarsys regelmäßig nach Dateien sucht, die einer bestimmten Namenskonvention folgen; diese Dateien werden importiert.
Alle Kontakte, die per Auto-Import in das System importiert werden, werden in der Emarsys-Applikation als Kontaktliste gespeichert.
Um einen Auto-Import zu konfigurieren, benötigen Sie eine Beispieldatei. Anhand dieser Datei werden die Felder und Werte zugeordnet und überprüft, ob die Textbegrenzer und Feldtrenner korrekt sind. Danach wird die Datei verworfen (es werden keine Kontakte aus der Beispieldatei importiert).
Eine Beispieldatei muss nicht mehr als einen oder zwei Kontakte enthalten, diese müssen jedoch:
- Alle Felder beinhalten, die in den tatsächlichen Importdateien enthalten sind, und zwar in dergleichen Reihenfolge wie die Importdateien.
- Alle möglichen Werte für alle Felder der Einfach- und Mehrfachauswahl in den Importdateien beinhalten.
Vorverarbeitung
Automatisierte Importe unterstützen auch eine sogenannte Vorverarbeitung (pre-processing); dabei werden verschlüsselte Dateien automatisch dekomprimiert und importiert. Die Vorverarbeitung kann beim Einrichten der Auto-Importe konfiguriert werden; sie verlässt sich darauf, dass das Passwort für alle Dateien gleich bleibt. Sowohl PGP (Pretty Good Privacy) als auch GPG (GNU Privacy Guard) werden unterstützt.
Emarsys unterstützt die folgenden Standardkomprimierungsformate: .zip, .rar, .arj, .tar, .tgz, .7z.
Für weitere Informationen kontaktieren Sie bitte den Emarsys-Support.
Opt-in-Management
Das Feld E-Mail Opt-in wird von Importen wie folgt gemanagt:
Für neue Kontakte
Sie werden aufgefordert, den Opt-in-Status in den Importeinstellungen zu definieren.
Bei bestehenden Kunden
Das Duplikationshandling managt das Opt-in-Feld wie folgt:
- Wenn das Opt-in-Feld in der Importdatei und das Opt-in-Feld in Ihrem Account denselben Wert haben, behält der zusammengeführte Kontakt diesen Wert bei und der Feldverlauf wird mit dem jüngeren der beiden Zeitstempel aktualisiert.
- Wenn die Importdatei den Wert
FALSE
aufweist und Ihr Account den WertTRUE
hat, erhält der zusammengeführte Kontakt den WertFALSE
. - Wenn die Importdatei den Wert
NULL
aufweist und Ihr Account den WertFALSE
hat, erhält der zusammengeführte Kontakt den WertFALSE
. - Wenn die Importdatei den Wert
NULL
aufweist und Ihr Account den WertTRUE
hat, erhält der zusammengeführte Kontakt den WertFALS
E. - Wenn die Importdatei den Wert
TRUE
aufweist und Ihr Account den Wert FALSE
hat, erhält der zusammengeführte Kontakt den WertFALSE
. - Wenn die Importdatei den Wert
TRUE
aufweist und Ihr Account den WertNULL
hat, erhält der zusammengeführte Kontakt den WertTRUE
.
Der Wert eines Opt-in-Feldes sollte niemals eine leere Zeichenfolge sein, da dies als ungültiger Wert aufgefasst wird. Verwenden Sie stattdessen NULL
.
Warum soll ich den Datenimport verwenden?
Der wichtigste Anwendungsfall für den Datenimport ist gegeben, wenn Sie Emarsys als Ihre Haupt-Kontaktdatenbank nutzen und es Szenarien gibt, in denen die Verwendung des Emarsys API nicht angemessen ist, zum Beispiel beim Hochladen offline gesammelter Kontaktlisten.
Der Datenimport ist auch eine Fallback-Option, wenn Sie nicht über die technischen Ressourcen verfügen, um den Kontaktdatentransfer über das API durchzuführen.
Zudem können Sie Auto-Importe für das Triggern von automatisierten Programmen verwenden.
Unterstützte Funktionen
Auf der Seite für den Datenimport können Sie Folgendes tun:
- Ihre aktuellen Importe überprüfen
- Den Importverlauf überprüfen
- Einen manuellen Import initiieren
- Auto-Import einrichten
- Einen Import bearbeiten
- Import abbrechen
- Die Felder und Werte des Uploads zuordnen
- Die Feldzuordnung eines bestehenden Auto-Imports ändern
Erste Schritte mit dem Datenimport
Bevor Sie mit dem Datenimport beginnen
Bei manuellen Importen sind folgende Punkte zu beachten:
- Es können ausschließlich CSV-Dateien hochgeladen werden.
- Wenn Sie einen manuellen Import einleiten, beachten Sie bitte, dass die Dateien nicht größer als 64 MB sein sollten.
Wenn Ihre Anforderungen von den oben genannten abweichen, sollten Sie überlegen, einen Auto-Import einzurichten.
Bei Auto-Importen sind folgende Punkte zu beachten:
- Sie benötigen einen Pfad, unter dem die Upload-Datei gespeichert werden kann. Dafür sind folgende Optionen verfügbar:
- Wenn Sie einen Auto-Import einrichten, bedenken Sie bitte Folgendes: Es ist zwar möglich, mit WebDAV oder SFTP einzelne Dateien mit einer Größe von über 1 GB hochzuladen; wir empfehlen jedoch, die Größe der hochgeladenen Dateien unter 1 GB zu halten. Wiederholte Uploads, die größer als 1 GB sind, können den temporären Speicherplatz für die Verarbeitung schnell aufbrauchen, was zu fehlgeschlagenen Uploads führen kann.
Emarsys checkt den WebDAV-Ordner minütlich auf neue Dateien; bei SFTP oder FTPS erfolgt der Check stündlich.
Kontaktlisten, die durch den Import von Kontaktdaten erstellt wurden, werden nach einer festgelegten Zeitspanne archiviert, wenn sie nicht in einem Segment, einem Automation Center Programm oder einer Kampagne verwendet werden. Das Archivierungsdatum hängt von den Kunden- und Account-spezifischen Einstellungen ab. Um sich über die entsprechende Zeitspanne zu informieren, kontaktieren Sie bitte den Emarsys Support.
Konventionen für die Benennung von Dateien
Dateinamen sollten keine Zeichen des Typs space
enthalten. Verwenden Sie stattdessen zum Beispiel Unterstriche. Die Verwendung von space
-Zeichen generiert keine Fehlermeldung, kann jedoch zu Fehlfunktionen führen.
Der Kontaktimport wird fehlschlagen, wenn der Teil des Dateinamens, für den die Wildcard steht, mit einem space
-Zeichen beginnt. Die Datei wird nicht gefunden oder erkannt.
Beispiel
Dateiname: EDW_Contact_Feed 2021-06-30_115346.csv
Dateiname mit Wildcard: EDW_Contact_Feed*.csv
Im oben angeführten Szenario wird die Datei nicht erkannt, obwohl sie nach der Wildcard-Logik erkannt werden sollte. Der Grund dafür: Das erste Zeichen ist ein space
. Ein Workaround könnte darin bestehen, die Wildcard wie folgt zu verwenden:
Dateiname: EDW_Contact_Fee*.csv
Datenimport FAQ
Nein, Sie können nur neue Listen erstellen. Es gibt allerdings zwei Workarounds:
- Schließen Sie in der Importdatei ein eindeutiges Feld ein (das z.B. den Namen des Auto-Imports hat) und erstellen Sie ein Segment, das nach Kontakten mit dem entsprechenden Wert für dieses Feld filtert.
- Verwenden Sie im Automation Center den Einstiegsknoten Bei Auto-Import, gefolgt vom Knoten Kontaktliste speichern; die Einstellung Neue Kontakte zu bestehender Liste hinzufügen muss aktiviert sein.
Über den Import Wizard können Sie immer nur eine Datei manuell importieren - für den gleichzeitigen Import mehrerer Dateien müssen Sie einen Auto-Import einrichten. Auto-Importe sammeln all jene Dateien ein, die korrekt in den Speicherordner hochgeladen wurden.
SFTP oder FTPS Server sind die sichersten verfügbaren Transferprotokolle; ihre Verwendung wird von uns empfohlen, wenn die technischen Ressourcen es erlauben. Emarsys überprüft diese externen Quellen einmal pro Stunde; erfolgreich importierte Dateien werden aus der Quelle gelöscht.
Ein WebDAV ist eine SSL-gesicherte Quelle, die von Emarsys gehostet und gewartet wird. Für viele Kunden ist das eine bequeme Lösung; das WebDAV wird kostenlos vom Emarsys Support für Sie eingerichtet und Sie benötigen nur eine passende Client-Anwendung wie etwa Bitkinex oder Cyberduck , um auf den Ordner zuzugreifen; Sie können auch automatische Updates aus Ihrem CRM programmieren.
Emarsys überprüft das WebDAV jedes Accounts minütlich und verarbeitet alle neuen Dateien, die es in dem Ordner vorfindet. Verarbeitete Dateien werden wiederum im WebDAV gespeichert, und zwar mit folgender Namenskonvention:
- filename.csv.done für erfolgreiche Importe.
- dateiname.csv.error für fehlgeschlagene Importe. Eine Nachricht mit Details zum Fehler wird an das Benachrichtigungs-Center gesendet.
- dateiname.csv.ignore für Dateien, deren Namen nicht mit jener Namenskonvention übereinstimmen, die für die aktivierten Auto-Importe definiert wurde.
Hinweis: Wenn Sie eine komprimierte Datei verwenden, wird die Importdatei in das WebDAV extrahiert und wie oben beschrieben umbenannt; die komprimierte Datei wird gelöscht.
Wir empfehlen, in den Dateinamen sowohl statische als auch dynamische Elemente einzuschließen. Der statische Teil sollte klar und leicht verständlich sein; idealerweise bezieht er sich auf einen Aspekt Ihrer Customer-Lifecycle-Strategie. Der dynamische Teil (z.B. ein Zeitstempel) macht es möglich, die einzelnen Dateien zu unterscheiden. Im Feld der Namenskonvention wird der dynamische Teil durch den Platzhalter * dargestellt.
Beispiele
- Wenn Sie nur eine einzige Auto-Import-Konfiguration benötigen, können Sie eine simple Namenskovention wie .csv verwenden. Das bedeutet, dass jede .csv-Datei, die im Quellordner gespeichert ist, verarbeitet wird.
- Wenn Sie mehr als einen Auto-Import verwenden, empfehlen wir, den statischen Teil an den Auto-Import-Namen anzupassen und den dynamischen Teil für einen Zeitstempel zu nutzen. Auf diese Weise könnten Sie die Namenskonvention für den Auto-Import konvertierte Leads wie folgt definieren: konvertierte-leads-*.csv; die einzelnen Dateien würden in dem Fall wie folgt heißen: konvertierte-leads-2015-02-12.csv
Dateinamen beachten die Groß-/Kleinschreibung.
Eine Beispieldatei ist erforderlich, damit Emarsys weiß, welche Felder in den Importdateien enthalten sind und wie sie und ihre Werte den bestehenden Feldern in der Emarsys Datenbank zugeordnet werden sollen. Wenn Sie Änderungen in der Importdatei vornehmen, mögen diese auch noch so minimal sein, sollten Sie eine neue Beispieldatei hochladen, die auf der neuen (geänderten) Importdatei basiert.
Eine Beispieldatei muss sämtliche erwartbaren Felder enthalten, und zwar in der richtigen Reihenfolge und mit allen möglichen Werten für die Felder der Einfach- und Mehrfachauswahl.
Nein. Emarsys interessiert sich nur für die Datei-Einstellungen sowie die Felder und Werte.
Für die meisten Emarsys Accounts wird nur die UTF-8 Codierung unterstützt. Einzige Ausnahme sind Accounts in der Umgebung www.emarsys.net, die nur Latin1 unterstützen.
Um Probleme zu vermeiden, achten Sie darauf, dass Ihre Upload-Dateien nur Latin-1-Zeichen enthalten, jedoch mit UTF-8-Kodierung hochgeladen werden.
Bitte beachten Sie, dass Emarsys die verwendete Codierung nicht überprüft; wenn Sie eine andere Codierung verwenden, werden die importierten Kontaktdaten möglicherweise beschädigt und können nicht verwendet werden.
Die Importdatei selbst muss eine CSV-Datei sein. Sie können diese Datei jedoch komprimieren. Folgende Komprimierungsformate werden unterstützt: .zip, .rar, .arj, .tar, .tgz, .7z.
Wenn Sie ein komprimiertes Dateiformat verwenden wollen, vergewissern Sie sich, dass Sie die Namenskonvention für die komprimierte Datei sowie etwaige erforderliche Passwörter mit einschließen.
Es befüllt das Feld Registration language (Registrierungssprache). Das ist nur relevant, wenn Sie Ihre Kontakte auf Basis der Sprache segmentieren wollen, zum Beispiel, um Newsletter in mehreren Sprachen zu senden.
Wird die Spracheinstellung der Importdatei verändert, kann das Einfluss auf folgende zwei Aspekte haben:
- Die Namen der Felder und ihre Werte
Wenn eine Dateisprache definiert ist, verwendet Emarsys diese Sprache, um die Felder und ihre Werte in der Importdatei zuzuordnen. Bitte beachten Sie, dass Sie in diesem Fall für alle inkludierten benutzerdefinierten Felder die entsprechenden Übersetzungen in den entsprechenden Sprachen zur Verfügung stellen müssen. - Das Dateiformat
Einige Dateiformate sind bestimmten Sprachen zugeordnet. Emarsys überprüft die Beispieldatei bezüglich des Dateiformats und wenn es nicht mit der Sprache übereinstimmt, wird im Auto-Import Wizard ein Fehler angezeigt. Die unterstützten Dateiformate sind:- JJ-MM-TT
- TT.MM.JJ
- MM/TT/JJ
- TT/MM/JJ
- Das ist eine Vorsichtsmaßnahme, die sicherstellt, dass dieselbe Datei nicht zweimal importiert wird.
Auto-Import-Konfigurationen, die vor dem Release von Emarsys Version 8.2 (Februar 2015) eingerichtet wurden, beinhalten möglicherweise Einstellungen, die entweder von der neuen Importfunktion noch nicht unterstützt werden oder in der Zwischenzeit durch verbesserte Funktionalitäten ersetzt wurden. Beispiele solcher Funktionen sind Newsletter Opt-in, Bei-Import-Kampagnen oder Kein Duplikationshandling. Um diese Auto-Importe zu bearbeiten, wenden Sie sich bitte an den Emarsys-Support.