Ergebnis-Mail mit Double-Opt-in

Diese Funktion ermöglicht es, Quiz-Ergebnisse erst dann per E-Mail an die Teilnehmenden zu versenden, wenn diese ihre E-Mail-Adresse per Double-Opt-in bestätigt haben.

Anstatt das Quiz-Ergebnis direkt im Frontend anzuzeigen, blendet das Quiz ein Feedback-Formular ein. Nach dem Absenden des Formulars erhält die teilnehmende Person eine Bestätigungs-E-Mail. Die eigentliche Ergebnis-E-Mail wird erst versendet, nachdem der Bestätigungslink geöffnet wurde.

Zweck

Diese Funktion ist sinnvoll, wenn Quiz-Ergebnisse zur Lead-Generierung genutzt werden sollen oder wenn der Website-Betreiber vor dem Versand des Ergebnisses eine verifizierte E-Mail-Adresse erfassen möchte.

Typische Anwendungsfälle:

• Persönlichkeitstests
• Quizze zur Lead-Generierung
• Selbsteinschätzungen
• Marketing-Kampagnen
• Ergebnisauslieferung nach E-Mail-Bestätigung

Grundlegender Ablauf

1. Die teilnehmende Person schließt das Quiz ab.
2. Anhand der erreichten Punktzahl wird das passende Quiz-Ergebnis ermittelt.
3. Ist für dieses Ergebnis die Ergebnis-Mail per Double-Opt-in aktiviert, wird das Ergebnis nicht direkt angezeigt.
4. Stattdessen wird das konfigurierte Feedback-Formular angezeigt.
5. Die teilnehmende Person gibt ihre E-Mail-Adresse ein und sendet das Formular ab.
6. Ein Opt-in-Datensatz wird angelegt und speichert das ermittelte Ergebnis.
7. Eine Double-Opt-in-E-Mail mit einem Bestätigungslink wird an die teilnehmende Person versendet.
8. Die teilnehmende Person klickt auf den Bestätigungslink.
9. Der Opt-in-Datensatz wird als bestätigt markiert.
10. Die Ergebnis-E-Mail wird an die teilnehmende Person versendet.
11. Im Frontend wird eine Bestätigungsmeldung angezeigt.

Konfiguration im Quiz-Ergebnis-Datensatz

Die Funktion wird direkt im Quiz-Ergebnis-Datensatz konfiguriert. Dies ermöglicht es unterschiedliche Formulare je Ergebnis auszuspielen.

Ergebnis-Mail nach Opt-in versenden

Feld: send_result_mail_after_optin

Ist die Option aktiviert, wird das Ergebnis am Ende des Quiz nicht direkt angezeigt. Stattdessen muss die teilnehmende Person ihre E-Mail-Adresse bestätigen, bevor sie das Ergebnis per E-Mail erhält.

Alle folgenden Felder werden nur angezeigt, wenn diese Checkbox aktiviert ist.

Betreff der Opt-in-Mail

Feld: optin_mail_subject

Betreff der ersten E-Mail, die den Bestätigungslink enthält.

Beispiel:

Bestätigen Sie Ihre E-Mail-Adresse, um Ihr Quiz-Ergebnis zu erhalten

Inhalt der Opt-in-Mail

Feld: optin_mail_body

Inhalt der Bestätigungs-E-Mail.

Der Inhalt kann mit einem minimalen RTE bearbeitet werden. Der Bestätigungslink kann über den folgenden Platzhalter eingefügt werden:

{confirmationLink}

Empfohlene Verwendung im RTE:

<p>Bitte bestätigen Sie Ihre E-Mail-Adresse, um Ihr Quiz-Ergebnis zu erhalten.</p>
<p><a href="{confirmationLink}">E-Mail-Adresse bestätigen</a></p>

So kann die sichtbare Linkbeschriftung frei festgelegt werden.

Betreff der Ergebnis-Mail

Feld: result_mail_subject

Betreff der zweiten E-Mail, die das eigentliche Quiz-Ergebnis enthält.

Beispiel:

Ihr Quiz-Ergebnis

Inhalt der Ergebnis-Mail

Feld: result_mail_body

Inhalt der Ergebnis-E-Mail.

Auch dieses Feld kann mit dem minimalen RTE bearbeitet werden und darf Platzhalter enthalten.

Verfügbare Platzhalter

Die folgenden Platzhalter können in den Feldern für die Opt-in-Mail und die Ergebnis-Mail verwendet werden:

{score}
{questionsCount}
{questionsCorrect}
{correctPercent}
{quizTitle}
{resultTitle}
{confirmationLink}

Beschreibung der Platzhalter

Der Platzhalter {confirmationLink} steht nur in der Opt-in-Mail zur Verfügung, da die Ergebnis-Mail erst nach erfolgter Bestätigung versendet wird.

Anforderungen an das Feedback-Formular

Ist diese Funktion aktiviert, muss das Quiz-Ergebnis über ein Feedback-Formular verfügen.

Das Feedback-Formular muss genau ein E-Mail-Feld mit dem folgenden Feldschlüssel enthalten:

email

Dieser Schlüssel ist erforderlich, damit die Extension die E-Mail-Adresse der teilnehmenden Person beim Absenden des Feedback-Formulars zuverlässig auslesen kann.

Weitere Felder können frei konfiguriert werden.

Beispiele:

• Name
• Telefon
• Firma
• Nachricht
• Datenschutz-Checkbox
• Einwilligungs-Checkbox

Erforderliche Datenschutz- oder Einwilligungs-Checkboxen sollten direkt im Feedback-Formular durch die Redaktion konfiguriert werden.

Empfohlener Text für die Datenschutz-Checkbox

Eine erforderliche Checkbox könnte einen Text wie den folgenden verwenden:

Ich möchte mein Quiz-Ergebnis per E-Mail erhalten und bin damit einverstanden, dass meine E-Mail-Adresse zu diesem Zweck verarbeitet wird. Die Bestätigung erfolgt per Double-Opt-in. Weitere Informationen finden Sie in der Datenschutzerklärung.

Für Newsletter, Werbung oder jede weitere Nutzung der E-Mail-Adresse ist eine separate Einwilligungs-Checkbox erforderlich.

Opt-in-Datensatz

Beim Absenden des Feedback-Formulars wird ein Opt-in-Datensatz in tx_quiz_domain_model_quizresultmailoptin angelegt.

Der Opt-in-Datensatz speichert die für den Bestätigungsprozess relevanten Informationen.

Typische Felder:

Das ermittelte Ergebnis wird direkt im Opt-in-Datensatz gespeichert. Dadurch ändert sich das Ergebnis nicht mehr, falls die Punktebereiche der Quiz-Ergebnisse nachträglich bearbeitet werden, nachdem die teilnehmende Person das Formular abgesendet hat.

Bestätigungslink

Der Bestätigungslink verweist auf die Teilnahmeseite und wird über die Extbase-Aktion confirmOptin des Plugins Quiz verarbeitet. Der eindeutige Opt-in-Hash wird als Argument hash übergeben.

Ohne Route-Enhancer sieht der Link wie folgt aus:

/teilnahmeseite?tx_quiz_quiz[action]=confirmOptin&tx_quiz_quiz[controller]=Quiz&tx_quiz_quiz[hash]=HASH

Ein sprechender Pfad kann über einen Route-Enhancer konfiguriert werden (siehe „Sprechende URLs“):

routePath: '/confirm-optin/{quiz_hash}'
_controller: 'Quiz::confirmOptin'
_arguments:
  quiz_hash: hash

Daraus ergibt sich eine URL wie:

/teilnahmeseite/confirm-optin/HASH

Die Verwendung der Teilnahmeseite bietet mehrere Vorteile:

• Der Quiz-Kontext bleibt erhalten.
• Das Seitenlayout bleibt konsistent.
• Es wird keine zusätzliche Bestätigungsseite benötigt.
• Bestehende Slug- und Routing-Logik kann wiederverwendet werden.

Bestätigungszustände

Nachdem die teilnehmende Person auf den Bestätigungslink geklickt hat, zeigt das Frontend je nach Ergebnis der Bestätigung eine Flash-Meldung an.

Erfolgreiche Bestätigung

Ihre E-Mail-Adresse wurde bestätigt. Ihr Quiz-Ergebnis ist auf dem Weg in Ihr Postfach.

Bereits bestätigt

Dieser Link wurde bereits bestätigt.

Abgelaufener Link

Dieser Bestätigungslink ist abgelaufen. Bitte fordern Sie Ihr Ergebnis erneut an.

Ungültiger Bestätigungslink

Dieser Bestätigungslink ist ungültig.

Fehler beim Mailversand

Fehler beim Versand Ihrer Quiz-Ergebnis-Mail.

Caching

Die Bestätigungs-Aktion darf nicht gecacht werden.

Der Bestätigungslink löst Datenbankänderungen aus und versendet eine E-Mail. Daher ist die Aktion confirmOptin als nicht-cachebare Aktion des Plugins Quiz konfiguriert.

Mail-Rendering

Der Mail-Inhalt wird über das TYPO3-Fluid-Mail-Rendering (FluidEmail) gerendert.

Der Request des Controllers wird an den Mail-Service übergeben, damit er für die FluidEmail verwendet werden kann:

$mail->setRequest($request);

Die Übergabe des Controller-Requests statt $GLOBALS['TYPO3_REQUEST'] macht den Service sauberer und besser testbar.

RTE-Nutzung

Die Felder für den Inhalt der Opt-in-Mail und der Ergebnis-Mail verwenden einen minimalen RTE (rteMailMinimal).

Der RTE stellt ein Platzhalter-Dropdown bereit, das die verfügbaren Platzhalter direkt in den Text einfügt.

Normale Platzhalter kann die Redaktion direkt einfügen:

Sie haben {score} Punkte erreicht.

Für den Bestätigungslink sollte die Redaktion den Platzhalter als Linkziel verwenden:

<a href="{confirmationLink}">E-Mail-Adresse bestätigen</a>

So bleibt die sichtbare Linkbeschriftung bearbeitbar.

Backend-Werkzeuge

Der Quiz-Datensatz stellt zwei Backend-Aktionen für Opt-in-Datensätze bereit.

Opt-in-Datensätze zurücksetzen oder löschen

Diese Aktion entfernt bestehende Opt-in-Datensätze.

Sie ist vor allem nach Tests nützlich, damit Test-Teilnahmen entfernt werden können, bevor das Quiz live geht.

Opt-in-Datensätze exportieren

Diese Aktion exportiert Opt-in-Datensätze als CSV-Datei zur weiteren Verarbeitung.

Beispielhafte Anwendungsfälle:

• Manuelle Verarbeitung
• Reporting
• Import in Newsletter-Tools
• Import in CleverReach

Für externe Newsletter- oder Marketing-Prozesse sollten nur bestätigte Datensätze verwendet werden, und auch nur dann, wenn die erforderliche Einwilligung vorliegt.

Wichtige Hinweise

• Das Feedback-Formular muss genau ein E-Mail-Feld mit dem Schlüssel email enthalten.
• Das Ergebnis wird im Frontend nicht angezeigt, wenn die Ergebnis-Mail per Double-Opt-in aktiviert ist.
• Der Bestätigungslink bestätigt das Opt-in und versendet die Ergebnis-Mail.
• Die Ergebnis-Mail wird nur einmal versendet.
• Der Opt-in-Datensatz speichert das ermittelte Ergebnis, um spätere Inkonsistenzen zu vermeiden.
• Die Einwilligung für Newsletter oder Werbung muss getrennt von der Ergebnisauslieferung behandelt werden.
• Stelle sicher, dass du die benutzerbezogenen Informationen im Optin-Datensatz nur so lange wie erfoderlich speicherst.