이메일 반송 추적 시스템
From LimeSurvey Manual
소개
이메일 반송 추적 시스템은 수신자(설문조사 참여자)에게 전달되지 않은 이메일을 찾아 표시할 수 있습니다. 이 시스템은 "이메일 배달 알림 실패 보고서"를 기반으로 작동합니다. 따라서 반송된 이메일을 추적하려면 이메일을 받을 수 있는 이메일 주소가 필요합니다. 계정 주소와 함께 계정 자격 증명 및 연결 세부 정보도 필요합니다.
요구 사항
서버에 php5-imap 모듈이 설치되어 있어야 합니다. LimeSurvey 설치의 전역 설정 페이지에서 개요 탭 아래에 있는 PHPInfo 보기 버튼을 통해 설치 여부를 확인할 수 있습니다.

다음으로 imap 섹션을 찾아보세요(빠른 검색은 Ctrl+F를 사용하세요). imap 섹션이 표시되면 사용할 준비가 된 것입니다.

php5-imap이 설치되어 있지 않고 서버에 대한 루트 권한이 있다면, 사용 중인 배포판에 맞는 절차에 따라 설치할 수 있습니다. 예를 들어 Debian을 사용한다면 이 링크를 확인하세요. 설치 후에는 반드시 웹 서버를 다시 시작해야 합니다(예: 터미널에서 "apache/usr/sbin/apache2ctl restart" 실행).
작동 방식
이 시스템을 개발한 기본 취지는 수작업을 줄이고, 모든 필드를 수동으로 편집할 때 발생할 수 있는 사람의 실수를 줄이는 것이었습니다.
이 시스템의 기본 원리는 이메일을 보낼 때 이메일 반송 추적 시스템이 관리자가 알아차리지 못하게 설문조사 ID와 토큰 ID를 이메일 헤더에 자동으로 추가하는 것입니다.

이러한 헤더(사용자 지정 헤더라고도 함)는 LimeSurvey를 통해 설문조사 참여자에게 보내는 모든 초대 이메일에 추가됩니다.
이메일이 반송되면 원본 헤더와 함께 배달 알림 헤더를 받게 됩니다. 그러면 시스템이 새 이메일을 확인하고 이러한 사용자 지정 헤더가 있는 이메일을 분석합니다. 그리고 설문조사 참여자들 테이블에서 잘못된 이메일 주소의 글꼴 색을 빨간색으로 변경합니다.
시스템 설정
이 시스템은 전역적으로(모든 설문조사에 대해) 또는 로컬로(특정 설문조사에만) 작동할 수 있으며, 그에 따라 설정을 저장할 수 있습니다. 반송 전역 설정은 전역 설정 -> 바운스 설정에서 저장할 수 있습니다. 다음 옵션이 표시됩니다.

- 기본 사이트 바운스 이메일 주소: 반송된 이메일을 받을 이메일 주소입니다. 반송된 이메일을 더 빠르게 처리하려면 LimeSurvey 이메일 반송 추적 시스템에서만 사용하는 이메일 주소를 사용하시길 권장합니다.
- 서버 타입: "Off"로 설정하면 반송 처리 기능을 사용할 수 없습니다. LimeSurvey 이메일 반송 추적 시스템을 사용하려면 "POP" 또는 "IMAP" 중 하나를 선택하세요.
- 서버 이름 & 포트: 서버 이름과 (필요한 경우) 포트를 콜론으로 구분하여 입력합니다. 이메일 호스트가 표준이 아닌 포트를 사용하지 않는 한 일반적으로 포트 번호는 필요하지 않습니다.
- 사용자 이름: POP/IMAP 계정의 사용자 이름입니다.
- 비밀번호: POP/IMAP 계정의 비밀번호입니다.
- 암호화 타입: 암호화를 사용하는 경우 여기에서 올바른 방식(SSL 또는 TLS)을 설정하세요.
단일 설문조사에만 바운스 설정을 적용하려면 해당 설문조사에 접속 -> 설문조사 메뉴에서 설문조사 참여자들 탭 클릭 -> 페이지의 메인 도구 모음에서 초대 & 알림 옵션 클릭 -> 바운스 설정을 클릭합니다. 다음 페이지가 로드됩니다.

추가 옵션은 사용된 바운스 설정입니다. 여기에서 다음 중 무엇을 사용할지 선택할 수 있습니다.
- 바운스 설정 사용 안 함;
- 로컬 바운스 설정. 이 옵션을 선택하면 나머지 로컬 바운스 설정 필드를 작성해야 합니다;
- 전역 바운스 설정. 이 경우 LimeSurvey 설치의 바운스 설정이 사용됩니다.
LimeSurvey Cloud 이메일 서버 사용하기
LimeSurvey Cloud 이메일 서버를 사용하면 모든 이메일의 발신자 주소가 "noreply@limesurvey.org"로 표시됩니다. 다만 이러한 이메일에는 귀하의 이메일 주소가 지정된 Reply-to 헤더가 포함되어 있으므로, 수신자가 회신하면 귀하에게 직접 전달됩니다.
LimeSurvey Cloud 서버를 사용하는 경우 반송은 자동으로 처리됩니다. 별도로 설정할 필요가 없으며 반송 처리를 시작할 필요도 없습니다. 기본 설정을 그대로 두기만 하면 됩니다. 모든 작업은 백그라운드에서 자동으로 이루어집니다. 반송된 이메일이 처리되고 해당 항목에 표시되기까지 10~15분 정도 걸릴 수 있습니다.
반송 처리 시작
반송 처리를 시작하기 전에 먼저 설문조사 참여자들에게 이메일 초대를 보내야 합니다.
버전 3.0 이상에서는 이메일 반송 추적 시스템을 설정한 후, 설문조사 홈페이지 -> 설문조사 메뉴에서 설문조사 참여자들 탭 클릭 -> (도구 모음에 있는) Invitations & reminders 클릭 -> 반송 처리 시작을 선택하여 반송 처리를 시작할 수 있습니다.

이 옵션을 선택하면 처리 중에 진행 표시기가 나타나고, 이어서 최종 처리 현황 요약이 표시됩니다.
발송된 이메일 초대에 대한 검사가 시작됩니다. 검사 결과는 설문조사 참여자들 표에 표시됩니다(최신 상태로 보려면 페이지를 수동으로 새로 고쳐야 할 수 있습니다). 초대가 반송된 모든 항목은 이메일 주소가 빨간색 글꼴로 표시되며, 이메일 현황도 "OK"에서 "bounced"로 변경됩니다.

v2.5에서 반송 처리 시작
버전 2.50 이상에서는 반송 처리 시스템을 설정한 후 반송 처리를 시작할 수 있습니다. 설문조사 홈페이지에서 Invitations & reminders -> 반송 처리 시작을 선택하십시오.

이 옵션을 선택하면 처리 중에 진행 표시기가 나타나고, 이어서 최종 처리 현황 요약이 표시됩니다.
발송된 이메일 초대에 대한 검사가 시작됩니다. 검사 결과는 설문조사 참여자들 표에 표시됩니다(최신 상태로 보려면 페이지를 수동으로 새로 고쳐야 할 수 있습니다). 초대가 반송된 모든 항목은 이메일 주소가 빨간색 글꼴로 표시되며, 이메일 현황도 "OK"에서 "bounced"로 변경됩니다.
예시
LimeSurvey 이메일 반송 추적 시스템이 어떻게 작동하는지 더 잘 이해하려면 아래 예시를 확인하십시오.
1. 응답자를 설문조사 참여자들 표에 등록합니다. 각 응답자에게 토큰과 이메일 주소가 지정되어 있는지 확인하십시오.
2. 설문조사 초대를 보낼 응답자를 선택합니다:

선택한 참여자... 버튼을 클릭한 후 이메일 초대 보내기 옵션을 선택합니다.
3. 이메일이 설문조사 응답자에게 모두 발송되도록 잠시 기다립니다.
4. 이제 LimeSurvey 이메일 반송 추적 시스템을 사용할 수 있습니다. Invitations & reminders를 클릭하고 개인 이메일 계정의 연결 정보와 계정 세부 정보를 반송 이메일 설정 필드에 입력합니다:

필드를 비워 두어도 됩니다. 이 경우에도 반송 처리는 작동하지만 반송 처리와 관련된 이메일은 받지 못합니다. 그래도 설문조사 참여자들 표에 있는 항목의 이메일 현황은 업데이트됩니다.
아래에서 볼 수 있듯이 여기서는 무료 Gmail 계정을 사용하여 이메일 반송 추적 시스템을 사용합니다. Gmail 연결 설정에 대한 내용은 다음 링크를 참조하십시오. 또한 Gmail 계정 설정에서 IMAP/POP을 활성화하는 것을 잊지 마십시오.

필드를 입력하십시오. 원하는 서버 및 암호화 설정을 선택하십시오. 완료되면 화면 오른쪽 상단에 있는 저장 버튼을 클릭하십시오.
5. 이제 반송 처리 시작 버튼을 클릭할 수 있습니다:

이메일 반송 추적 시스템은 반송된 각 이메일의 헤더에 첨부된 설문조사 ID, 토큰 ID 및 배달 알림을 찾기 시작합니다. 이러한 사용자 지정 헤더가 존재하면 시스템은 설문조사 참여자들 표에서 잘못된 이메일 주소의 글꼴 색을 빨간색으로 변경합니다. 또한 해당 항목의 이메일 현황이 OK에서 bounced로 바뀝니다.
