캠페인 문제 해결

실패 원인을 식별하는 데 도움이 되도록 로깅이 켜져 있는지 확인하세요. 자세한 내용은 모니터링 및 로깅을 참조하세요.

캠페인에서 일부 엔드포인트를 성공적으로 처리하거나 타겟팅하지 못했습니다.

대상으로 지정된 엔드포인트: 캠페인 실행 시 메시지가 전송될 선택한 채널의 총 엔드포인트 수입니다. 이 총계에서 중복되거나 비활성 상태인 엔드포인트는 세그먼트에서 제외됩니다.

처리된 엔드포인트: 캠페인 실행 중에 메시지가 전송되어 성공적으로 대상 지정된 엔드포인트의 총 수입니다.

문제 및 해결 방법

• 성공적으로 처리된 엔드포인트 수가 세그먼트의 총 엔드포인트 수보다 적을 수 있습니다. 이 차이는 세그먼트에 비활성 엔드포인트나 캠페인에서 사용하지 않는 채널 유형의 엔드포인트가 포함된 경우 발생할 수 있습니다. 캠페인에 연결된 특정 채널에서 개별 캠페인에 대한 지표를 확인할 수 있습니다.

• 동적 세그먼트를 사용하는 경우 세그먼트를 내보내면 대상 세그먼트에 포함된 채널당 엔드포인트 수를 정확하게 계산하지 못할 수 있습니다. 이러한 세그먼트의 엔드포인트 데이터는 동적 세그먼트에 정의된 기준에 따라 시간이 지남에 따라 변경될 수 있습니다.

메시지 스로틀링

문제 및 해결 방법

• 다운스트림 메시지 전달 및 통신 사업자 서비스로 인한 제한

  • 캠페인이 실행된 CampaignSendMessageThrottled 기간 동안 Amazon CloudWatch 지표를 검토하여 이것이 문제인지 확인하세요. 자세한 정보는 CloudWatch에서 Amazon Pinpoint 지표 보기을 참조하세요.

  • 제한은 엔드포인트 배달률 용량이 초과될 때 발생합니다. 자세한 내용은 Amazon Pinpoint 할당량을 참조하세요.

수신자 시간대

문제 및 해결 방법

• true로 isLocalTime설정하여 수신자의 현지 시간을 사용하도록 캠페인을 예약하십시오.

  • 캠페인이 수신자의 현지 시간을 캠페인에 사용하도록 예약되면 모든 엔드포인트는 엔드포인트 정의에서 올바른 형식으로 지정된 Demographic.Timezone 속성 값을 가져야 합니다. 그렇지 않으면 엔드포인트가 성공적으로 대상 지정되지 않습니다. isLocalTime옵션은 각 수취인의 현지 시간대를 기준으로 배송 시간을 결정합니다.

처리 시간

문제 및 해결 방법

• 캠페인이 모든 엔드포인트를 처리할 시간이 충분하지 않습니다.

  • 캠페인이 모든 대상 지정된 엔드포인트를 처리할 시간이 충분하지 않은 경우 엔드포인트는 처리되지 않고 로그에는 EXPIRED의 campaign _send_status가 표시됩니다.

  • 캠페인이 대상 지정하는 엔드포인트 수를 기반으로 캠페인 실행의 최대 시간 및 초당 최대 메시지 수가 사용 사례 및 전송 채널에 따라 구성되어 있는지 확인하세요. 자세한 정보는 프로젝트의 기본 설정 편집을 참조하세요.

배송, 렌더링 또는 영구 실패

• 렌더링 문제를 포함한 다운스트림 전송 문제.

  • 다양한 엔드포인트 유형에 도달할 때 전송 문제가 발생할 수 있습니다. 실패 원인을 식별하는 데 도움이 되도록 로깅이 활성화되어 있는지 확인하세요. 다운스트림 전송 문제를 추가로 해결하려면 해당 엔드포인트 유형과 관련된 전송 문제를 참조하세요.

  • 메시지 템플릿을 사용하는데 템플릿 데이터가 누락된 경우, 템플릿 데이터의 형식이 잘못된 경우, 템플릿 매개 변수와 엔드포인트 데이터가 일치하지 않는 경우 렌더링 문제가 발생합니다. 자세한 내용은 전송 문제 아래의 이메일 섹션을 참조하세요.

• 영구 실패.

  • Amazon Pinpoint가 엔드포인트 주소에 도달하지 못할 경우 영구 실패가 발생합니다. 영구 오류의 이유가 로그에 표시됩니다. 영구 실패는 다시 시도되지 않습니다. 영구 실패의 예로는 이메일 주소나 전화번호 등 잘못된 주소, 권한 문제, 샌드박스에 있는 계정 또는 할당량 부족 등이 있습니다.