GUI:CSV Import
Aus Melin DokuWiki
Der Menüpunkt CSV Import dient zum Import von Abonnenten die in einer CSV-Datei vorliegen. Das Menü zum CSV-Import von Abonnentendaten befindet sich unter Abonnenten / CSV-Import.
Bevor Abonnenten importiert werden können, muß eine Empfängerliste definiert sein in die man die Abonnenten hineinimportieren möchte. Der CSV-Import steht nur für die Melin-Interne Datenbank MMDB zur Verfügung und kann für folegnde beiden Anmeldevarianten verwendet werden:
- Einfaches Hinzufügen von E-Mail-Adressen zu einer Verteilerliste
- Hinzufügen der Abonnenten zu einer Verteilerliste mit Begrüßungsmail
- Hinzufügen von Abonnenten mit DoubleOpt-In
Anschließend werden die Daten vom SystemCSVMailImport-Workflow verarbeitet.
Inhaltsverzeichnis |
[bearbeiten] Vorbereitung
Bevor Emailadressen importiert werden können wir eine CSV-Datei benötigt mit den Adressen darin. Jede Adresse benötigt eine Zeile.
zu Beginn der Datei muss gelistet sein welche Felder pro Zeile enthalten sind, sowie die NEWSLETTER_ID. Dabei gibt es verschiedene Schlüsselworte, die gängigsten sind:
|
Die beiden einzigen Pflichtfelder sind dabei EMAIL und NEWSLETTER_ID.
Eine CSV-Datei kann daher beispielsweise so aussehen:
NEWSLETTER_ID;EMAIL;LAST_NAME;FIRST_NAME;ANREDE 17;seb@melin.de;Böttger;Sebastian;Herr 17;sb@melin.de;Brune;Stefanie;Frau
[bearbeiten] Das Menü
[bearbeiten] Menüpunkte
[bearbeiten] CSV-Daten
in dieses Feld werden die CSV-Daten kopiert (Copy/Paste). Die erste Zeile enthält dabei Pro Folgezeile wird ein Abonnent angegeben. Jede Zeile muß mindestens eine Verteilerliste (NEWSLETTER_ID) und eine E-Mail-Adresse definieren (EMAIL). Weitere Felder können ergänzt werden, wobei hierbei bestimmte Regeln einzuhalten sind (siehe unten).
Beispiel:
NEWSLETTER_ID;EMAIL;LAST_NAME;FIRST_NAME;ANREDE 1;seb@melin.de;Böttger;Sebastian;Herr 1;sb@melin.de;Brune;Stefanie;Frau
Hat ein Abonnent mehrere Newsletter abonniert, so muß dieser mehrfach aufgeführt werden
NEWSLETTER_ID;EMAIL;LAST_NAME;FIRST_NAME;ANREDE 1;seb@melin.de;Böttger;Sebastian;Herr 2;seb@melin.de;Böttger;Sebastian;Herr 3;seb@melin.de;Böttger;Sebastian;Herr
Es können zusätzlich beliebige weitere Felder übergeben werden, diesen muss das Schlüsselwort "UD_" (User Defined) vorangestellt werden, siehe unten.
[bearbeiten] CSV-Datei
Alternativ zum Import über Copy/Paste kann auch eine Datei hochgeladen werden. Die Syntax ist identisch mit dem Import über Copy/Paste.
[bearbeiten] Stamm
Diese Einstelllung sollte auf MMDB belassen werden wenn nicht anders erforderlich. Durch die Auswahl eines Verteilers wird eine NEWSLETTER_ID vorgegeben, die jedoch durch eine Angabe in der CSV-Datei überschrieben werden kann.
Einzig wenn die Option "Stamm vorher löschen" gewählt wird, dann muß ein Verteiler angegeben werden.
[bearbeiten] Datenbank: Existierende Abonnenten löschen
Hier ist die Ausnahme zur Stamm-Auswahl. Wenn ein Stamm vor dem Import geleert werden soll (normalerweise werden Abonnenten einfach hinzugefügt) dann wählt man oben einen Stamm aus und klickt diese Option an. Das funktioniert im übrigen auch wenn man keine Datei angibt, somit hat man hier eine effiziente Hintertür um einen Verteiler einfach über die Oberfläche zu leeren.
[bearbeiten] E-Mail: Willkommen-Mail zusenden
Alle Abonnenten erhalten eine Willkommen-Mail. Inhalt und Absender werden weiter unten im Menü festgelegt.
[bearbeiten] Opt-In: Double Opt-In verwenden
Statt einer einfachen Begrüßungsmail kann auch eine DoubleOpt-In Mail gesendet werden: der Abonnent wird erst aufgenommen wenn er auf einen Bestätigungslink klickt.
[bearbeiten] Opt-In Mail
In dieses Feld wird der Text für die DoubleOpt-In Mail kopiert. Hierbei kann auf Felder des CSV-Imports zugegriffen werden (z.B. mit %LAST_NAME% auf den Nachnamen). Die größte Herausforderung ist der DoubleOptIn-Link. Hier muß auf ein Script verwiesen werden das eine XML-Datei erzeugt, die wiederum ein DoubleOpt-In PlugIn erreicht.
Vorbereitet ist hierzu das Script melin_usv.php, das üblicherweise bei der Anmeldung verwendet wird. Das hat den Vorteil daß man aus der DoubleOpt-In Mail
Hier ein Beispiel aus der Praxis, der Link befindet sich in der Mitte:
Guten Tag %ANREDE% %LAST_NAME%, die Westerwald Bank möchte Sie gerne mit dem monatlichen Newsletter „VR-Infobrief“ über interessante Themen „rund ums Geld“ informieren. Haben Sie Interesse? Dann klicken Sie zur Bestätigung Ihrer E-Mail-Adresse bitte hier: http://www.vr-mailservice.de/popup/infobrief/anmeldung/melin_usv.php?DOI=%M_SERIALIZE_ID%&id=114 . Um sich ein Bild von den zur Verfügung gestellten Informationen zu machen, können Sie sich hier die letzten beiden Newsletter ansehen: Newsletter vom 16.09.2005 http://www.vr-mailservice.de/15_1127093525.pdf Newsletter vom 21.10.2005 http://www.vr-mailservice.de//50_1129798422.pdf Falls Sie Ihre Themenauswahl oder Ihre Daten ändern möchten, können Sie dies unter folgender Adresse tun: www.westerwaldbank.de Beachten Sie bitte, dass wir Sie niemals per E-Mail und somit außerhalb des InternetBankings nach persönlichen Daten (wie z.B. PIN, TAN, Kreditkarten-Nr., usw.) fragen. Wir wünschen Ihnen viel Spaß mit unserem E-Mail-Newsletter. Sollten Sie keine weiteren Newsletter wünschen, können Sie nach dem ersten Erhalt das Abonnement jederzeit löschen. Ihre Daten werden bei uns selbstverständlich vertraulich behandelt und nur für den angegebenen Zweck verwendet. Übrigens: Sie finden uns im Internet unter www.westerwaldbank.de. Ihre Westerwald Bank eG Volks- und Raiffeisenbank
Die Variable % M_SERIALIZE_ID% wird beim Versand der Mail generiert. Bei der Verwendung des DoubleOpt-In Prozesses wird pro Import-Datensatz eine eindeutige Kennung generiert und hier abgelegt.
Vereinfacht kann kann man sich vorstellen, daß das DoubleOptIn-Plugin die Anmeldung zurückhält, bis die Freigabe geliefert wird.
[bearbeiten] Mögliche Feldwerte beim Import in die MMDB
Für jeden Abonntent können die folgenden Felder übergeben werden die auch über die Oberfläche pflegbar sind:
Feldschlüssel Typ Beispiel SYSTEM_CUSTOMER_ID Int (14) 7 EMAIL Varchar(255) seb@melin.de GENDER Varchar(1) M oder F ANREDE (*) Varchar(255) z.B. Herr oder Frau SC_TITLE Varchar(255) Dipl.Ing. FIRST_NAME Varchar(255) Sebastian LAST_NAME Varchar(255) Böttger STREET Varchar(255) Leyboldstr. 10 ZIP_CODE Varchar(6) 50354 CITY Varchar(100) Hürth COUNTRY Varchar(2) D TEL Varchar(255) +49 2233 8070 FAX Varchar(255) +49 2233 807 100 PASSWORD Varchar(50) Jhsdf7sd KUNDE_NR Int(8) 52353345 COMPANY Varchar(50) Melin GmbH FORMAT Varchar(10) TEXT oder HTML (Formatpräferenz) AD_PERMISSION Varchar(I) 1 oder 0
[bearbeiten] Weitere Felder
Zu jedem Benutzer können darüber hinaus weitere Daten abgelegt werden, einzige Einschränkung ist daß die Feldschlüssel mit UD_ beginnen ("User Defined"), zum Beispiel UD_QUELLE, UD_GEBURTSDATUM. Jeder Feldwert kann bis zu 255 Zeichen haben und steht in Mailings zur weiteren Personalisierung zur Verfügung. Feldschlüssel müssen in Großbuchstaben geschrieben werden und dürfen keine Umlaute beinhalten. Feldschlüssel und -werte werden beim Benutzer angezeigt, sind aber nicht editierbar.
[bearbeiten] Themenkanäle
Themenkanäle können ebenfalls beim Import zugewiesen werden. Diesen muß das Schlüsselwort CHANNEL_ vorangestellt werden. Haben Sie beispielsweise bei einem Newsletter die Themenkanäle RECHT und UNTERNEHMEN, und ein Abonnent hat davon nur den RECHT abonniert, so kann die Importdatei wie folgt aussehen:
NEWSLETTER_ID;EMAIL;LAST_NAME;FIRST_NAME;GENDER;CHANNEL_RECHT;CHANNEL_UNTERNEHMEN 1;seb@melin.de;Böttger;Sebastian;m;1;0 1;ld@melin.de;Dienas;Liels;m;0;0
Der zweite Abonnent hat in diesem Fall nur den Newsletter abonniert, aber keinen Themenkanal.
[bearbeiten] Weitere Informationen
- GUI:Abonnentenverwaltung - Verwaltung von Abonnenten
- PlugIn CSV Check - Analysiert und Überprüft eine CSV-Datei
- PlugIn CSV Import - Importiert eine CSV-Datei
- SystemCSVMailImport-Workflow - zum Import von Abonnenten
[bearbeiten] Nützliche Tipps
Viele Nutzer suchen nach einer Möglichkeit, eine Verteilerliste zu leeren. Hier gibt es den "Trick" die Option " Existierende Abonnenten vorher löschen" auszuwählen und als Stamm die Empfängerliste auszuwählen die man löschen möchte. Achtung: die Variante ist irreversibel.