Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision |
de:create:functions:mailresume [01.03.2015 14:00] – [mailResume()] admin | de:create:functions:mailresume [27.02.2020 15:57] – [Serienmail nach Opt-In-Frage] admin |
---|
* //Serienmail//\\ (Numerische) Kennung der Serienmail, die an den Teilnehmer verschickt werden soll. Im Karteireiter //Erinnerungen/Folgemail// der Serienmail muss für //Art der Folgemail// der Wert "Erinnerung oder Fortsetzung" eingestellt sein. Bitte beachten Sie die Hinweise unten. | * //Serienmail//\\ (Numerische) Kennung der Serienmail, die an den Teilnehmer verschickt werden soll. Im Karteireiter //Erinnerungen/Folgemail// der Serienmail muss für //Art der Folgemail// der Wert "Erinnerung oder Fortsetzung" eingestellt sein. Bitte beachten Sie die Hinweise unten. |
* //Zeitpunkt//\\ Entweder die Verzögerung bis zum Versand (in Sekunden, maximal 153900000) __oder__ ein Unix-Zeitstempel, der den Zeitpunkt für den nächsten Versand definiert. | * //Zeitpunkt//\\ Entweder die Verzögerung bis zum Versand (in Sekunden, maximal 153900000) __oder__ ein Unix-Zeitstempel, der den Zeitpunkt für den nächsten Versand definiert. |
* //C1// bis //C5// (optional)\\ Wenn Sie hier einen Text angeben (optional), können Sie diesen Text mithilfe der Platzhalter ''%custom1%'' bis ''%custom5%'' in der Serienmail verwenden. In Verbindung mit ''value()'' können Sie Beispielsweise Antworten aus dem laufenden Interview in der E-Mail anzeigen. | * //C1// bis //C5// (optional)\\ Wenn Sie hier einen Text angeben (optional), können Sie diesen Text mithilfe der Platzhalter ''%custom1%'' bis ''%custom5%'' in der Serienmail verwenden. In Verbindung mit ''value()'' können Sie beispielsweise Antworten aus dem laufenden Interview in der E-Mail anzeigen. |
| |
===== Hinweise ===== | ===== Hinweise ===== |
// Zeit speichern | // Zeit speichern |
$timeBreak1 = time(); | $timeBreak1 = time(); |
registerVariable('timeBreak1'); | registerVariable($timeBreak1); |
// E-Mail vorbereiten | // E-Mail vorbereiten |
// Serienmail mit der Kennung 2 genau in 14 Tagen versenden | // Serienmail mit der Kennung 2 genau in 14 Tagen versenden |
<code php> | <code php> |
mailResume('ABCDE123', 3, 0); | 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> | </code> |