Email bounce tracking system/nl: Difference between revisions
From LimeSurvey Manual
(Created page with "In versie 3.0+ kun je na het eenmalig inrichten van het '''e-mail bounce tracking systeem''' de '''bounce-verwerking''' starten via de startpagina van de enquête -> klik op d...") |
No edit summary |
||
| (38 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<languages /> | <languages /> | ||
__TOC__ | __TOC__ | ||
=Inleiding= | =Inleiding= | ||
Het systeem voor het controleren van niet verzonden e-mail | |||
Het systeem voor het controleren van niet verzonden e-mail ziet welke e-mails niet goed verzonden zijn naar de ontvangers (deelnemers aan de enquêtes). Dit gaat via het "mail delivery notification failure report". Er is een e-mailadres nodig om deze ''bounces'' door te sturen. Ook de credentials en de connectie-details van dit account zijn benodigd. | |||
{{Box|Bij de meeste e-mail en hostingproviders kun je via SMTP e-mails verzenden. Je moet wel uitzoeken welke gegevens je van SMTP nodig hebt om een e-mailadres voor bounces te gebruiken.}} | {{Box|Bij de meeste e-mail en hostingproviders kun je via SMTP e-mails verzenden. Je moet wel uitzoeken welke gegevens je van SMTP nodig hebt om een e-mailadres voor bounces te gebruiken.}} | ||
=Vereisten= | =Vereisten= | ||
De <u>php5-imap</u> module moet op de server zijn geïnstalleerd. Dit kun je controleren, door te klikken op de knop "PHPInfo" | |||
De <u>php5-imap</u> module moet op de server zijn geïnstalleerd. Dit kun je controleren, door te klikken op de knop "PHPInfo" bij de [[Global settings/nl|Algemene instellingen]] op de tab [[Global settings/nl#Overzicht|Overzicht]] . | |||
| Line 23: | Line 27: | ||
Als er geen php5-imap geïnstalleerd is, en je mag ook niet naar de root van de server, dan kun je via de voor jouw geldende procedure proberen te installeren. In geval van gebruik van Debian: [http://www.electrictoolbox.com/install-php-imap-debian/] . Je moet dan wel je webserver opnieuw starten, bijvoorbeeld met "apache/usr/sbin/apache2ctl restart". | Als er geen php5-imap geïnstalleerd is, en je mag ook niet naar de root van de server, dan kun je via de voor jouw geldende procedure proberen te installeren. In geval van gebruik van Debian: [http://www.electrictoolbox.com/install-php-imap-debian/] . Je moet dan wel je webserver opnieuw starten, bijvoorbeeld met "apache/usr/sbin/apache2ctl restart". | ||
=Werking= | =Werking= | ||
De redenen voor het ontwikkelen van dit bounce-systeem is het verminderen van het handwerk waarbij er natuurlijk kans is op fouten omdat er dan velden afzonderlijk moeten worden bijgewerkt. | De redenen voor het ontwikkelen van dit bounce-systeem is het verminderen van het handwerk waarbij er natuurlijk kans is op fouten omdat er dan velden afzonderlijk moeten worden bijgewerkt. | ||
| Line 37: | Line 43: | ||
Wanneer de e-mail bounced, dus niet verzonden is, wordt de originele header ontvangen met de header van de "Delivery notification". Het systeem kijkt in de e-mails die ontvangen worden of er een aangepaste header in staat. De kleur van het foutieve e-mailadres wordt gewijzigd in rood in de [[Survey_participants/nl|deelnemerstabel]]. | Wanneer de e-mail bounced, dus niet verzonden is, wordt de originele header ontvangen met de header van de "Delivery notification". Het systeem kijkt in de e-mails die ontvangen worden of er een aangepaste header in staat. De kleur van het foutieve e-mailadres wordt gewijzigd in rood in de [[Survey_participants/nl|deelnemerstabel]]. | ||
=Installatie= | =Installatie= | ||
Het systeem kan op algemeen (alle enquêtes) of op enquête niveau werken. Op algemeen niveau kunnen de instellingen worden ingesteld bij ''' | |||
Het systeem kan op algemeen (alle enquêtes) of op enquête niveau werken. Op algemeen niveau kunnen de instellingen worden ingesteld bij '''Algemene instellingen''' -> '''Bounce instellingen'''. De volgende instellingen worden getoond: | |||
| Line 48: | Line 56: | ||
*'''Standaard site bounce e-mail:''' Het e-mailadres waar niet verzonden e-mails heen worden verzonden. Wij bevelen aan dat je een e-mailadres gebruikt dat je alleen hiervoor gebruikt. | *'''Standaard site bounce e-mail:''' Het e-mailadres waar niet verzonden e-mails heen worden verzonden. Wij bevelen aan dat je een e-mailadres gebruikt dat je alleen hiervoor gebruikt. | ||
*'''Servertype:''' Door " | *'''Servertype:''' Door "Uit" te kiezen kun je instellen dat je de functie niet wilt gebruiken. Je gebruikt de functie wel met de waarden "POP" en "IMAP". | ||
*'''Servernaam en poort:''' Naam van de server en optioneel de poort (gebruik een dubbele punt als scheidingsteken voor de poort). Je hoeft de poort alleen op te geven als het niet de standaardpoort is voor e-mail. | *'''Servernaam en poort:''' Naam van de server en optioneel de poort (gebruik een dubbele punt als scheidingsteken voor de poort). Je hoeft de poort alleen op te geven als het niet de standaardpoort is voor e-mail. | ||
| Line 70: | Line 78: | ||
De extra optie is de '''Gebruikte bounce-instellingen'''. De keuzes zijn: | De extra optie is de '''Gebruikte bounce-instellingen'''. De keuzes zijn: | ||
* Geen | * Geen | ||
* Gebruik | * Gebruik onderstaande instellingen | ||
* Gebruik algemene instellingen | * Gebruik algemene instellingen | ||
<div class="simplebox">[[File:help.png]] '''NB:''' LimeSurvey zal de SMTP verbinding maken vanaf het IP-adres van je LimeSurvey-installatie. Zoek deze waarde met ping van de URL van de installatie. Als de SMTP-server is vergrendelt (locked-down) dan moet je het IP-adres toevoegen als uitzondering aan je SMTP-configuratie/firewall.</div> | <div class="simplebox">[[File:help.png]] '''NB:''' LimeSurvey zal de SMTP verbinding maken vanaf het IP-adres van je LimeSurvey-installatie. Zoek deze waarde met ping van de URL van de installatie. Als de SMTP-server is vergrendelt (locked-down) dan moet je het IP-adres toevoegen als uitzondering aan je SMTP-configuratie/firewall.</div> | ||
| Line 77: | Line 85: | ||
===Bij gebruik van LimeSurvey PRO e-mailserver=== | ===Bij gebruik van LimeSurvey PRO e-mailserver=== | ||
Als je de LimeSurvey Professionele e-mailserver gebruikt, dan hebben alle e-mails als afzender "noreply@limesurvey.org". Deze e-mails hebben echter een Reply-to header met je e-mailadres. Dus je krijgt een reactie als de ontvanger de e-mail beantwoordt. | Als je de LimeSurvey Professionele e-mailserver gebruikt, dan hebben alle e-mails als afzender "noreply@limesurvey.org". Deze e-mails hebben echter een Reply-to header met je e-mailadres. Dus je krijgt een reactie als de ontvanger de e-mail beantwoordt. | ||
| Line 82: | Line 91: | ||
Dit systeem is eenvoudig in te richten (door de instellingen van de bounce leeg te laten), er is dan een probleem : als de e-mail niet verzonden wordt en dus bounced dan krijg je ook geen bevestiging. | Dit systeem is eenvoudig in te richten (door de instellingen van de bounce leeg te laten), er is dan een probleem : als de e-mail niet verzonden wordt en dus bounced dan krijg je ook geen bevestiging. | ||
{{Alert|Attentie|text=Misbruik | {{Alert|Attentie|text=Misbruik LimeSurvey niet om spam te versturen, we moeten dan je account blokkeren. Zorg dat je alleen uitnodigingen stuurt naar mensen van wie je mag aannemen dat ze je uitnodigingen willen ontvangen.}} | ||
== Starten bounce-verwerking in v3.0 == | == Starten bounce-verwerking in v3.0 == | ||
| Line 94: | Line 103: | ||
Na het selecteren van deze optie wordt er een voortgangsbalk weergegeven met na het afronden een verslag van de verwerking. | |||
<!--100--> | <!--100--> | ||
De verzonden uitnodigingen worden dan bekeken. De resultaten worden getoond in de [[Survey participants/nl#Deelnemers tonen|deelnemerstabel]] (Ververs eventueel de pagina). Van de niet verzonden uitnodigingen wordt het e-mailadres in het rood getoond. De '''E-mailstatus''' wordt gewijzigd van "OK" in "bounced". | |||
| Line 105: | Line 114: | ||
== Starten bounce-verwerking in v2.5 == | == Starten bounce-verwerking in v2.5 == | ||
Indien de bounce-verwerking is ingeschakeld kun je de verwerking van | Indien de bounce-verwerking is ingeschakeld kun je de verwerking van niet afgeleverde e-mails starten vanaf de startpagina van de enquête : "Uitnodigingen en herinneringen" -> '''Start verwerken bounce'''. | ||
| Line 113: | Line 122: | ||
Na het selecteren van deze optie wordt er een voortgangsbalk weergegeven met na het afronden een verslag van de verwerking. | Na het selecteren van deze optie wordt er een voortgangsbalk weergegeven met na het afronden een verslag van de verwerking. | ||
De verzonden uitnodigingen worden dan bekeken. De resultaten worden getoond in de [[Survey participants/nl#Deelnemers tonen|deelnemerstabel]] (Ververs eventueel de pagina). Van de niet verzonden uitnodigingen wordt het e-mailadres in het rood getoond. De '''E-mailstatus''' wordt gewijzigd van "OK" in "bounced". | |||
{{Alert|title=Attentie|text=In versie 2.50+ wordt de menu-keuze niet goed getoond. Dit is aangepast in build 160714 van 14-07-2016.}} | |||
| Line 122: | Line 130: | ||
In het volgende voorbeeld leggen we de werking uit: | |||
{{Box| | {{Box|Dit voorbeeld is gemaakt met LimeSurvey 2.06+. De meeste stappen en schermen komen overeen met LimeSurvey 3.0 en geven dus aan hoe je het '''e-mail bounce tracking systeem''' kunt gebruiken.}} | ||
1. | 1. Registreer de deelnemers aan je enquête in de deelnemerstabel van de enquête. Zorg ervoor dat ze allemaal een token en een e-mailadres hebben. | ||
2. | 2. Selecteer de deelnemers aan wie je een uitnodiging om deel te nemen aan de enquête wilt versturen. | ||
| Line 135: | Line 143: | ||
Klik op de knop '''Geselecteerde deelnemer(s)...''' en kies de optie '''Verzend uitnodigingen'''. | |||
3. | 3. Wacht totdat de e-mails verzonden zijn. | ||
4. | 4. Je kunt daarna dit systeem gebruiken. Klik op '''Uitnodigingen en herinneringen''' en vul de instellingen van de bounce-verwerking in met de gegevens van de verbinding en het account van je eigen e-mailadres: | ||
| Line 147: | Line 155: | ||
Als je deze gegevens niet invult, dan werkt de verwerking van de bounces wel maar krijg je e-mails hierover. De e-mailstatus in de [[Survey participants/nl|deelnemerstabel]] wordt wel bijgewerkt. | |||
'' | ''Zoals je hieronder kunt zien, gebruiken we hier een gratis Gmail-account. Meer informatie over [https://support.google.com/mail/answer/7126229?hl=nl instellingen voor Gmail]. Schakel de IMAP/POP in bij de instellingen van je Gmail-account.'' | ||
| Line 155: | Line 163: | ||
{{Alert| | {{Alert|Attentie|text=Gmail kan de verbinding met je LimeSurvey- account als onveilig zien. Om toch verbinding te kunnen maken kun je toestaan dat [https://support.google.com/accounts/answer/6010255?hl=nl het gebruik van je account minder streng wordt gecontroleerd].}} | ||
Vul de velden in. Selecteer de server en de encryptie. Klik op de knop '''Opslaan''' rechtsboven in het scherm. | |||
5. | 5. Klik nu op de knop '''Start verwerken bounce''': | ||
| Line 166: | Line 174: | ||
Het systeem zoekt nu naar het survey-id, het token-id en de delivery notification in de header van elke e-mail die gebounced is. De kleur van de e-mailadressen van deze gebouncede e-mails worden in de tabel met deelnemers rood weergegeven. Ook wordt de e-mailstatus dan gewijzigd in ''bounced''. | |||
| Line 172: | Line 180: | ||
{{Note| | {{Note|Als je vragen hebt, kijk dan eens rond op [https://www.limesurvey.org/forum ons forum] of [irc://irc.freenode.net/limesurvey het IRC-channel].}} | ||
Revision as of 15:36, 9 August 2018
Inleiding
Het systeem voor het controleren van niet verzonden e-mail ziet welke e-mails niet goed verzonden zijn naar de ontvangers (deelnemers aan de enquêtes). Dit gaat via het "mail delivery notification failure report". Er is een e-mailadres nodig om deze bounces door te sturen. Ook de credentials en de connectie-details van dit account zijn benodigd.
Vereisten
De php5-imap module moet op de server zijn geïnstalleerd. Dit kun je controleren, door te klikken op de knop "PHPInfo" bij de Algemene instellingen op de tab Overzicht .
Zoek vervolgens (eventueel met control-f) naar de imap-sectie, het ziet er ongeveer als volgt uit:
Als er geen php5-imap geïnstalleerd is, en je mag ook niet naar de root van de server, dan kun je via de voor jouw geldende procedure proberen te installeren. In geval van gebruik van Debian: [1] . Je moet dan wel je webserver opnieuw starten, bijvoorbeeld met "apache/usr/sbin/apache2ctl restart".
Werking
De redenen voor het ontwikkelen van dit bounce-systeem is het verminderen van het handwerk waarbij er natuurlijk kans is op fouten omdat er dan velden afzonderlijk moeten worden bijgewerkt.
Als er een e-mail verzonden wordt, dan wordt er door dit systeem automatisch een survey-id en token-id aan de e-mailheader toegevoegd zonder melding aan de beheerder.
Deze headers (ook wel "custom headers") worden toegevoegd aan elke uitnodiging die naar een deelnemer wordt verzonden.
Wanneer de e-mail bounced, dus niet verzonden is, wordt de originele header ontvangen met de header van de "Delivery notification". Het systeem kijkt in de e-mails die ontvangen worden of er een aangepaste header in staat. De kleur van het foutieve e-mailadres wordt gewijzigd in rood in de deelnemerstabel.
Installatie
Het systeem kan op algemeen (alle enquêtes) of op enquête niveau werken. Op algemeen niveau kunnen de instellingen worden ingesteld bij Algemene instellingen -> Bounce instellingen. De volgende instellingen worden getoond:
- Standaard site bounce e-mail: Het e-mailadres waar niet verzonden e-mails heen worden verzonden. Wij bevelen aan dat je een e-mailadres gebruikt dat je alleen hiervoor gebruikt.
- Servertype: Door "Uit" te kiezen kun je instellen dat je de functie niet wilt gebruiken. Je gebruikt de functie wel met de waarden "POP" en "IMAP".
- Servernaam en poort: Naam van de server en optioneel de poort (gebruik een dubbele punt als scheidingsteken voor de poort). Je hoeft de poort alleen op te geven als het niet de standaardpoort is voor e-mail.
- Gebruikersnaam: De gebruikersnaam van het POP/IMAP account.
- Wachtwoord: Het wachtwoord van het POP/IMAP account.
- Encryptiemethode: Als er encryptie wordt gebruikt, geef hier dan op welke (SSL of TLS).
Als je voor één enquête bounce-instelling wilt gebruiken, ga dan naar die enquête en klik op de tab Deelnemers -> klik op de optie Uitnodigen en herinneringen -> klik op Bounce instellingen. Je krijgt dan de volgende pagina:
De extra optie is de Gebruikte bounce-instellingen. De keuzes zijn:
- Geen
- Gebruik onderstaande instellingen
- Gebruik algemene instellingen
NB: LimeSurvey zal de SMTP verbinding maken vanaf het IP-adres van je LimeSurvey-installatie. Zoek deze waarde met ping van de URL van de installatie. Als de SMTP-server is vergrendelt (locked-down) dan moet je het IP-adres toevoegen als uitzondering aan je SMTP-configuratie/firewall.
Bij gebruik van LimeSurvey PRO e-mailserver
Als je de LimeSurvey Professionele e-mailserver gebruikt, dan hebben alle e-mails als afzender "noreply@limesurvey.org". Deze e-mails hebben echter een Reply-to header met je e-mailadres. Dus je krijgt een reactie als de ontvanger de e-mail beantwoordt.
Dit systeem is eenvoudig in te richten (door de instellingen van de bounce leeg te laten), er is dan een probleem : als de e-mail niet verzonden wordt en dus bounced dan krijg je ook geen bevestiging.
Misbruik LimeSurvey niet om spam te versturen, we moeten dan je account blokkeren. Zorg dat je alleen uitnodigingen stuurt naar mensen van wie je mag aannemen dat ze je uitnodigingen willen ontvangen.
Starten bounce-verwerking in v3.0
Voordat je de bounces gaat verwerken, kun je natuurlijk beter eerst de uitnodigingen e-mailen aan de deelnemers aan je enquête.
In versie 3.0+ kun je na het eenmalig inrichten van het e-mail bounce tracking systeem de bounce-verwerking starten via de startpagina van de enquête -> klik op de tab Deelnemers aan de enquête -> klik op Uitnodigingen en herinneringen -> Start verwerken bounce.
Na het selecteren van deze optie wordt er een voortgangsbalk weergegeven met na het afronden een verslag van de verwerking.
De verzonden uitnodigingen worden dan bekeken. De resultaten worden getoond in de deelnemerstabel (Ververs eventueel de pagina). Van de niet verzonden uitnodigingen wordt het e-mailadres in het rood getoond. De E-mailstatus wordt gewijzigd van "OK" in "bounced".
Starten bounce-verwerking in v2.5
Indien de bounce-verwerking is ingeschakeld kun je de verwerking van niet afgeleverde e-mails starten vanaf de startpagina van de enquête : "Uitnodigingen en herinneringen" -> Start verwerken bounce.
Na het selecteren van deze optie wordt er een voortgangsbalk weergegeven met na het afronden een verslag van de verwerking.
De verzonden uitnodigingen worden dan bekeken. De resultaten worden getoond in de deelnemerstabel (Ververs eventueel de pagina). Van de niet verzonden uitnodigingen wordt het e-mailadres in het rood getoond. De E-mailstatus wordt gewijzigd van "OK" in "bounced".
Attentie : In versie 2.50+ wordt de menu-keuze niet goed getoond. Dit is aangepast in build 160714 van 14-07-2016.
Voorbeeld
In het volgende voorbeeld leggen we de werking uit:
1. Registreer de deelnemers aan je enquête in de deelnemerstabel van de enquête. Zorg ervoor dat ze allemaal een token en een e-mailadres hebben.
2. Selecteer de deelnemers aan wie je een uitnodiging om deel te nemen aan de enquête wilt versturen.
Klik op de knop Geselecteerde deelnemer(s)... en kies de optie Verzend uitnodigingen.
3. Wacht totdat de e-mails verzonden zijn.
4. Je kunt daarna dit systeem gebruiken. Klik op Uitnodigingen en herinneringen en vul de instellingen van de bounce-verwerking in met de gegevens van de verbinding en het account van je eigen e-mailadres:
Als je deze gegevens niet invult, dan werkt de verwerking van de bounces wel maar krijg je e-mails hierover. De e-mailstatus in de deelnemerstabel wordt wel bijgewerkt.
Zoals je hieronder kunt zien, gebruiken we hier een gratis Gmail-account. Meer informatie over instellingen voor Gmail. Schakel de IMAP/POP in bij de instellingen van je Gmail-account.
Gmail kan de verbinding met je LimeSurvey- account als onveilig zien. Om toch verbinding te kunnen maken kun je toestaan dat het gebruik van je account minder streng wordt gecontroleerd.
Vul de velden in. Selecteer de server en de encryptie. Klik op de knop Opslaan rechtsboven in het scherm.
5. Klik nu op de knop Start verwerken bounce:
Het systeem zoekt nu naar het survey-id, het token-id en de delivery notification in de header van elke e-mail die gebounced is. De kleur van de e-mailadressen van deze gebouncede e-mails worden in de tabel met deelnemers rood weergegeven. Ook wordt de e-mailstatus dan gewijzigd in bounced.
