Universal Messenger 7.21.5

Neue Features und Funktionen

Überarbeitung des Newsletter-Trackings und der Einwilligungen

Bis zur Version 7.20 waren im Universal Messenger vier Tracking-Modi möglich:

• personal: Personen-bezogenes Tracking für alle Empfänger (Standard)

• anonymous: Anonymisiertes Tracking

• mixed: Personen-bezogenes Tracking nur für Empfänger mit expliziter Zustimmung, anonymisiertes Tracking für alle übrigen Empfänger

• off: Kein Tracking

Als Standard war das personenbezogene Tracking aller Empfänger unabhängig von einer Zustimmung oder einem Opt-Out definiert, was aktuell nicht mehr den Datenschutzbestimmungen entsprechen würde. Ab dem Universal Messenger 7.21 sind deswegen nur noch drei Tracking-Modi möglich, die auch jeweils eine individuelle Einwilligung oder den Widerruf des jeweiligen Empfängers berücksichtigen:

• personal: personen-bezogen

• anonymous: anonym

• off: ausgeschaltet

Aus der zentralen Einstellung in der Konfigurationsdatei, aus dem beim Versand eines Newsletters gewählten Tracking-Modus sowie aus den individuellen Einwilligungen des Empfängers wird für jeden einzelnen Empfänger das effektiv wirksame Tracking bestimmt, im Folgenden auch als effektives Tracking bezeichnet.

Der in der Konfigurationsoption cmsbs.tracker.mode zentral definierte Tracking-Modus setzt den maximal möglichen Tracking-Modus des Universal Messenger. Beim Versand eines Newsletters kann der Tracking-Modus nur gleich oder kleiner als diese zentrale Einstellung gewählt werden.

Der Universal Messenger entscheidet anhand des beim Versand gewählten Tracking-Modus zusammen mit den beim jeweiligen Empfänger gespeicherten Einwilligungen, ob ein Tracking für diesen Empfänger erfolgen darf. Die folgende Tabelle stellt das Ergebnis dieser internen Entscheidung dar:

Open

Bei jedem Empfänger werden die Einwilligungen in drei Standardattributen gespeichert. Der Name dieser Standardattribute kann in der Attributkonfiguration geändert werden und ist im Standard wie folgt definiert:

Open

Zu jedem dieser Einstellungen wird ein Consent-Attribute mit dem Suffix _date angelegt, in dem der Timestamp geschrieben wird, wenn die Einwilligung vom Empfänger erteilt wird. In dem Consent-Attribute mit dem Suffix _ip wird die IP-Adresse gespeichert, von der die Einwilligung gesetzt wurde.

Wenn keine Consent-Attribute vorhanden sind, gilt für alle Einträge immer maximal der Tracking-Mode in cmsbs.tracker.fallback_mode.

Formularfeld für Einwilligungen

Im Formularassistent der Newsletter-App steht ein neues Formularfeld zur Verfügung, das die Einholung abgestufter Einwilligungen ermöglicht.

REST-API für Status eines Newsletterversands

Die REST-API wurde um eine Funktion erweitert, mit der Status eines zuvor per REST-API gestarteten Newsletterversands abgefragt werden kann.

Berichtigungen

Datenmodell: Dateinamen von ATTACHMENTs

Das Format der Spalte zur Aufnahme der Dateinamen von Uploads wurde in UTF-8 geändert.

Export der Konfiguration

Der Export der Konfiguration wurde um das fehlende Element replyToName ergänzt.

Korrektur am userTool.sh

Das Anlegen neuer User ist nun auch wieder über die Kommandozeile möglich.

Aktualisierung eingebundener Bibliotheken

Es wurde ein Update auf JavaMail 1.6.2 vorgenommen.

Personenbezogenes Tracking für den Super-Admin

Die Konfigurationsoption cmsbs.gui.showtracking kann die Auswertungen aus dem personenbezogene Tracking nun auch für den Super-Admin abschalten.

Hinweise zum Update

Bei einem Update auf den UM 7.21 müssen die folgenden Schritte manuell ausgeführt werden. Damit wird das gewohnte Verhalten des Universal Messenger weitgehend auch in der neuen Release erhalten:

1. Bitte prüfen Sie zunächst, ob in der cmsbs-conf/additional.attributes der Pfad zur Einbindung der mitgelieferten Attributkonfiguration richtig gesetzt ist und der zweite Abschnitt der Attributkonfiguration gtc.attributes neu eingebunden wurde:

   # include: cmsbs-conf/newsletter-channel-activity.attributes # aendern auf neuen Pfad include: cmsbs-conf/cse/api/plugins/de.pinuts.cmsbs.newsletter/newsletter-channel-activity.attributes include: cmsbs-conf/gtc.attributes # muss zusaetzlich eingefuegt werden: include: cmsbs-conf/cse/api/plugins/de.pinuts.consent/gtc.attributes

2. Wenn die Konfigurationsoption cmsbs.tracker.mode auf dem nicht mehr unterstützten Wert 'mixed' steht, muss dieser Wert auf 'personal' gesetzt werden, wenn das gewohnte Verhalten des Universal Messenger beibehalten werden soll.

3. Die Konfigurationsoption cmsbs.tracker.behavior_date.attribute muss in cmsbs.tracker.tracking_personal.attribute umbenannt werden.

4. Die Konfigurationsoption cmsbs.tracker.fallback_mode muss gesetzt werden. Der Default für diese Variable ist "anonymous", so dass Einträge ohne explizite Zustimmung zum personenbezogenen Tracking maximal anonym getrackt werden. Soll im Projekt trotzdem personenbezogen getrackt werden (Bitte beachten Sie die Datenschutzbestimmungen!), muss diese Variable auf den Wert "personal" gesetzt werden.

5. Die neuen Attribute zur Einwilligung müssen in der Attributkonfiguration in cmsbs-conf/additional.attributes ergänzt werden:

   # Newsletter Tracking additional.attributes[] = consent_nl_tracking_personal additional.attributes[] = consent_nl_tracking_personal_ip additional.attributes[] = consent_nl_tracking_anonymous additional.attributes[] = consent_nl_tracking_anonymous_ip additional.attributes[] = consent_nl_tracking_optout additional.attributes[] = consent_nl_tracking_optout_ip grp.std_abo.members[] = consent_nl_tracking_personal grp.std_abo.members[] = consent_nl_tracking_personal_ip grp.std_abo.members[] = consent_nl_tracking_anonymous grp.std_abo.members[] = consent_nl_tracking_anonymous_ip grp.std_abo.members[] = consent_nl_tracking_optout grp.std_abo.members[] = consent_nl_tracking_optout_ip

   Falls die neuen Attribute zur Einwilligung nicht verwendet werden sollen, können Sie diese alternativ zum letzten Schritt in der cmsbs.properties deaktivieren:

   cmsbs.tracker.tracking_personal.attribute = "" cmsbs.tracker.tracking_anonymous.attribute = "" cmsbs.tracker.tracking_optout.attribute = ""

   Wenn bei einem Empfänger keines dieser Einwilligungsfelder gesetzt ist oder die Einwilligungsfelder nicht vorhanden sind, wird als Fallback der mit der Konfigurationsoption cmsbs.tracker.fallback_mode definierte Tracking-Modus verwendet.

6. Sollte es beim Anzeigen von Einträgen SQL-Fehler geben, weil eine der Spalten "P_GTC_DATE" bzw. "P_GTC_IP" fehlt, dann müssen die beiden Zeilen

   nach den Includes für gtc.attributes bzw. consent.attributes aktiviert werden.