Habilitação de push e assinatura de push

Este artigo de referência cobre os conceitos de habilitação de push e estados de assinatura de push no Braze, incluindo as diferenças fundamentais de comportamento entre iOS, Android e Web.

Estados de assinatura de push

Um “Estado de Assinatura de Push” no Braze identifica a preferência global do usuário para receber notificações push. Como o estado de assinatura é baseado no usuário, não é específico para nenhum aplicativo individual. Os estados de assinatura se tornam bandeiras úteis ao decidir quais usuários direcionar para notificações push.

Existem três opções de estado de assinatura de push: Subscribed, Opted-In e Unsubscribed.

Por padrão, para que seu usuário receba suas mensagens por meio de push, o estado de assinatura de push deve ser Subscribed ou Opted-In, e eles devem estar habilitados para push. Você pode substituir essa configuração, se necessário, ao compor uma mensagem.

Atualizando estados de assinatura de push

Existem três maneiras de você atualizar o estado de assinatura de push de um usuário:

Opt-in automático (padrão)

Por padrão, o Braze define o estado de assinatura de push de um usuário para Opted-In quando eles autorizam pela primeira vez as notificações push para seu aplicativo. O Braze também faz isso quando um usuário reativa as permissões de push nas configurações do sistema após desativá-las 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 do SDK

Você pode atualizar o estado de assinatura de um usuário com o SDK do Braze usando o método setPushNotificationSubscriptionType em Web, Android ou iOS. Por exemplo, você pode usar esse método para criar uma página de configurações em seu aplicativo onde os usuários podem habilitar ou desabilitar manualmente as notificações push.

API REST

Você pode atualizar o estado de assinatura de um usuário com a API REST do Braze usando o endpoint /users/track endpoint para atualizar seu atributo push_subscribe.

Verificando o estado de assinatura de push

!Perfil do usuário para John Doe com seu estado de assinatura de push definido como Inscrito.

Existem duas maneiras de verificar o estado da assinatura de push de um usuário com o Braze:

1. Perfil do Usuário Você pode acessar perfis de usuários individuais através do painel do Braze na página Pesquisa de Usuários. Após encontrar o perfil de um usuário (via endereço de e-mail, número de telefone ou ID de usuário externo), você pode selecionar a aba Engajamento para visualizar e ajustar manualmente o estado da assinatura de um usuário.
2. Exportação da API REST: 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. O Braze retornará um objeto de tokens de push que contém informações de habilitação de push por dispositivo.

Permissão de push

Todas as plataformas habilitadas para push - iOS, Web e Android - exigem opt-in explícito através de um prompt de sistema em nível de SO, com algumas pequenas diferenças descritas abaixo.

Como a decisão de um usuário é final e você não pode perguntar novamente após a recusa, usar mensagens in-app de introdução ao push é uma estratégia importante para aumentar suas taxas de opt-in.

Prompts nativos de permissão de push do SO

Android

Antes do Android 13, não era necessário permissão para enviar notificações push. No Android 12 e abaixo, todos os usuários são considerados Subscribed na primeira sessão quando o Braze solicita automaticamente um token de push. Neste ponto, o usuário está push habilitado com um token de push válido para aquele dispositivo e um estado de assinatura padrão de Subscribed.

A partir de Android 13, a permissão de push deve ser solicitada e concedida pelo usuário. Seu aplicativo pode solicitar manualmente permissão do usuário em momentos oportunos, mas se não o fizer, os usuários serão solicitados automaticamente quando seu aplicativo criar um canal de notificação.

iOS

!Uma notificação no Centro de Notificações do sistema com uma mensagem na parte inferior perguntando: “Continuar recebendo notificações do aplicativo Yachtr?” com dois botões abaixo para “Manter” ou “Desligar”

Seu aplicativo pode solicitar push provisório ou push autorizado.

Push autorizado requer permissão explícita de um usuário antes de enviar qualquer notificação, enquanto push provisório permite que você envie notificações silenciosamente, diretamente para o centro de notificações sem som ou alerta.

Autorização provisória e push silencioso

Antes do iOS 12 (lançado em 2018), todos os usuários devem optar explicitamente por receber notificações push.

No iOS 12, a Apple introduziu autorização provisória, permitindo que marcas enviem notificações push silenciosas para o centro de notificações de seus usuários antes que eles optem explicitamente, dando a você a chance de demonstrar o valor de suas mensagens cedo. Consulte autorização provisória para saber mais.

Web

Para a Web, você deve solicitar a opção explícita do usuário através do diálogo de permissão nativo do navegador.

Ao contrário do iOS e Android, que permitem que seu aplicativo mostre o prompt de permissão a qualquer momento, alguns navegadores modernos só mostrarão o prompt se acionado por um “gesto do usuário” (clique do mouse ou pressionamento de tecla). Se seu site tentar solicitar permissão para notificações push ao carregar a página, provavelmente será ignorado ou silenciado pelo navegador.

Como resultado, você deve pedir permissão apenas quando um usuário clicar em algum lugar em seu site e não aleatoriamente quando uma página carregar.

Tokens de push

Tokens de push são um identificador anônimo único gerado pelo dispositivo de um usuário e enviado ao Braze para identificar onde enviar a notificação de cada destinatário.

Existem duas maneiras de um token de push ser classificado que são essenciais para entender como uma notificação push pode ser enviada aos seus usuários.

1. Notificação em primeiro plano fornece a capacidade de enviar notificações push visíveis regulares para o primeiro plano do dispositivo de um usuário.
2. Notificação em segundo plano está disponível independentemente de um dispositivo específico ter optado por receber notificações push daquela marca. A notificação em segundo plano permite que as marcas enviem notificações push silenciosas - notificações que intencionalmente não são exibidas - para dispositivos para suportar funcionalidades chave como rastreamento de desinstalação.

Quando um perfil de usuário tem um token de notificação em primeiro plano válido associado a um aplicativo, a Braze considera o usuário “registrado para push” para o aplicativo dado. A Braze, então, fornece um filtro de segmentação específico, Foreground Push Enabled for App, para ajudar a identificar esses usuários.

Múltiplos usuários em um dispositivo

Os tokens de push são específicos tanto para um dispositivo quanto para um aplicativo, portanto, não é possível usar tokens de push para distinguir entre múltiplos usuários que estão usando o mesmo dispositivo.

Por exemplo, digamos que você tenha dois usuários: Charlie e Kim. Se Charlie ativou notificações push para seu aplicativo em seu telefone e Kim usa o telefone de Charlie para sair do perfil de Charlie e entrar no dela, o token de push será reatribuído ao perfil de Kim. O token de push permanecerá atribuído ao perfil de Kim naquele dispositivo até que ela saia e Charlie entre novamente.

Um aplicativo ou site pode ter apenas uma assinatura de push por dispositivo. Portanto, quando um usuário sai de um dispositivo ou site, e um novo usuário faz login, o token de push é reatribuído ao novo usuário. Isso é refletido no perfil do usuário, na seção Configurações de Contato da aba Engajamento:

!Registro de alterações do token de push na aba **Engajamento** do perfil de um usuário, que lista quando o token de push foi movido para outro usuário e qual era o token.

Como não há uma maneira para os provedores de push (APNs/FCM) distinguirem entre múltiplos usuários em um dispositivo, passamos o token de push para o último usuário que estava logado para determinar qual usuário direcionar no dispositivo para push.

Vários dispositivos e um usuário

O estado da assinatura de push é baseado no usuário e não é específico para nenhum aplicativo individual. O estado da assinatura de push é o valor que foi definido por último. Portanto, se um usuário optou por receber notificações push, o estado da assinatura de push é Opted-in em todos os dispositivos elegíveis. Se um usuário posteriormente cancelar explicitamente a assinatura de notificações push através do seu aplicativo ou outros métodos que sua marca fornece, o estado da assinatura de push é atualizado para Unsubscribed e nenhum dispositivo registrado para push pode receber notificações push.

Filtro de Push em Primeiro Plano Habilitado

Foreground Push Enabled é um filtro de segmentação no Braze que permite que os profissionais de marketing identifiquem facilmente os usuários que permitem que o Braze envie notificações push e os usuários que não expressaram preferências para não receber notificações push.

O filtro Foreground Push Enabled leva em conta o seguinte:

• A capacidade do Braze de enviar uma notificação push (token de push em primeiro plano)
• A preferência geral do usuário para receber push em qualquer um de seus dispositivos (estado da assinatura de push)

!Uma captura de tela do painel mostrando que um usuário está “Registrado para Push para Marketing (iOS)”

Um usuário é considerado “habilitado para push” ou “registrado para push” se tiver um token de push em primeiro plano ativo para um aplicativo dentro do seu espaço de trabalho, o que significa que o status de habilitação para push é específico do aplicativo.

Outros cenários específicos da plataforma

• android
• ios
• web

Melhores práticas

Consulte nosso artigo dedicado sobre Melhores práticas de push para orientações detalhadas sobre como otimizar o uso de push no Braze.