Tag Push Permission Status

Push Permission Status é uma tag padrão que armazena o estado da permissão de notificações push em um dispositivo. Use-a para criar segmentos de alcance de usuários que um simples indicador ligado/desligado não consegue separar, por exemplo, usuários a quem você ainda pode pedir permissão e usuários que já recusaram.

Valores de Push Permission Status

A tag é do tipo String e armazena um dos valores abaixo para cada dispositivo em cada aplicativo. Cada plataforma informa apenas alguns deles. Consulte O que cada plataforma informa.

Valor	O que significa
`not_determined`	O usuário ainda não respondeu à solicitação de permissão, então o aplicativo ainda pode pedir
`granted_explicit`	O usuário permitiu as notificações na solicitação de permissão
`granted_default`	As notificações são permitidas, mas não por meio de uma resposta à solicitação de permissão do SDK do Pushwoosh. Somente Android
`provisional`	As notificações são permitidas provisoriamente. Elas chegam silenciosamente à Central de Notificações, sem alertas, sons ou banners. Somente iOS
`ephemeral`	As notificações são permitidas por tempo limitado, como em um App Clip. Somente iOS
`denied`	O usuário desativou as notificações, na solicitação ou depois, nas configurações do dispositivo ou do navegador
`unsupported`	O navegador não pode receber notificações push web. Somente Web

A tag não tem valor no tvOS e no macOS, nem em dispositivos com uma versão do SDK anterior a:

Plataforma	Versão mínima do SDK
iOS	7.2.10
Android	6.17.0
Web	3.95.0

Quando a tag é atualizada

O SDK informa o status atual nestes momentos:

Sempre que o aplicativo é aberto.
Quando o dispositivo se registra para receber notificações push.
Logo depois que o usuário responde à solicitação de permissão.

Se o usuário alterar a permissão nas configurações do dispositivo ou do navegador, a tag é atualizada mais tarde, dependendo da plataforma:

Plataforma	Quando a tag é atualizada
iOS	Na próxima vez que o aplicativo for aberto
Android	Na próxima vez que o aplicativo for aberto ou voltar ao primeiro plano
Web: navegadores baseados em Chromium e Firefox	Assim que o navegador informa a alteração
Web: Safari	No próximo carregamento da página

Quando uma solicitação chega sem status, por exemplo de uma versão mais antiga do SDK, a tag mantém o último valor.

O que cada plataforma informa

Cada plataforma lê a permissão da sua própria API de sistema, por isso o conjunto de valores varia de acordo com a plataforma.

iOS

O SDK do iOS mapeia o status de autorização do sistema do aplicativo diretamente para a tag.

Status de autorização do iOS	Push Permission Status
Not determined	`not_determined`
Authorized	`granted_explicit`
Provisional	`provisional`
Ephemeral	`ephemeral`
Denied	`denied`

Android

O Android 13 e versões posteriores exigem que o usuário permita as notificações em uma solicitação de permissão. Versões anteriores as permitem por padrão após a instalação, por isso o SDK do Android separa uma resposta explícita de uma concessão padrão:

granted_explicit: o usuário permitiu as notificações na solicitação de permissão exibida pelo SDK do Pushwoosh, no Android 13 ou posterior, em um aplicativo voltado para o Android 13 (nível de API 33) ou posterior.
granted_default: as notificações são permitidas de qualquer outra forma. Isso inclui o Android 12 e versões anteriores, aplicativos voltados para um nível de API inferior a 33, uma permissão que já estava concedida quando o SDK a verificou pela primeira vez e uma permissão concedida pela sua própria solicitação ou pelas configurações do sistema.
not_determined: no Android 13 e posterior, as notificações estão desativadas e o usuário ainda não respondeu à solicitação, inclusive quando fechou a solicitação sem escolher.
denied: as notificações estão desativadas depois que o usuário recusou a solicitação ou depois de terem sido permitidas anteriormente. No Android 12 e versões anteriores, qualquer dispositivo com as notificações desativadas informa denied.

Web

Os navegadores só permitem notificações depois que o usuário clica para permiti-las, então um dispositivo web nunca informa granted_default.

Permissão do navegador	Push Permission Status
Ainda não solicitada (`default`)	`not_determined`
Permitida (`granted`)	`granted_explicit`
Bloqueada (`denied`)	`denied`
O navegador não oferece suporte a push web	`unsupported`

Criar segmentos de alcance

Combine os valores em um único filtro Push Permission Status com o operador é um de para segmentar usuários de acordo com a forma como você pode alcançá-los. Saiba mais sobre como criar segmentos por tags.

Segmento	Filtro	Como usar
Usuários que veem alertas push	é um de `granted_explicit`, `granted_default`	Envie notificações push urgentes
Somente entrega silenciosa	é um de `provisional`, `ephemeral`	Espere menor visibilidade e convide esses usuários a permitir notificações completas
Usuários a quem você ainda pode pedir	é um de `not_determined`	Exibir um in-app antes da solicitação de permissão de push
Usuários que recusaram	é um de `denied`	Alcance-os por e-mail, SMS ou mensagens in-app, ou execute um pop-up de recuperação de opt-out
Navegadores sem push web	é um de `unsupported`	Use outros canais para esses usuários web

Para encontrar dispositivos que ainda não informam a tag, use o operador não definido. Esses dispositivos executam uma versão mais antiga do SDK, então segmente-os com Push Alerts Enabled. Para a diferença entre as duas tags, consulte Push Permission Status e Push Alerts Enabled.

Push Permission Status e Push Alerts Enabled

As duas tags respondem a perguntas diferentes:

Push Alerts Enabled (Boolean): este dispositivo pode exibir alertas push agora?
Push Permission Status (String): qual é o estado da permissão? Ela separa estados que Push Alerts Enabled informa como o mesmo false, como nunca solicitada e recusada.

A tabela compara como as duas tags informam estados comuns.

	Push Alerts Enabled	Push Permission Status
Tipo	Boolean	String
Permissão nunca solicitada	`false`	`not_determined`
Permissão recusada	`false`	`denied`
Permissão provisória ou temporária no iOS	Depende das configurações de alerta, som e badge	`provisional` ou `ephemeral`
Concessão explícita ou padrão	`true` quando o dispositivo exibe alertas	`granted_explicit` ou `granted_default`
Dispositivos com versões mais antigas do SDK	Informado em todas as versões do SDK	Não definido

Escolha a tag pela pergunta que você precisa responder:

Use Push Alerts Enabled para uma contagem rápida de usuários com opt-in em todas as versões do SDK.
Use Push Permission Status quando o próximo passo depender do motivo pelo qual um usuário não está acessível. Por exemplo, peça permissão aos usuários que nunca foram solicitados e deixe em paz os usuários que recusaram.