푸시 알림 전송 이해하기
푸시 알림 전달에 대해 알아보세요. 여기에는 전달 방식과 전달이 실패할 수 있는 이유가 포함됩니다.
푸시 알림 전달
푸시 알림 전달은 푸시 알림이 수신자의 장치로 성공적으로 전달된 경우를 나타냅니다.
프로필에는 여러 기기에 모바일 앱이 설치되어 있으면 푸시 토큰이 1개보다 많을 수 있어요. 프로필에 토큰이 저장된 모든 기기를 대상으로 푸시 알림을 시도해요.
전송 가능성 이라는 개념은 수신자의 기기에서 알림을 성공적으로 수신한 뒤에는 정렬이 수행되지 않기 때문에 이메일과 달리 푸시 알림에는 적용되지 않아요.
캠페인 또는 플로우를 통해 푸시 알림을 보내면, Klaviyo가 푸시를 확인한 다음 iOS의 경우 Apple Push Notification Service(APNs)로, Android의 경우 수신자 기기에 전달하기 위해 Android의 푸시 알림 서비스인 Firebase Cloud Messaging(FCM)으로 전송해요. 전송에 문제가 있으면 일부 푸시 알림이 건너뛰어질 수 있어요.
APNs와 FCM은 알림을 수락하고 수신자의 기기에 전달을 시도하거나, 가능한 여러 오류 중 하나로 알림을 거부할 수 있어요.
Klaviyo는 이러한 서비스가 알림을 수락하는지 또는 거부하는지 여부에 대해서만 인사이트를 갖고 있어요. Klaviyo는 APNs 또는 FCM이 푸시를 수락한 후 알림이 실패했는지 여부를 확인할 수 없어요.
Klaviyo 푸시 알림에 대한 기능을 요청하고 싶으신가요? 이 Google 양식을 작성해 알려 주세요!
거부 사유
Klaviyo에서 알림을 전송한 후 APNs 또는 FCM에서 오류 응답을 받으면, 전송 실패의 영향을 받은 각 토큰에 대해 반송된 푸시 라는 이벤트가 생성돼요. 이는 알림이 전송된 해당 플로우 또는 캠페인의 수신자 활동과 함께, 수신 프로필의 활동 피드에 표시돼요.
반송된 푸시 이벤트에는 APNs 또는 Firebase에서 반환된 오류 코드 메시지(예: ExpiredToken)를 보여주는 메타데이터가 포함돼요. 전송 문제를 확인하고 있다면 앱 개발자와 함께 이벤트에 있는 설명을 바탕으로 오류를 해결해 주세요.
이벤트의 메타데이터를 보려면 프로필의 활동 로그에서 해당 이벤트의 활동 세부 정보를 클릭해 주세요.
무음 푸시
개별 무음 푸시 알림의 전송률과 반송률은 확인할 수 있지만, 무음 푸시 알림은 Klaviyo의 모든 집계 성과 보고에서 제외돼요. 여기에는 시간이 지남에 따른 모바일 푸시 이메일 열람률 같은 항목이 포함되는데, 무음 푸시 알림에는 열람 또는 전환이 없기 때문이에요.
silent push와 standard push에는 서로 다른 이벤트가 표시되며, 구체적으로는 Received Silent Push 및 Bounced Silent Push가 표시됩니다.
iOS에서 무음 푸시 알림이 전달되는 데 문제가 있다면, iOS에서는 무음 푸시 알림의 전달이 보장되지 않는다는 점을 참고해 주세요. 배터리 수준과 네트워크 연결 같은 기기의 현재 상태에 따라 전달되지 않을 수 있어요.
iOS
APNs를 통해 전송된 iOS 푸시 알림의 경우 Apple의 APNs의 알림 응답 처리 참조에 나열된 이유 중 하나 이상으로 인해 거부될 수 있어요.
상태 코드 | APNs 오류 스트링 | APNs 설명 |
400 | BadDeviceToken | 지정된 디바이스 토큰이 올바르지 않았어요. 요청에 유효한 토큰이 포함되어 있고 해당 토큰이 환경과 일치하는지 확인해 주세요. |
400 | BadTopic | apns-topic 값이 유효하지 않습니다. |
400 | DeviceTokenNotForTopic | 디바이스 토큰이 지정된 토픽과 일치하지 않습니다. |
400 | 중복 헤더 | 하나 이상의 헤더가 반복되었습니다. |
400 | IdleTimeout | 유휴 시간 초과. |
400 | InvalidPushType | apns-push-type 값이 유효하지 않습니다. |
400 | PayloadEmpty | 메시지 페이로드가 비어 있어요. |
403 | BadCertificate | 인증서가 올바르지 않았어요. |
403 | 불량 인증서 환경 | 클라이언트 인증서가 잘못된 환경용이었어요. |
403 | 잘못된 공급자 토큰 | 제공업체 토큰이 유효하지 않거나 토큰 서명을 확인할 수 없습니다. |
404 | 잘못된 경로 | 요청에 잘못된 :path 값이 포함되어 있었어요. |
405 | 허용되지 않는 메서드 | 지정된 :method가 POST가 아니었습니다. |
410 | 만료된 토큰 | 디바이스 토큰이 만료되었습니다. |
410 | 등록되지 않음 | 지정된 토픽의 기기 토큰이 비활성 상태예요. |
429 | TooManyProviderTokenUpdates | 제공업체 토큰이 너무 자주 업데이트되고 있어요. |
500 | InternalServerError | 내부 서버 오류가 발생했습니다. |
503 | ServiceUnavailable | 서비스를 사용할 수 없습니다. |
Android
FCM을 통해 전송된 Android 푸시 알림의 경우 Google의 FCM 오류 코드참고 자료에 나열된 이유 중 하나 이상으로 거부될 수 있어요.
상태 코드 | FCM 오류 스트링 | FCM 설명 |
400 | INVALID_ARGUMENT | 서버에 전달하는 등록 토큰의 형식을 확인해 주세요. Firebase Notifications에 등록할 때 클라이언트 앱이 받는 등록 토큰과 일치하는지 확인해 주세요. 토큰을 잘라내거나 추가 문자를 넣지 마세요. |
400 | INVALID_ARGUMENT | 요청에서 전달된 값과 일치하는 패키지 이름을 가진 등록 토큰으로 메시지가 전송되었는지 확인해 주세요. |
400 | INVALID_ARGUMENT | 메시지에 포함된 페이로드 데이터의 총 크기가 FCM 제한을 초과하지 않는지 확인해 주세요. 대부분의 메시지는 4,096바이트, 토픽으로 보내는 메시지는 2,048바이트예요. 여기에는 키와 값이 모두 포함돼요. |
400 | INVALID_ARGUMENT | 페이로드 데이터에 FCM에서 내부적으로 사용하는 키(예: from, gcm 또는 google로 시작하는 모든 값)가 포함되어 있지 않은지 확인해 주세요. collapse_key 같은 일부 단어는 FCM에서도 사용되지만 페이로드에 허용되며, 이 경우 페이로드 값이 FCM 값으로 덮어써져요. |
400 | INVALID_ARGUMENT | ttl에 사용된 값이 0~2,419,200(4주) 사이의 초 단위 기간을 나타내는 정수인지 확인해 주세요. |
400 | INVALID_ARGUMENT | 제공된 매개변수의 이름과 유형이 올바른지 확인해 주세요. |
403 | SENDER_ID_MISMATCH | 인증된 발신자 ID는 등록 토큰의 발신자 ID와 달라요. |
404 | 등록되지 않음 | 앱 인스턴스가 FCM에서 등록 해제되었습니다. 이는 일반적으로 사용 중인 토큰이 더 이상 유효하지 않으며 새 토큰을 사용해야 한다는 뜻이에요. |
429 | QUOTA_EXCEEDED | 메시지 대상에 대한 전송 한도를 초과했어요. 초과된 할당량을 지정하기 위해 google.rpc.QuotaFailure 유형의 확장이 반환돼요. |
500 | 내부용 | 알 수 없는 내부 오류가 발생했습니다. |
503 | 비활성 | 서버에 과부하가 걸렸어요. |
수신자가 누락되었거나 유효하지 않은 푸시 토큰이 있는 경우 반송된 푸시 이벤트도 표시돼요.
모범 사례
사용자 동의 수집
프로필에 표준 푸시 알림을 보내려면 먼저 명시적 동의 를 수집해야 해요.
푸시 알림 동의를 수집하려면 모바일 앱과의 첫 상호작용 시 고객에게 권한 요청 화면 프롬프트를 제공해야 해요.
권한 화면 프롬프트에는 다음 정보를 제공하고 옵트인이나 옵트아웃을 허용하는 동의 언어가 포함되는 것이 가장 좋습니다.
- 브랜드에서 발송하는 알림 유형
브랜드에서 발송할 계획인 다양한 푸시 알림에 대한 세부 정보를 포함해 주세요(예: 계정 변경, 계정 변경, 리마인더, 특별 할인). - 사용자가 옵트인해야 하는 이유
고객이 권한을 제공해야 하는 이유에 대한 정보를 포함해 주세요(예: 중요한 업데이트를 받거나 세일을 먼저 이용하기 위해).
푸시 알림 수신 동의를 수집하는 방법에 대해 자세히 알아보세요.
관련성 높은 알림 보내기
푸시 알림 캠페인을 보낼 때는 Klaviyo의 세분화를 활용해 구독자에게 개인화되고 관련성 높은 콘텐츠를 보내는 것이 중요해요.
예를 들어, 충성도 높은 재구매 고객 세그먼트가 있다는 것을 알고 있다면 푸시 알림을 사용해 다른 누구보다 먼저 새로운 딜이나 프로모션을 알려줄 수 있어요.
고객에게 전송하는 콘텐츠가 고객의 관심사와 선호도에 맞도록 하면 고객이 수신 거부할 가능성을 줄이고, 푸시 알림으로 고객에게 도달할 수 있는 역량을 극대화할 수 있어요.
성과를 모니터링하고 분석하기
Klaviyo에서 푸시 알림 성과를 지속적으로 모니터링하면, 전송 문제와 주요 푸시 지표의 하락을 빠르게 파악할 수 있어요.
가장 좋은 방법은 다음 푸시 알림 이벤트를 모니터링하는 거예요:
- 푸시 수신
- 열람한 푸시
- 반송된 푸시
Klaviyo에서 다중 메트릭 보고서를 설정해 시간이 지남에 따라 이러한 이벤트의 성과가 어떻게 변하는지 모니터링할 수 있어요.