Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:functions:mailresume [01.03.2015 15:59] – [mailResume()] Typo admin
+++ de:create:functions:mailresume [27.02.2020 15:57] – [Serienmail nach Opt-In-Frage] admin
@@ Zeile 58: / Zeile 58: @@
   // Zeit speichern
   $timeBreak1 = time();
-  registerVariable('timeBreak1');
+  registerVariable($timeBreak1);
   // E-Mail vorbereiten
   // Serienmail mit der Kennung 2 genau in 14 Tagen versenden
@@ Zeile 88: / Zeile 88: @@
 <code php>
 mailResume('ABCDE123', 3, 0);
+</code>
+===== Serienmail nach Opt-In-Frage =====
+Mit einer Frage vom Typ [[:de:create:questions:opt-in]] kann man im Fragebogen E-Mail-Adressen abfragen und direkt in die Adressliste (**Einladungen verschicken** -> **Adressliste**) eintragen, sodass man später Serienmails an die E-Mail-Adressen versenden kann.
+Dieser Abschnitt erklärt, wie man mittels ''[[:de:create:functions:mailschedule]]'' automatisch den zeitgesteuerten oder unmittelbaren Versand einer Serienmail an die eingetragene E-Mail-Adresse auslöst.
+Bei der Opt-In-Frage gibt es zwei Mechanismen: Das Double-Opt-In (der Teilnehmer muss den Adresseintrag erst via Bestätigungsmail bestätigen, empfohlen) und das Single-Opt-In, bei welchem die (möglicherweise falsche) E-Mail-Adresse direkt gespeichert wird.
+  - Beim Double-Opt-In ist es sinnvoll, den Versand erst nach Bestätigung der Mailadresse auszulösen. Wie das funktioniert wird in folgendem Kapitel erläutert: [[:/de:survey:opt-in-live]]
+  - Wenn die Serienmail direkt verschickt werden soll, kann man die Bestätigungsmail der (Double-)Opt-In-Frage zugleich als Einladungsmail zu einem Fragebogen genutzt werden (//Weitere Einstellungen// -> //Weiterleitung nach Bestätigung// -> //Fragebogen-Link aus//). Allerdings ist der Link in der Bestätigungsmail nur 24 Stunden gültig. Eine "richtige" Serienmail-Einladung ist i.d.R. für den gesamten Erhebungszeitraum gültig, sofern die Gültigkeit in den Serienmail-Einstellungen nicht begrenzt wird.
+  - Wenn eine "richtige" Serienmail im Anschluss an ein Single-Opt-In verschickt werden soll, kommt der Befehl ''mailSchedule()'' zum Einsatz. Der PHP-Code wird (frühestens) auf der Seite platziert, welche auf die Opt-In-Frage folgt. Als erster Parameter muss die Teilnehmer-Kennung der soeben registrierten Adresse verwendet werden.
+Im folgenden Beispiel hätte die Opt-In-Frage auf Seite 9 die Kennung "OI01". Auf Seite 10 (oder später) würde der folgende PHP-Code dann sofort die Serienmail mit der ID 2 versenden. Das ''value('OI01')'' liefert die Teilnehmerkennung (SERIAL) des neuen Adresseintrags.
+<code php>
+mailSchedule(value('OI01'), 2, 0);
+</code>
+Der folgende PHP-Code würde die Serienmail mit der ID 3 nach 14 Tagen versenden:
+<code php>
+mailSchedule(value('OI01'), 3, strtotime('+7 days'));
+</code>
+Es können natürlich auch mehrere Serienmails vorbereitet werden:
+<code php>
+mailSchedule(value('OI01'), 2, 0);
+mailSchedule(value('OI01'), 3, strtotime('+7 days'));
+mailSchedule(value('OI01'), 4, strtotime('+14 days'));
 </code>