푸시 알림 전달에 대해 알아보세요. 여기에는 알림이 전달되는 방식과 전달이 실패할 수 있는 이유가 포함돼요.

푸시 알림 전달

Klaviyo는 Apple 또는 Google의 푸시 알림 서비스가 표준 푸시 알림의 전송을 승인하면 푸시 수신 이벤트를 기록해요. 이는 알림이 수신자의 기기에 도달했는지는 확인해 주지 않아요.

모바일 앱이 여러 기기에 설치되어 있으면 프로필에 푸시 토큰이 1개 이상 있을 수 있어요. 기본적으로 Klaviyo는 조건에 해당하는 모든 기기로 전송을 시도해요. 푸시 전송에서 둘 다, iOS 또는 Android를 선택하고 모든 기기 또는 기본 기기 (프로필당 1개 기기)를 선택할 수 있어요. 기본 기기를 선택했는데 해당 기기가 선택한 플랫폼과 일치하지 않으면, 해당 프로필은 건너뛰어요.

푸시 알림에는 이메일 받은편지함이나 스팸 폴더 배치가 없기 때문에 이메일과 달리 전송 가능성 이라는 개념이 적용되지 않아요. 기기의 알림 설정은 알림이 언제, 어떻게 표시되는지에도 여전히 영향을 줄 수 있어요.

캠페인 또는 플로우를 통해 푸시 알림을 보내면 Klaviyo가 푸시 알림을 확인한 다음 iOS의 Apple Push Notification Service(APNs) 또는 Android의 푸시 알림 서비스인 Firebase Cloud Messaging(FCM)으로 전송해 수신자의 기기에서 전달되도록 해요. 예를 들어, 프로필에 푸시 토큰이 없거나 표준 푸시 알림 권한을 거부한 경우처럼 알림이 이러한 서비스에 도달하기 전에 건너뛸 수 있어요.

APNs와 FCM은 알림을 수락하고 수신자의 기기에 전달을 시도하거나, 가능한 여러 오류 중 하나로 알림을 거부할 수 있어요.

Klaviyo는 이러한 서비스가 알림을 수락하는지 또는 거부하는지 여부에 대해서만 인사이트를 갖고 있어요. Klaviyo는 APNs 또는 FCM이 푸시를 수락한 후 알림이 실패했는지 여부를 확인할 수 없어요.

Klaviyo 푸시 알림에 대한 기능을 요청하고 싶으신가요? 이 Google 양식을 작성해 알려 주세요!

거부 사유

Klaviyo에서 알림을 보낸 후 APNs 또는 FCM에서 오류 응답을 받으면, 전송 실패로 영향을 받은 각 토큰에 대해 Bounced Push 라는 이벤트가 생성돼요. 이는 알림이 전송된 해당 플로우 또는 캠페인의 수신자 활동과 함께, 수신 프로필의 활동 피드에 표시돼요.

Bounced Push 이벤트에는 APNs 또는 Firebase에서 반환된 오류 코드 메시지(예: ExpiredToken)를 보여주는 메타데이터가 포함돼요. 전송 문제가 발생한다면 앱 개발자와 함께 이벤트에 있는 설명을 바탕으로 오류를 해결해 주세요.

이벤트의 메타데이터를 보려면 프로필 활동 로그에서 이벤트 메뉴를 열고 활동 세부 정보를 선택해 주세요.

무음 푸시

개별 무음 푸시 알림의 전송률과 반송률을 확인할 수 있어요. 무음 푸시 알림은 별도의 전송 및 반송 지표를 사용하며, 표준 푸시 성과 보고에 오픈 또는 어트리뷰션된 전환이 포함되지 않아요. 또한 다중 메트릭 보고서에서 무음 푸시 지표를 선택할 수도 있어요.

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가 APNs 또는 FCM에 연결하기 전에 건너뜁니다. 서비스가 유효하지 않거나 만료된 토큰을 거부하면, Klaviyo는 반송된 푸시 이벤트를 기록합니다. 사용자가 앱을 삭제하면 토큰이 유효하지 않게 될 수 있어요. Klaviyo는 서비스에서 미등록 또는 만료로 보고된 토큰을 삭제합니다.

모범 사례

사용자 동의 수집

프로필에 표준 푸시 알림을 보내려면 먼저 명시적 동의 를 수집해야 해요.

푸시 알림 수신 동의를 받으려면 앱의 기본 권한 요청 프롬프트를 통해 고객이 알림을 활성화하도록 안내해 주세요. 고객이 왜 알림을 받게 되는지 이해할 수 있는 시점을 선택해 주세요.

앱에서 명확한 동의 문구를 사용하고, 고객이 푸시 알림을 활성화할지 여부를 선택할 수 있도록 하는 것이 모범 사례예요. 다음을 설명해 주세요:

  • 브랜드에서 보내는 알림 유형
    브랜드에서 보낼 예정인 다양한 푸시 알림에 대한 세부 정보를 포함해 주세요(예: 계정 변경, 리마인더, 특별 할인).
  • 사용자가 옵트인해야 하는 이유
    고객이 권한을 제공해야 하는 이유에 대한 정보를 포함해 주세요(예: 중요한 업데이트를 받거나 세일을 먼저 이용하기 위해).

푸시 알림 수신 동의를 수집하는 방법에 대해 자세히 알아보세요.

관련성 높은 알림 보내기

푸시 알림 캠페인을 보낼 때는 Klaviyo의 세분화를 활용해 구독자에게 개인화되고 관련성 높은 콘텐츠를 보내는 것이 중요해요.

예를 들어, 충성도 높은 재구매 고객 세그먼트가 있다는 것을 알고 있다면 푸시 알림을 사용해 다른 누구보다 먼저 새로운 딜이나 프로모션을 알려줄 수 있어요.

고객에게 전송하는 콘텐츠가 고객의 관심사와 선호도에 맞도록 하면 고객이 수신 거부할 가능성을 줄이고, 푸시 알림으로 고객에게 도달할 수 있는 역량을 극대화할 수 있어요.

성과를 모니터링하고 분석하기

Klaviyo에서 푸시 알림 성과를 지속적으로 모니터링하면, 전송 문제와 주요 푸시 지표의 하락을 빠르게 파악할 수 있어요.

가장 좋은 방법은 다음 푸시 알림 이벤트를 모니터링하는 거예요:

  • 푸시 수신
  • 열람한 푸시
  • 반송된 푸시

Klaviyo에서 다중 메트릭 보고서를 설정해 시간이 지남에 따라 이러한 이벤트의 성과가 어떻게 변하는지 모니터링할 수 있어요.

추가 자료

  • 푸시 알림 동의 이해하기

    푸시 알림 동의와 규정 준수를 위한 모범 사례를 알아보세요. 이 가이드는 동의 수집 방식에서 규정을 준수하고 고객과의 긍정적인 관계를 유지하는 데 도움이 돼요.

  • 푸시 알림 설정 이해하기

    모바일 앱의 푸시 알림을 설정하고 스마트 전송 창을 조정할 수 있는 푸시 알림 설정 페이지에 대해 알아보세요.

이 도움말 문서가 유용했나요?
이 형식은 도움말 문서 피드백 용도로만 사용하세요. 지원 팀에 문의하는 방법.

Klaviyo에서 자세히 살펴보기

커뮤니티
동료, 파트너, Klaviyo 전문가와 연결되어 영감을 받고 인사이트를 공유하며, 모든 궁금한 사항에 대해 답을 얻으세요.
파트너
특정 작업을 도와주거나 지속적인 마케팅 관리를 위해 Klaviyo 인증 전문가를 고용하세요.
지원

계정을 통해 지원에 액세스하세요.

이메일 지원 (무료 체험 및 유료 계정) 연중무휴 24시간 사용 가능

채팅/가상 비서
사용 가능 여부는 위치 및 요금제 유형에 따라 다름