**지원 종료 공지:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Pinpoint 푸시 알림
**참고**
Amazon Pinpoint는 사용 설명서 문서를 업데이트했습니다. 푸시 리소스를 생성, 구성 및 관리하는 방법에 대한 최신 정보는 새로운 [AWS End User Messaging Push 사용 설명서](https://docs.aws.amazon.com//push-notifications/latest/userguide/what-is-service.html)를 참조하세요.
다음 주제가 이동되었습니다.
[Amazon Pinpoint 모바일 푸시 채널 설정](https://docs.aws.amazon.com//push-notifications/latest/userguide/procedure-enable-push.html)
[푸시 알림 활동 모니터링](analytics-campaigns.md)
푸시 알림 활동을 모니터링하려면 캠페인을 사용해야 합니다. 캠페인 외부의 푸시 알림 활동은 모니터링할 수 없습니다.
[모바일 푸시 채널 관리](https://docs.aws.amazon.com//push-notifications/latest/userguide/procedure-enable-push.html)
[Safari 웹 푸시 알림 보내기](https://docs.aws.amazon.com//push-notifications/latest/userguide/reference-send-message.html)
[모범 사례](https://docs.aws.amazon.com//push-notifications/latest/userguide/channels-push-best-practices.html)
Amazon Pinpoint를 사용하면 푸시 알림 채널을 통해 푸시 알림을 전송하여 앱 사용자와 소통할 수 있습니다. 다음 푸시 알림 서비스에 대해 별도의 채널을 사용하여 앱에 푸시 알림을 보낼 수 있습니다.
+ Firebase Cloud Messaging(FCM)
+ Apple Push Notification service(APNs)
**참고**
APNs를 사용하여 iPhone 및 iPad 같은 iOS 디바이스뿐 아니라 Mac 랩톱 및 데스크톱 같은 macOS 디바이스의 Safari 브라우저에도 메시지를 보낼 수 있습니다.
+ Baidu 클라우드 푸시
+ Amazon Device Messaging(ADM)
**참고**
Amazon Pinpoint는 한 사용자에게 15개의 엔드포인트가 있고 여기에 푸시 엔드포인트를 더 추가하는 경우 **EffectiveDate**가 가장 오래된 푸시 엔드포인트를 `INACTIVE`로 설정합니다. 자세한 내용은 [오래된 푸시 엔드포인트가 자동으로 비활성으로 설정됨](https://docs.aws.amazon.com/pinpoint/latest/developerguide/audience-define-auto-inactive.html)을 참조하세요.
**Topics**
+ [
# 푸시 채널 문제 해결
](channels-push-troubleshooting.md)
# 푸시 채널 문제 해결
실패 원인을 식별하는 데 도움이 되도록 로깅이 켜져 있는지 확인하세요. 자세한 내용은 [모니터링 및 로깅](troubleshooting.md#troubleshooting-logging)을 참조하세요. 캠페인 또는 여정을 통해 전송되지 않는 트랜잭션 푸시 알림의 경우 [API 응답을](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams.html) 로깅하여 [전송 상태](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#apps-application-id-messages-model-messageresult)에 대해 알아봅니다.
## 전송 문제 모니터링
+ SendMessages API를 통해 전송되는 다이렉트 푸시 알림 메시지의 경우 전송에 대한 인사이트를 얻으려면 API 응답을 캡처해야 합니다. 이렇게 하려면 응답에서 [EndpointResult](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#apps-application-id-messages-model-messageresponse) 객체 내의 StatusMessage 속성을 검토하세요. 이 속성에는 다운스트림 푸시 알림 서비스에서 수신한 [플랫폼 응답 코드](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)가 포함됩니다.
+ 캠페인의 경우 Kinesis Data Streams를 통한 로깅이 켜져 있는지 확인하세요. Amazon Pinpoint가 다운스트림 푸시 알림 서비스로부터 수신한 전송 결과에 대해서는 [\$1campaign.send](https://docs.aws.amazon.com/pinpoint/latest/developerguide/event-streams-data-campaign.html#event-streams-data-campaign-attributes) 이벤트의 [플랫폼 응답 코드](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)를 검토하세요.
## 메시지가 수신되지 않음
****문제 및 해결 방법****
+ 디바이스 연결 문제 - 문제가 특정 디바이스에서만 발생하는 경우 해당 디바이스가 푸시 알림 서비스 엔드포인트에 연결할 수 없도록 차단되지 않았는지 확인하세요. [FCM 포트 및 방화벽](https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall)과 [If your Apple devices aren't getting Apple push notifications](https://support.apple.com/en-us/102266)를 참조하세요.
+ 엔드포인트 **OptOut** 속성 값 - 엔드포인트 **OptOut** 값이 `ALL`로 설정된 경우 엔드포인트는 알림을 수신하지 않습니다. [get-endpoint CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/get-endpoint.html)를 사용하여 엔드포인트 **OptOut** 값이 `NONE`으로 설정되었는지 확인합니다. 엔드포인트가 옵트아웃되면 캠페인 또는 여정을 통해 전송된 메시지가 엔드포인트로 전달되지 않고 로그도 생성되지 않습니다.
+ 토큰 환경 - Amazon Pinpoint 엔드포인트의 채널 유형이 디바이스용으로 생성된 토큰과 일치하는지 확인합니다. 예를 들어 FCM 통합 기능이 있는 앱 토큰 주소의 채널로 GCM을 사용하고, APNs의 경우 샌드박스에 있는 앱에 APNS\$1Sandbox를, 프로덕션에 있는 앱에 APNS를 채널로 사용합니다.
전송 시도 실패 상태에 대한 인사이트는 전송 시도에 사용된 [각 푸시 채널의 푸시 알림 응답 코드](https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html#platform-returncodes)를 참조하세요.
## 메시지가 표시되지 않음
+ 로그에 전송 성공이 표시되고 메시지가 시스템 알림 트레이에 표시되지 않으면 알림이 디바이스에 전달되지만 클라이언트 애플리케이션에서 적절하게 처리되지 않는 문제를 나타냅니다.
+ Kinesis 이벤트 로그에 **전송 성공** 상태가 표시되거나 특정 요청 페이로드 또는 메시지 유형에서만 문제가 발생하는 것을 볼 수 있습니다. 이 문제는 알림이 디바이스에 전송되고 있지만 시스템 알림 트레이에 표시되지 않음을 나타낼 수 있습니다.
이는 특정 요청 페이로드 또는 메시지 유형(예: FCM용 데이터, Silent for APN)에서 발생할 수 있습니다. 예를 들어, 메시지가 경고/알림 페이로드로는 수신되지만 데이터/자동 페이로드로는 수신되지 않는 경우, 애플리케이션에서 데이터, 알림, 경고 또는 백그라운드 등의 메시지 유형을 수신했을 때 의도한 작업이 무엇인지, 애플리케이션이 다양한 메시지 유형을 처리할 수 있는지 확인합니다.
+ 문제를 해결하려면 앱의 메시지 핸들러에 로그 문을 통합하세요. 예를 들어 [FCM](https://firebase.google.com/docs/cloud-messaging/android/receive) 및 [APNs](https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1623013-application)를 참조하세요. 이 작업을 통해 디바이스가 알림을 수신하지만 시스템 알림 트레이에는 표시되지 않는지 확인할 수 있습니다.