Sobre os estados de inscrição push

Estados de inscrição push

Um “estado de inscrição por push” na Braze identifica a preferência global de um usuário quanto ao desejo de receber notificações por push. Como o estado da inscrição é baseado no usuário, ele não é específico de nenhum app individual. Os estados de inscrição tornam-se sinalizadores úteis ao decidir quais usuários devem ser direcionados para notificações por push.

Nota

O estado da inscrição push de um usuário se aplica a todo o seu perfil de usuário, que inclui todos os dispositivos do usuário.

As seguintes opções de estado de inscrição existem: Subscribed, Opted-In e Unsubscribed.

Por padrão, para que seu usuário receba suas mensagens por push, o estado de inscrição por push deve ser Subscribed ou Opted-In, e ele deve ter o push em primeiro plano ativado. Você pode substituir essa configuração, se necessário, ao criar uma mensagem.

Importante

A Braze não altera automaticamente o estado da inscrição push de um usuário para Unsubscribed. Lembre-se de que, se o estado de inscrição por push de um usuário for Unsubscribed, então o filtro Foreground Push Enabled do usuário na segmentação é false.

Registro de push e usuários contatáveis

O estado de inscrição push reflete a preferência de um usuário, mas se ele conta como contatável para push no dashboard também depende do registro de push — ou seja, um token de push em primeiro plano válido no perfil. Para saber como a Braze calcula as contagens por canal, consulte Medir o tamanho do segmento.

• Campaigns e Canvas de push: Usuários que não estão registrados para push não são incluídos em Usuários contatáveis para push para Android ou push para iOS nas estatísticas de público, mesmo quando o estado de inscrição push é Subscribed ou Opted-In.
• Outros canais: Os mesmos usuários ainda podem contar como contatáveis para outros canais para os quais se qualificam (por exemplo, e-mail ou mensagens no app).
• Segments: A associação ao segmento segue seus filtros. Usuários sem registro de push permanecem no segmento, a menos que um filtro os exclua (por exemplo, Foreground Push Enabled). A associação total ao segmento pode ser maior do que a soma de usuários exibidos nas linhas de Usuários contatáveis específicas de push.

Um perfil de usuário pode exibir o estado de inscrição push Subscribed sem que nenhum token de push esteja atribuído. Esses usuários ainda não contam para Usuários contatáveis para push para Android ou push para iOS até que a Braze registre um token válido.

Para definições de filtros, consulte Filtros de segmentação.

Atualização dos estados de inscrição push

Veja a seguir as maneiras de atualizar o estado de inscrição por push de um usuário:

Aceitação automática (padrão)

Por padrão, a Braze define o estado da inscrição push de um usuário como Opted-In quando ele autoriza pela primeira vez as notificações por push para o seu app. A Braze também faz isso quando um usuário reativa as permissões push nas configurações do sistema após tê-las desativado anteriormente.

• android
• swift

1
<bool name="com_braze_optin_when_push_authorized">false</bool>

1
2
3
4
configuration.optInWhenPushAuthorized = false // disables the default behavior

let braze = Braze(configuration: configuration)
AppDelegate.braze = braze

Integração de SDK

Você pode atualizar o estado da inscrição de um usuário com o SDK da Braze usando o método setPushNotificationSubscriptionType na Web, Android ou iOS. Por exemplo, você pode usar esse método para criar uma página de configurações no seu app em que os usuários possam ativar ou desativar manualmente as notificações por push.

REST API

Você pode atualizar o estado de inscrição de um usuário com a REST API da Braze usando o endpoint /users/track para atualizar o atributo push_subscribe.

Diferenças entre ativação de push e estado de inscrição push

A ativação de push refere-se a se um usuário concedeu permissão em nível de sistema operacional ou navegador para receber notificações em um dispositivo específico. O estado de inscrição push é uma configuração em nível da Braze que representa a preferência global de um usuário para receber push em todo o seu perfil.

Quando a aceitação automática está ativada (o padrão), a Braze atualiza o estado de inscrição push de um usuário para Opted-In quando ele autoriza as notificações por push para o seu app ou reativa as permissões nas configurações do sistema (por exemplo, no iOS, Android 13+ e navegadores web compatíveis). Caso contrário, o estado de inscrição push do usuário permanece Subscribed até que você o altere explicitamente usando um método do SDK ou uma chamada à REST API.

A Braze não altera automaticamente o estado de inscrição push de um usuário para Unsubscribed quando ele desativa as notificações no nível do sistema operacional, navegador ou app. Para atualizar o estado de inscrição push de um usuário, você deve atualizá-lo na Braze. Por exemplo, se um usuário desativar o push em uma Central de Preferências no app, atualize o estado de inscrição push para Unsubscribed na Braze. A Braze não atualiza perfis de usuários com base na sua Central de Preferências. Para alinhar os estados de inscrição com as preferências do usuário no app, chame os métodos apropriados usando o SDK (iOS ou Android) ou a REST API.

Verificação do estado de inscrição push

Você pode verificar o estado de inscrição por push de um usuário com a Braze de qualquer uma das seguintes maneiras:

• Perfil do usuário: Você pode acessar perfis de usuários individuais por meio do dashboard da Braze na página Pesquisa de usuários. Depois de encontrar o perfil de um usuário (por meio de endereço de e-mail, número de telefone ou ID de usuário externo), é possível selecionar a guia Engagement para visualizar e ajustar manualmente o estado da inscrição de um usuário.
• Exportação da REST API: Você pode exportar perfis de usuários individuais em formato JSON usando os endpoints de exportação Usuários por segmento ou Usuários por identificador. A Braze retorna um objeto de tokens de push que contém informações de ativação de push por dispositivo.