Newsletter-Systeme anbinden: MAILEON, CleverReach und weitere

Treffen Sie die Einstellungen, die Ihr Newsletter-Anbieter zusätzlich braucht, und erfahren Sie, welches Dateiformat KuferSQL dafür erzeugt.

ℹ️ Voraussetzung: Das Newsletter-System ist bereits unter Einstellungen → Zentrale Einstellungen → Extras → Newsletter-Anbindung ausgewählt — siehe Newsletter-Modul freischalten und zentrale Einstellungen vornehmen. Die hier beschriebenen Zusatzangaben hängen vom gewählten System ab.

Was regelt die Systemanbindung?

Die Auswahl des Newsletter-Systems bestimmt drei Dinge: das Exportformat der Adressdatei, die Zusatzparameter, die KuferSQL für die Ansteuerung braucht, und das Importformat der Rückläufer. Eine Sonderstellung haben zwei Systeme: MAILEON (XQueue) wird über eine REST-Schnittstelle angesteuert — KuferSQL erzeugt die Exportdatei und lädt sie anschließend direkt hoch. Für Mail2Many läuft die Übertragung mittlerweile ebenfalls über eine REST-Schnittstelle. Nur bei diesen beiden Systemen ist die Schaltfläche Einstellungen neben dem Auswahlfeld aktiv, über die Sie die Verbindungsparameter erfassen. Bei allen übrigen Systemen erfolgt der Austausch über eine Export- beziehungsweise Importdatei. Dieser Artikel ist Teil 5 der sechsteiligen Reihe zum Newsletter-Baustein (siehe Teil 1).

MAILEON (XQueue) anbinden

Die Grundeinstellungen treffen Sie unter Einstellungen → Zentrale Einstellungen → Extras → Newsletter-Anbindung. Dort geben Sie an, ob MAILEON (XQueue) im Einsatz ist, und erfassen alle weiteren Parameter für die Ansteuerung.

Einstellungen für Maileon – API-Key und Proxy-Angaben oben, darunter die drei Schalter für den automatischen Transfer

Die drei Schalter für den automatischen Transfer bewirken:

Alle E-Mail-Adressen mit Status J und/oder K werden nach MAILEON (XQueue) übertragen.
Newsletter-Abmeldungen aus MAILEON (XQueue) werden in KuferSQL auf N gesetzt.
Interessensgebiete aus KuferSQL werden in MAILEON (XQueue) als Kontaktfelder angelegt, und die Zuordnungen werden übertragen. Übergeben werden dabei Schlüssel und Klartext jedes Interessensgebiets; die neu erstellten Kontaktfelder erhalten den Datenfeldtyp BOOLEAN mit dem Wert true.

Die Übergabemodalitäten sind an die REST-Schnittstelle von MAILEON (XQueue) angepasst. Über Extras → Newsletter / eMail-Marketing → Export von Stammdaten für einen Newsletter erzeugt KuferSQL eine XML-Datei und lädt sie anschließend direkt zu MAILEON (XQueue) hoch.

Export von Stammdaten für einen Newsletter – rot umrandet das Feld Kontaktfeld, das nur für die Übertragung nach MAILEON (XQueue) relevant ist

Im Übertragungsfenster vergeben Sie im Feld Kontaktfeld eine Bezeichnung. Sie entspricht einem bestimmten Bereich, für den der Empfänger Informationen erhalten soll. Ist das Feld gefüllt, legt KuferSQL in MAILEON (XQueue) ein Kontaktfeld an, überträgt die Adressen und befüllt das Kontaktfeld mit BOOLEAN true.

Die Rückrichtung ist ebenfalls angepasst: Über Import der nicht zustellbaren Rückläufer beziehungsweise Import der Abmelde-Rückläufer lesen Sie Hard- und Softbounces sowie die Abmelder direkt von MAILEON (XQueue) ein.

💡 E-Mail-Templates: In MAILEON (XQueue) stehen Templates für die KuferWEB-Layouts ALSTER und ELBE, ein allgemeines VHS-Template sowie eine große Template-Bibliothek bereit. Alle Templates sind responsive und auch im Dark Mode verfügbar.

Kursdaten per RSS-Feed an MAILEON übergeben

KuferWEB stellt einen RSS-Feed bereit, über den die zu bewerbenden Kurse abgegriffen werden. Geliefert wird je Kurs eine begrenzte Feldauswahl: Kursnummer, Titel, Beginn-Datum, Ende-Datum, Beginn-Uhrzeit und Ende-Uhrzeit.

Der Feed liefert nur Kurse, die in KuferSQL für den Newsletter-Versand freigegeben sind. Die Freigabe erfolgt pro Kurs im Kursstamm über die Schaltfläche Freigaben / Weitergabe Newsletter oder gesammelt für einen Kursbereich über Extras → Freigabe- und Export-Center für Kurse.

Damit die Links zu weiteren Infos erzeugt werden können, tragen Sie unter Einstellungen → System → Daten der Einrichtung bei Link zu den Kursdetails den Pfad zu den Kursdetails ein. Als Platzhalter für die Kursnummer dient die Variable {%k_id%}.

Aufgerufen wird der Feed über rss.php mit dem GET-Parameter feed=maileon. Zusätzlich steuern Sie ihn über diese Parameter:

KursBeginntAb — frühestes Kursbeginndatum als Ganzzahl relativ zum heutigen Datum; ausgewertet, wenn ungleich 0. Negative Werte erfassen laufende Kurse.
KursBeginntBis — spätestes Kursbeginndatum, gleiche Logik.
minPlaetzeFrei — Anzahl minimal freier Plätze, Standardwert 1.
maxPlaetzeFrei — Anzahl maximal freier Plätze; ausgewertet, wenn größer 0 (Restplatzbörse).
sortierung — bei auf aufsteigend nach Datum und Uhrzeit, sonst absteigend.

Ein vollständiges Beispiel: webbasys/rss.php?feed=maileon&KursBeginntAb=-7&maxPlaetzeFrei=20

CleverReach anbinden

Den Export zu CleverReach legen Sie unter Einstellungen → Zentrale Einstellungen → Extras → Newsletter-Anbindung → Einstellungen fest. KuferSQL erzeugt dann eine CSV-Datei mit vier Spalten: EMAIL (E-Mail-Adresse des Empfängers), VORNAME, NACHNAME und LISTE (die eingetragenen Kennzeichen des Empfängers, mit Komma getrennt).

Beispiel einer CleverReach-Exportdatei – in der Spalte liste stehen die Kennzeichen des Empfängers

ℹ️ Kennzeichen nur mit gesetztem Schalter: Die Kennzeichen werden nur exportiert, wenn unter Einstellungen → Zentrale Einstellungen → Extras → Newsletter-Anbindung → Einstellungen der Schalter Ausgabe der Kennzeichen gesetzt ist.

Der Import der Abmeldungen und der Bounces funktioniert ebenfalls über eine CSV-Datei, die Sie aus CleverReach exportieren.

Sendinblue, Campaign Monitor und Rapid-Mail anbinden

Newsletter2go bzw. Sendinblue: Durch Firmenübernahme und Umbenennung wird inzwischen eher der Name Sendinblue kommuniziert. Exportiert wird eine CSV-Datei mit den Spalten email, vorname, nachname, geschlecht (m/f) und geburtstag. Der Import von Bounces und Abmelde-Rückläufern ist so angepasst, dass die aus Newsletter2go exportierten Dateien problemfrei eingelesen werden.
Campaign Monitor: Ist dieses System ausgewählt, stehen unter Extras → Newsletter / eMail-Marketing → Export von Stammdaten für einen Newsletter nur zwei Spalten zur Verfügung: E-Mail und die Spalte Name + Vorname.
Rapid-Mail: Der Export erzeugt eine CSV-Datei mit Kontaktdaten, die in Rapid-Mail eingelesen werden kann.

Beispiel einer Exportdatei für Newsletter2go bzw. Sendinblue – mit den Zusatzspalten geschlecht und geburtstag

Unterstützte Dateiformate

Kommunikation zwischen KuferSQL und dem Newsletter-Provider – Export der Adressen hin, Import der Rückläufer zurück

Für den Export werden folgende Formate unterstützt:

Newsletter-System	Exportformat
Supermailer	Textdatei (txt)
Mail2Many	XML-Datei (xml), Übertragung über die REST-Schnittstelle
MAILEON (XQueue)	XML-Datei (xml), automatisch über die REST-Schnittstelle
Newsletter2go / Sendinblue	Textdatei (csv)
CleverReach	Textdatei (csv)
Rapid-Mail	Textdatei (csv)
Campaign Monitor	Textdatei (csv)
Super-Web-Mailer	Textdatei (txt)
Riedel&Eichler (Winterberg)	DBF-Datei (dbf)

Für den Import der Rückläufer werden aktuell unterstützt: Supermailer (txt), MAILEON (XQueue) (xml), CleverReach (csv), Newsletter2go (csv) und Xqueue (csv).

Nach der Auswahl des Anbieters tragen Sie unter Einstellungen für Newsletter das benötigte Exportformat, den gewünschten Dateinamen und den Pfad ein. Die Provider Supermailer und Super-Web-Mailer übergeben an KuferSQL bei Anmeldungen, Abmeldungen und Rückläufern nur die E-Mail-Adressen.

Die Export- und Importdateien haben folgende Spaltenfolgen: für den Supermailer-Export E-MAIL, NR, ANSPRACHE, NAME, GESCHLECHT, GEBURTSTAG; für den XQueue-Export E-MAIL, ANREDE, ANSPRACHE, TITEL, VORNAME, NACHNAME, GEBURTSTAG; für MAILEON-Bounces KNR, KID, Kampagne, Themen, Adresse, Code; und für MAILEON-Abmeldungen Kunden-ID, E-Mail-Adresse, Kampagnen-ID, Kampagnenname gefolgt von sieben Abmeldegründen sowie Technische Probleme und Sonstiges.

Ergebnis

Das gewählte Newsletter-System ist vollständig konfiguriert, das Export- und Importformat ist bekannt, und bei MAILEON (XQueue) laufen Übertragung und Rückläufer-Import direkt über die Schnittstelle.

✅ Geschafft: Wenn Sie mit Supermailer arbeiten und zusätzlich Kurse im Newsletter bewerben wollen, geht es weiter mit Newsletter mit Supermailer und Kursdaten aus KuferSQL versenden.