Push Permission Status 태그

Push Permission Status는 기기의 푸시 알림 권한 상태를 저장하는 기본 태그입니다. 단순한 켜짐/꺼짐 플래그로는 구분할 수 없는 사용자의 도달 가능성 세그먼트를 만드는 데 사용합니다. 예를 들어 아직 권한을 요청할 수 있는 사용자와 이미 거부한 사용자를 나눌 수 있습니다.

Push Permission Status 값

이 태그는 String 태그이며 각 애플리케이션의 각 기기마다 아래 값 중 하나를 저장합니다. 플랫폼마다 그중 일부만 보고합니다. 플랫폼별 보고 값을 참조하세요.

값	의미
`not_determined`	사용자가 아직 권한 프롬프트에 응답하지 않았으므로 앱에서 여전히 요청할 수 있습니다
`granted_explicit`	사용자가 권한 프롬프트에서 알림을 허용했습니다
`granted_default`	알림이 허용되었지만 Pushwoosh SDK 권한 프롬프트에 대한 응답을 통해서는 아닙니다. Android 전용
`provisional`	알림이 임시로 허용되었습니다. 알림은 경고, 소리, 배너 없이 알림 센터로 조용히 전달됩니다. iOS 전용
`ephemeral`	App Clip처럼 제한된 시간 동안 알림이 허용되었습니다. iOS 전용
`denied`	사용자가 프롬프트에서 또는 나중에 기기나 브라우저 설정에서 알림을 껐습니다
`unsupported`	브라우저가 웹 푸시 알림을 받을 수 없습니다. Web 전용

tvOS와 macOS, 그리고 SDK 버전이 다음보다 오래된 기기에서는 이 태그에 값이 없습니다.

플랫폼	최소 SDK 버전
iOS	7.2.10
Android	6.17.0
Web	3.95.0

태그가 업데이트되는 시점

SDK는 다음 시점에 현재 상태를 보고합니다.

앱이 열릴 때마다.
기기가 푸시 알림을 위해 등록될 때.
사용자가 권한 프롬프트에 응답한 직후.

사용자가 기기나 브라우저 설정에서 권한을 변경하면 태그는 플랫폼에 따라 나중에 업데이트됩니다.

플랫폼	태그가 업데이트되는 시점
iOS	다음에 앱이 열릴 때
Android	다음에 앱이 열리거나 포그라운드로 돌아올 때
Web: Chromium 기반 브라우저 및 Firefox	브라우저가 변경을 보고하는 즉시
Web: Safari	다음 페이지 로드 시

예를 들어 이전 SDK 버전에서 상태 없이 요청이 들어오면 태그는 마지막 값을 유지합니다.

플랫폼별 보고 값

각 플랫폼은 자체 시스템 API에서 권한을 읽으므로 값의 집합은 플랫폼마다 다릅니다.

iOS

iOS SDK는 앱의 시스템 권한 부여 상태를 태그에 그대로 매핑합니다.

iOS 권한 부여 상태	Push Permission Status
Not determined	`not_determined`
Authorized	`granted_explicit`
Provisional	`provisional`
Ephemeral	`ephemeral`
Denied	`denied`

Android

Android 13 이상에서는 사용자가 권한 프롬프트에서 알림을 허용해야 합니다. 이전 버전에서는 설치 후 기본적으로 알림이 허용되므로 Android SDK는 명시적 응답과 기본 허용을 구분합니다.

granted_explicit: Android 13 이상에서 Android 13(API 레벨 33) 이상을 대상으로 하는 앱의 경우, 사용자가 Pushwoosh SDK가 표시하는 권한 프롬프트에서 알림을 허용했습니다.
granted_default: 그 밖의 방식으로 알림이 허용되었습니다. 여기에는 Android 12 이하, API 레벨 33 미만을 대상으로 하는 앱, SDK가 처음 확인했을 때 이미 허용되어 있던 권한, 자체 프롬프트나 시스템 설정에서 허용된 권한이 포함됩니다.
not_determined: Android 13 이상에서 알림이 꺼져 있고 사용자가 아직 프롬프트에 응답하지 않았습니다. 선택하지 않고 프롬프트를 닫은 경우도 포함됩니다.
denied: 사용자가 프롬프트를 거부한 후 또는 이전에 허용했다가 알림이 꺼졌습니다. Android 12 이하에서는 알림이 꺼진 모든 기기가 denied를 보고합니다.

Web

브라우저는 사용자가 클릭하여 허용한 후에만 알림을 허용하므로 웹 기기는 granted_default를 보고하지 않습니다.

브라우저 권한	Push Permission Status
아직 요청하지 않음(`default`)	`not_determined`
허용됨(`granted`)	`granted_explicit`
차단됨(`denied`)	`denied`
브라우저가 웹 푸시를 지원하지 않음	`unsupported`

도달 가능성 세그먼트 만들기

하나의 Push Permission Status 필터에서 다음 중 하나 연산자로 값을 조합하여 도달 방법에 따라 사용자를 타겟팅합니다. 태그별 세그먼트 구축에 대해 자세히 알아보기.

세그먼트	필터	사용 방법
푸시 경고를 보는 사용자	다음 중 하나 `granted_explicit`, `granted_default`	시간이 중요한 푸시 알림을 보냅니다
조용한 전달만 가능	다음 중 하나 `provisional`, `ephemeral`	노출이 낮을 것으로 예상하고 이 사용자에게 전체 알림 허용을 요청합니다
아직 요청할 수 있는 사용자	다음 중 하나 `not_determined`	푸시 권한 프롬프트 전에 인앱 표시하기
거부한 사용자	다음 중 하나 `denied`	이메일, SMS 또는 인앱 메시지로 도달하거나 옵트아웃 복구 팝업을 실행합니다
웹 푸시를 지원하지 않는 브라우저	다음 중 하나 `unsupported`	이 웹 사용자에게는 다른 채널을 사용합니다

아직 태그를 보고하지 않는 기기를 찾으려면 설정되지 않음 연산자를 사용하세요. 이러한 기기는 이전 SDK 버전을 실행하므로 대신 Push Alerts Enabled로 타겟팅하세요. 두 태그의 차이는 Push Permission Status와 Push Alerts Enabled를 참조하세요.

Push Permission Status와 Push Alerts Enabled

두 태그는 서로 다른 질문에 답합니다.

Push Alerts Enabled(Boolean): 이 기기가 지금 푸시 경고를 표시할 수 있는가?
Push Permission Status(String): 권한의 상태는 무엇인가? Push Alerts Enabled가 똑같이 false로 보고하는 상태, 예를 들어 한 번도 요청하지 않음과 거부함을 구분합니다.

아래 표는 두 태그가 일반적인 상태를 어떻게 보고하는지 비교합니다.

	Push Alerts Enabled	Push Permission Status
유형	Boolean	String
권한을 한 번도 요청하지 않음	`false`	`not_determined`
권한을 거부함	`false`	`denied`
iOS의 임시 또는 일시적 권한	경고, 소리, 배지 설정에 따라 다름	`provisional` 또는 `ephemeral`
명시적 또는 기본 허용	기기가 경고를 표시하면 `true`	`granted_explicit` 또는 `granted_default`
이전 SDK 버전의 기기	모든 SDK 버전에서 보고됨	설정되지 않음

답해야 하는 질문에 따라 태그를 선택하세요.

모든 SDK 버전에 걸쳐 옵트인 수를 빠르게 확인하려면 Push Alerts Enabled를 사용하세요.
사용자에게 도달할 수 없는 이유에 따라 다음 단계가 달라진다면 Push Permission Status를 사용하세요. 예를 들어 한 번도 요청받지 않은 사용자에게는 요청하고 거부한 사용자는 그대로 둡니다.