Amazon Pinpoint 캠페인 메시지 실패 문제를 해결하려면 어떻게 해야 하나요?

해결 방법

처리되거나 타겟팅되지 않은 엔드포인트의 경우

1.    캠페인에 수신자 현지 시간 사용(Use recipients local time) 설정이 활성화되어 있는지 확인합니다. 자세한 내용은 Amazon Pinpoint 사용 설명서의 특정 날짜 및 시간에 캠페인 보내기(Sending the campaign at a specific date and time)를 참조하세요.

2.    설정이 활성화된 경우 각 엔드포인트 정의에 유효한 Demographic.Timezone 속성이 포함되어 있는지 확인합니다.

참고: 엔드포인트에 올바른 Demographic.Timezone 속성이 정의되어 있지 않고 캠페인의 수신자 현지 시간 사용(Use recipients local time) 설정이 활성화되어 있으면 엔드포인트가 처리되지 않습니다.

처리 및 타겟팅되었지만 메시지를 수신하지 않는 엔드포인트의 경우

Amazon Pinpoint 캠페인은 여러 가지 이유로 특정 엔드포인트에 메시지를 전송하지 못할 수 있습니다. 특정 엔드포인트에 대한 메시지 실패 문제를 해결하려면 먼저 이벤트에 대한 정보를 Amazon Kinesis로 전송하도록 Amazon Pinpoint를 구성합니다. 그런 다음 메시지 실패를 재생성하고 Amazon Kinesis에서 실패한 이벤트를 검토하여 오류의 원인을 파악합니다. 오류의 원인을 파악했다면 문제를 해결합니다.

참고: 각 스트리밍 이벤트의 event_type 값은 대부분의 메시지 실패의 원인을 나타냅니다. event_type 값이 메시지 실패의 원인을 명확하게 나타내지 않는 경우 Amazon CloudWatch에서 캠페인의 CampaignSendMessageThrottled 지표를 검토합니다. 이 지표는 AWS 계정의 메시지 전송 기능이 제한되었기 때문에 전송되지 않은 캠페인 메시지 수를 보여줍니다. 자세한 내용은 Amazon Pinpoint 할당량을 참조하세요.

실패한 이메일의 경우

event_type 값 _email.rendering_failure을 사용하여 스트리밍 이벤트를 식별해야 합니다. 이 이벤트 유형(event type)은 일반적으로 이메일 템플릿에 유효하지 않거나 누락된 변수가 포함되어 있음을 나타냅니다.

-또는-

(Kinesis 스트리밍을 활성화하지 않은 경우) Amazon CloudWatch에서 Amazon Simple Email Service(Amazon SES) 렌더링 실패(Rendering Failures) 지표를 검토합니다. 이 지표는 일반적으로 이메일 템플릿에 유효하지 않거나 누락된 변수가 포함되어 있음을 나타냅니다.

CloudWatch에 _email.rendering_failure 이벤트 유형이 포함된 스트리밍 이벤트 또는 Amazon SES 렌더링 실패(Rendering Failures) 지표가 표시되는 경우 다음을 수행합니다.

1.    템플릿 파일의 모든 메시지 변수에 엔드포인트 정의(세그먼트 파일)에 해당하는 엔드포인트 속성이 있는지 확인합니다.

2.    템플릿 파일의 모든 메시지 변수가 엔드포인트 정의에서 올바른 형식인지 확인합니다.

3.    템플릿 파일의 모든 메시지 변수에 **기본 속성 값(Default attribute values)**을 지정합니다. 자세한 내용은 Amazon Pinpoint 사용 설명서의 이메일 템플릿 생성을 참조하세요.

참고: 기본값을 지정하지 않고 수신자에 대한 값이 없는 경우 Amazon Pinpoint는 메시지를 전송하지 않습니다.

자세한 내용은 Amazon Pinpoint 사용 설명서의 메시지 템플릿에 개인화된 콘텐츠 추가를 참조하세요.

---