Workflow:Standalone
Aus Melin WebHelp
Der Standalone-Workflow ergänzt das Standalone-Theme und ist eine Basis für eine Vielzahl von Mailing-Aktionen aus dem NanoCMS.
Duch seinene flexiblen Einsatz kann der Workflow für fast alle gängigen Versandaktionen genutzt werden und dient der Melin-Produktentwicklung als Referenzimplementierung zum Test. Alle Funktionen des Workflows werden durch eine Eingangs-XML-Datei (typischerweise aus dem NanoCMS) getriggert durch die entsprechende Funktionen im Workflow aktiviert werden.
Inhaltsverzeichnis |
[bearbeiten] Die Funktionsweise
Der Workflow überwacht zwei Verzeichnisse:
- SITE-DIR/cms/preview/preview (Vorschauen)
- SITE-DIR/cms/export/default (Live-Versand)
Beide Verzeichnisse werden vom NanoCMS über die vorkonfigurierten Exportregeln bedient.
[bearbeiten] Konfiguration vor der ersten Verwendung
Bei einer Neuinstallation müssen ggf. einige PlugIn-Parameter im Grid neu gesetzt werden.
[bearbeiten] SMTP-Server
Im Workflow sind insgesamt fünf MMDB Emailsender verbaut. Diese sind in der Standardinstalltion für einen Versand über den localhost ausgelegt. Wenn ein externer Mailserver verwendet wird (und für eine Produktivinstallation wird dies empfohlen) so sind hier die entsprechenden Mailserver einzutragen.
Die drei rechten MMDB Emailsender befinden sich hinter zwei Loadbalancer-Plugins und werden bei einem Mailing mit jeweils 1/3 der Last bedient (bei einem Mailing an 30.000 Empfänger erhält jedes PlugIn 10.000 Mails zur Auslieferung). Selbst wenn nur ein SMTP-Server vorhanden ist sollte die Drittelung beibehalten werden da sich dadurch eine erhöhte Versandleistung ergibt (bei fehlerhaften Mails versucht ein PlugIn die Mail bis zu fünf mal zuzustellen und blockt solange die folgenden, bei drei SMTPs verteilt es sich etwas).
Der ganz rechte MMDB Emailsender ist für Versandbestätigungen erforderlich. Nach Abschluß des Mailings wird über diesen eine Verdsandbestätigung (sofern eine Emailadresse dafür definiert ist) verschickt.
Der untere MMDB Emailsender verschickt die Vorschau-Mail für eine Genehmigung.
[bearbeiten] Envelope-From
Etwa in der Mitte des Workflows befindet sich ein SetHashField-PlugIn mit der Bezeichnung M_ENVELOPE_FROM. Dieses definiert die Rückläufer-Adresse für unzustellbare Mails. Hier sollte eine Emailadresse angegeben werden die von Melin abgerufen wird (siehe BounceMail-Management).
Die Adresse die hier angegeben wird muss etwas zerpflückt werden um ein optimales Ergebnis zu erreichen: Aus der Adresse "pop@melin.de" wird zum Beispiel: pop+N%NEWSLETTER_ID%-ID%MAILING_ID%-C0-S@CUSTOMER_ID@@melin.de
Nach dem eigentlichen Namen folgt "N%NEWSLETTER_ID%-ID%MAILING_ID%-C0-S@CUSTOMER_ID@", ein feststehender Ausdruck der genau so übernommen werden sollte. Diese Notation wird beim Versand pro Emfpfänger durch Livedaten ersetzt, aus obigem Ausdruck wird damit beispielsweise:
pop+N3-ID511-C0-S100002@melin.de
Diese Notation macht sich eine Feinheit der Emailkommunikation zunutze: alle Zeichen nach dem + werden bei der Emailzustellung ignoriert, so daß Mails an die obige Emailadresse normal an pop@melin.de ausgeliefert werden. Melin kann daraus jedoch nicht nur das Mailing und die Newsletter-ID extrahieren, sondern auch den Empfänger. Auf diese Weise kann ein Rückläufer immer eindeutig einem Empfänger zugeordnet werden, auch wenn dieser die Mail weiterleitet und so aus dem Absender gar nicht mehr erkenntlich ist an wen das Mailing ging.
[bearbeiten] Vom Workflow gesetzte Variablen
Im Laufe der Workflowbearbeitung werden eine Reihe von Variablen gesetzt die im Versand-Template oder an anderer Stelle im Workflow abgefragt werden können:
- IS_PREVIEW
Ist "1" wenn es sich um eine Vorschau handelt
- MAILING_ID
Die Mailing-ID wird automatisch erzeugt aus NL%M_BIRTHTIME%, wobei M_BIRTHTIME die Zeit in Sekunden seit 1970 ist an dem der Inhalt vom Nanocms im Workflow eingelesen wurde (Beispiel: NL123456789012)
- Für die Bestätigungsmail: M_TEMPLATE
SITE-DIR/templates/confirm.txt
[bearbeiten] Den Workflow steuernde Variablen
Eine Reihe von Funktionen im Workflow sind Standardmäßig deaktiviert, können jedoch zugeschaltet werden (in der Regel übernimmt diese Aufgabe das Eingabetemplate, indem diese Optionen als Checkboxen oder DropDowns angeboten werden).
[bearbeiten] Auswahl der Abonnentenquelle
Standard ist eine Auswahl über die NEWSLETTER_ID, beim Versand wird die entsprechende Empfängerliste aus der Datenbank gezogen
[bearbeiten] Mailing-Typ
Standard ist HTML, Text oder Multipart. In allen diesen Fällen wird die Empfängerliste bis zum Versand durchgereicht, und der MMDB-Emailsender setzt eine Mail auf Basis der Vorlage zusammen. Eine Ausnahme ist das Mailing nach Empfängerpräferenz (HTML oder Text, aber kein Multipart). Hier muss das Hash-Feld MAILING_TYPE auf den Wert HTMLTEXT gesetzt werden. Anschließend wird vom Workflow die Empfängerliste aufgeteilt in zwei Pakete, eines mit Empfängern vom Text und eines für Empfänger des HTML-Newsletter. In diesem Fall werden auch die Versand-Templates vorgegeben:
- SITE-DIR/templates/standalone_html.txt für HTML
- SITE-DIR/templates/standalone_plain.txt für Text
Die Templates wiederum erwarten den Text im Feld TEXT_REPRESENTATION und den HTML-Code in X_BODY (beides der Standard des NanoCMS und identisch wie die Inhaltserzeugung für Multipart-Mails).
Soll das Mailing als Multipart verschickt werden, so muß zusätzlich die Variable M_IS_MULTIPART auf 1 gesetzt werden
[bearbeiten] Öffnungsrate
Die Ermittlung der Öffnungsrate ist grundsätzlich gar keine Workflow-Eigenschaft, sondern ein Parameter des MMDB Emailsenders. Dazu wird einfach das Hash-Feld "M_OPEN_RATE" auf "1" gesetzt. Anschließend wird automatisch ein Zählpixel in die HTML-Version des Mailings eingebaut. Sollten Sie mit dem Pfad des Zählpixels nicht einverstanden sein, z.B. weil nicht über die Melin-Installation gezählt werden soll sondern über einen vorhandenen Webserver, so kann der Pfad durch den Eintrag
<TRACK-URL>Tracker-Ziel</TRACK-URL>
Ein Beispiel:
<TRACK-URL>http://redirect.melin.de/p.php?OC=1</TRACK-URL>
in der melinconfig.xml geändert werden. Weitere Informationen finden sich beim Tracker-Script p.php
[bearbeiten] Klicktracking auf Mailing-Ebene
Das Klicktracking auf Mailingebene erfasst Klicks im Mailing. Die Links werden über Zählscripte umgeleitet. Zur Aktivierung muss
M_CLICK_RATE
auf 1 gesetzt werden.
Zusätzlich muss das Hash-Feld
M_LINK_REDIRECT
Mit einem Pfad zum Tracker gefüllt werden, z.B. mit
redirect.melin.de/p.php?ID=
[bearbeiten] Klicktracking auf Benutzerebene
Das Klicktracking auf Benutzerebene erfasst Klicks im Mailing auf Nutzerebene, d.h man erhält eine Auswertung aller Klicks auf Mailing-Ebene, aber zusätzlich noch pro Link die Empfänger die darauf geklickt haben. Hierzu muss
M_USERCLICK_TRACK
auf 1 gesetzt werden.
Zusätzlich muss das Hash-Feld
M_LINK_COMPRESS
Mit einem Pfad zum Tracker gefüllt werden, z.B. mit
redirect.melin.de/p.php?ID=
[bearbeiten] Bestätigungsmail
Um am Ende eines Mailings eine Bestätigungsmail zu erhalten muß das Hash-Feld
M_CONFIRM
mit einer gültigen Emailadresse befüllt werden.
[bearbeiten] Empfängerliste/Verteiler
Bei einem Live-Mailing (einspielen über SITE-DIR/cms/export/default) wird standardmäßig die Empfängerliste gezogen die durch die NEWSLETTER_ID vorgegeben wird. Alternativ kann auch eine manuell erstellte Zielgruppen-Filterliste bemailt werden. Hierzu setzt man das Hash-Feld
VERTEILER
auf den Wert "by_targetlist". Zusätzlich muß
M_GETBYTARGETS
mit der ID eines Matchfilters belegt werden. Die ID kann im Konfigurationsmenü für Zielgruppenfilter eingesehen werden. weitere Informationen finden sich bei der mmdb_getbytargets Plugin-Dokumentation
[bearbeiten] Freigabe-Mail
im Normalfall wird das Mailing versendet wenn es auf dem Schreibtisch in Melin genehmigt wird oder die Versandzeit erreicht ist. Durch Angabe einer Freigabe-Email wird nach der Genehmigung das Mailing als Vorschau verschickt und enthält zusätzlich zum Inhalt einen Freigabe-Link. Zugleich wird das Mailing in einem separaten Bereich auf dem Schreibtisch angezeigt und kann auch dort freigegeben oder gelöscht werden (aber nicht mehr bearbeitet).
Zur Aktivierung der Funktion muss
M_APPROVAL
mit einer gültigen Emailadresse befüllt werden.
[bearbeiten] FAQ
[bearbeiten] Bei meinem selbsterstellten Template erscheint bei Multipart Text und HTML in einem Mailing
Die Zerlegung von HTML und Text erfolgt im HTMLTextconverter. Damit dieser die notwendigen Daten vom NanoCMS erhält muss im Template des NanoCMS die folgende Zeile eingefügt werden:
<INPUT NAME="MELIN:EXPORT_HTML2XML" VALUE="1" TYPE=HIDDEN>
Anschließend enthält die Exportdatei die beiden Hash-Felder X_BODY (für HTML) und TEXT_REPRESENTATION (für Text)