지원 종료 공지: 2026년 10월 30일에 AWS는 Amazon Pinpoint에 대한 지원을 종료합니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 Amazon Pinpoint 지원 종료를 참조하세요. 참고: SMS, 음성, 모바일 푸시, OTP, 전화번호 확인과 관련된 API는 이 변경의 영향을 받지 않으며, AWS End User Messaging에서 지원됩니다.
이메일 채널 문제 해결
실패 원인을 식별하는 데 도움이 되도록 로깅이 켜져 있는지 확인하세요. 로깅에 대한 자세한 내용은 모니터링 및 로깅과 이메일 이벤트 섹션을 참조하세요.
렌더링 문제
-
이메일 템플릿을 사용할 때 메시지 변수가 누락되거나, 형식이 잘못되었거나, 메시지 변수와 엔드포인트 데이터 간에 불일치가 발생하여 이메일 전송이 실패하는 경우 렌더링 오류가 발생합니다.
-
렌더링 문제를 확인하려면 캠페인이 실행된 기간 동안 Amazon SES CloudWatch 지표
RenderingFailure를 검토합니다. 렌더링 실패는 Amazon Pinpoint 이벤트 로그에 _email.rendering_failure 이벤트로 나타납니다. -
문제를 해결하려면 모든 메시지 변수에 해당하는 엔드포인트 속성이 있고 형식이 올바른지 확인하세요. 자세한 내용은 메시지 템플릿에 맞춤형 콘텐츠 추가 섹션을 참조하세요.
-
엔드포인트에 대한 속성이 누락된 경우 실패가 발생하지 않도록 템플릿의 모든 메시지 변수에 대한 기본값을 구성합니다.
-
템플릿 없이 캠페인을 실행하여 엔드포인트가 메시지를 성공적으로 수신할 수 있는지 확인합니다. 이 작업은 문제가 템플릿 변수와 관련이 있는지 확인하는 데 도움이 될 수 있습니다.
반송 상태
소프트 바운스 해결책
-
소프트 바운스는 일시적인 실패로 인해 발생하며, 로그의 _email.softbounce 이벤트 유형 아래에 나타납니다. Amazon Pinpoint는 일정 기간 동안 소프트 바운스 이메일 재전송을 시도하는 방법으로 소프트 바운스를 처리합니다.
-
소프트 바운스는 다음 시나리오에서 발생할 수 있습니다.
-
수신자 사서함이 꽉 찼습니다.
-
수신자 사서함을 일시적으로 사용할 수 없습니다.
-
서버 제한을 초과했습니다.
-
서버에 과부하가 걸렸습니다.
-
-
소프트 바운스와 관련된 특정 오류 코드는 421, 450, 451 또는 452입니다. 이러한 오류 코드에 대한 설명은 SMTP(Simple Mail Transfer Protocol) 확장 상태 코드 레지스트리
를 참조하세요. 로그의 smtp_response는 반송 이벤트의 오류 코드를 제공합니다.
하드 바운스 해결책
-
하드 바운스는 로그의 _email.hardbounce 이벤트 유형 아래에 나타나는 지속적인 전송 실패입니다. 이러한 실패는 다시 시도되지 않습니다.
-
하드 바운스는 다음 시나리오에서 발생할 수 있습니다.
-
이메일 주소가 존재하지 않습니다.
-
도메인 이름이 존재하지 않습니다.
-
수신자의 이메일 서버가 이메일을 차단했습니다.
-
이메일 주소가 계정 금지 목록에 있습니다.
-
-
프로젝트에서 하드 바운스의 수를 모니터링하고 수신자 목록에서 하드 바운스를 일으키는 이메일 주소를 제거하세요. 하드 바운스는 전송 평판과 이메일 메시지의 배달 가능성에 부정적인 영향을 미칠 수 있습니다. 자세한 내용은 반송 메일의 모범 사례를 참조하세요.