푸시 채널 문제 해결 - Amazon Pinpoint
전송 문제 모니터링메시지가 수신되지 않음메시지가 표시되지 않음

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

푸시 채널 문제 해결

실패 원인을 식별하는 데 도움이 되도록 로깅이 켜져 있는지 확인하세요. 자세한 내용은 모니터링 및 로깅을 참조하세요. 캠페인 또는 여정을 통해 전송되지 않는 트랜잭션 푸시 알림의 경우 API 응답을 로깅하여 전송 상태에 대해 알아봅니다.

전송 문제 모니터링

  • SendMessages API를 통해 전송되는 다이렉트 푸시 알림 메시지의 경우 전송에 대한 인사이트를 얻으려면 API 응답을 캡처해야 합니다. 이렇게 하려면 응답에서 EndpointResult 객체 내의 StatusMessage 속성을 검토하세요. 이 속성에는 다운스트림 푸시 알림 서비스에서 수신한 플랫폼 응답 코드가 포함됩니다.

  • 캠페인의 경우 Kinesis Data Streams를 통한 로깅이 켜져 있는지 확인하세요. Amazon Pinpoint가 다운스트림 푸시 알림 서비스로부터 수신한 전송 결과에 대해서는 _campaign.send 이벤트의 플랫폼 응답 코드를 검토하세요.

메시지가 수신되지 않음

문제 및 해결 방법

  • 디바이스 연결 문제 - 문제가 특정 디바이스에서만 발생하는 경우 해당 디바이스가 푸시 알림 서비스 엔드포인트에 연결할 수 없도록 차단되지 않았는지 확인하세요. FCM 포트 및 방화벽과 If your Apple devices aren't getting Apple push notifications를 참조하세요.

  • 엔드포인트 OptOut 속성 값 - 엔드포인트 OptOut 값이 ALL로 설정된 경우 엔드포인트는 알림을 수신하지 않습니다. get-endpoint CLI를 사용하여 엔드포인트 OptOut 값이 NONE으로 설정되었는지 확인합니다. 엔드포인트가 옵트아웃되면 캠페인 또는 여정을 통해 전송된 메시지가 엔드포인트로 전달되지 않고 로그도 생성되지 않습니다.

  • 토큰 환경 - Amazon Pinpoint 엔드포인트의 채널 유형이 디바이스용으로 생성된 토큰과 일치하는지 확인합니다. 예를 들어 FCM 통합 기능이 있는 앱 토큰 주소의 채널로 GCM을 사용하고, APNs의 경우 샌드박스에 있는 앱에 APNS_Sandbox를, 프로덕션에 있는 앱에 APNS를 채널로 사용합니다.

    전송 시도 실패 상태에 대한 인사이트는 전송 시도에 사용된 각 푸시 채널의 푸시 알림 응답 코드를 참조하세요.

메시지가 표시되지 않음

  • 로그에 전송 성공이 표시되고 메시지가 시스템 알림 트레이에 표시되지 않으면 알림이 디바이스에 전달되지만 클라이언트 애플리케이션에서 적절하게 처리되지 않는 문제를 나타냅니다.

  • Kinesis 이벤트 로그에 전송 성공 상태가 표시되거나 특정 요청 페이로드 또는 메시지 유형에서만 문제가 발생하는 것을 볼 수 있습니다. 이 문제는 알림이 디바이스에 전송되고 있지만 시스템 알림 트레이에 표시되지 않음을 나타낼 수 있습니다.

    이는 특정 요청 페이로드 또는 메시지 유형(예: FCM용 데이터, Silent for APN)에서 발생할 수 있습니다. 예를 들어, 메시지가 경고/알림 페이로드로는 수신되지만 데이터/자동 페이로드로는 수신되지 않는 경우, 애플리케이션에서 데이터, 알림, 경고 또는 백그라운드 등의 메시지 유형을 수신했을 때 의도한 작업이 무엇인지, 애플리케이션이 다양한 메시지 유형을 처리할 수 있는지 확인합니다.

  • 문제를 해결하려면 앱의 메시지 핸들러에 로그 문을 통합하세요. 예를 들어 FCM 및 APNs를 참조하세요. 이 작업을 통해 디바이스가 알림을 수신하지만 시스템 알림 트레이에는 표시되지 않는지 확인할 수 있습니다.