Ciclo de vida do token por push
Este artigo aborda o processo pelo qual um usuário recebe um token por push e como a Braze envia notificações por push para seus usuários.
Sobre tokens por push
Quando um app solicita permissões de push a um dispositivo, o provedor de notificação por push do dispositivo gera um token por push para esse app. Cada app recebe seu próprio token por push exclusivo e anônimo, que é como ele identifica o dispositivo e a instância atual do app ao enviar uma notificação por push.
Lembre-se de que tokens por push não são identificadores estáticos que duram para sempre—eles podem ser atualizados e podem expirar.
Push em primeiro plano vs. em segundo plano
Os tokens por push são usados para enviar notificações por push tanto em primeiro plano quanto em segundo plano.
| Tipo | Requer opt-in? | Descrição |
|---|---|---|
| Push em primeiro plano | Sim | Uma notificação é exibida visivelmente para o usuário enquanto o app está em primeiro plano. |
| Push em segundo plano | Não | Uma notificação é entregue silenciosamente em segundo plano sem ser exibida. Frequentemente usada para funcionalidades como rastreamento de desinstalação. |
Quando um usuário faz opt-in para notificações por push do seu app, ele será considerado “registrado para push”, o que significa que agora pode ser segmentado usando o filtro de segmentação Foreground Push Enabled for App na Braze.
Isso é diferente do filtro de segmentação Foreground Push Enabled, que é usado para identificar usuários que fizeram opt-in em pelo menos um dos seus apps — não em um app específico. Para saber mais, consulte Filtros de segmentação.
Múltiplos usuários em um dispositivo
Os tokens por push são exclusivos tanto para o dispositivo quanto para o app, o que significa que não podem ser usados para segmentar usuários específicos se múltiplos usuários estiverem usando o mesmo dispositivo.
Por exemplo, digamos que você tenha dois usuários: Charlie e Kim. Se Charlie ativou as notificações por push do seu app no celular dele e Kim usa o celular de Charlie para sair do perfil de Charlie e entrar no dela, o token por push será reatribuído ao perfil de Kim. O token por push permanecerá atribuído ao perfil de Kim naquele dispositivo até que ela saia e Charlie faça login novamente.
Um app ou site pode ter apenas uma inscrição de push por dispositivo. Então, quando um usuário sai de um dispositivo ou site e um novo usuário faz login, o token por push é reatribuído ao novo usuário. Isso é refletido no perfil do usuário na seção Contact Settings da guia Engagement:
Como não há uma forma de os provedores de push (APNs/FCM) distinguirem entre múltiplos usuários em um dispositivo, passamos o token por push para o último usuário que fez login para determinar qual usuário segmentar no dispositivo para push.
Se você vir uma mensagem de erro em Contact Settings > Push Changelog, consulte Mensagens de erro comuns de push para explicações e próximos passos.
Registro de token por push
Cada plataforma de dispositivo lida com o registro de token por push de forma diferente. Consulte as informações a seguir para detalhes específicos de cada plataforma:
Você deve solicitar a aceitação explícita dos usuários por meio da caixa de diálogo de permissão nativa do navegador. O token será recebido após os usuários aceitarem. Diferente do iOS e do Android, que permitem que seu app exiba o prompt de permissão a qualquer momento, alguns navegadores modernos só exibem o prompt quando acionados por um “gesto do usuário” (clique do mouse ou pressionamento de tecla). Se o seu site tentar solicitar permissão de notificação por push ao carregar a página, provavelmente a solicitação será ignorada ou silenciada pelo navegador.
Quando seu app é instalado, um token por push é gerado automaticamente para ele — no entanto, ele só pode ser usado para notificações por push em segundo plano até que o usuário aceite explicitamente. Além disso, o registro é tratado de forma diferente nas diversas versões do Android:
| Versão | Detalhes |
|---|---|
| Android 13 | A permissão de push deve ser solicitada e concedida pelo usuário. Seu app pode solicitar a permissão manualmente, ou os usuários serão solicitados automaticamente após a criação de um canal de notificação. |
| Android 12 e anteriores | Todos os usuários são considerados Subscribed após a primeira sessão. A Braze solicita automaticamente um token por push nesse momento, tornando o usuário habilitado para push com um token válido e um estado de inscrição padrão de Subscribed. |
O iOS não gera automaticamente tokens por push para um app quando ele é instalado. Além disso, o registro é tratado de forma diferente nas diversas versões do iOS:
| Versão | Autorização provisória? | Detalhes |
|---|---|---|
| iOS 12 | Sim | Quando um usuário aceita as notificações por push, você recebe autorização padrão, o que permite enviar notificações por push em primeiro plano. No entanto, você também pode solicitar autorização provisória, que permite enviar notificações por push em segundo plano silenciosas diretamente para a central de notificações. |
| iOS 11 ou anteriores | Não | Todos os usuários devem aceitar explicitamente para receber notificações por push. Um token por push é gerado somente após a concessão da permissão. |
A Braze assume que os tokens por push importados são tokens por push de primeiro plano válidos para o seu app e ambiente.
Quando você importa tokens iOS, a Braze não armazena um gateway do serviço de Notificações por Push da Apple (APN) (development ou production) para eles. A Braze envia para esses tokens por meio do gateway configurado do seu app. Se um token foi gerado para o outro ambiente, o APN o rejeita com BadDeviceToken, e o envio sofre bounce.
A Braze armazena um gateway para o token somente se o SDK registrar posteriormente o mesmo token e informar um gateway.
Verificando o estado de inscrição de push do usuário
Existem duas maneiras de verificar o estado de inscrição de push de um usuário na Braze:
- Perfil de usuário: Você pode acessar perfis individuais de usuários pelo dashboard da Braze na página Pesquisa de usuário. Após encontrar o perfil de um usuário (por endereço de e-mail, número de telefone ou ID de usuário externo), você pode selecionar a guia Engagement para visualizar e ajustar manualmente o estado de inscrição de um usuário.
- Exportação via REST API: Você pode exportar perfis individuais de usuários em formato JSON usando os endpoints de exportação Usuários por segmento ou Usuários por identificador. A Braze retornará um objeto de tokens por push que contém informações de habilitação de push por dispositivo.
Verificando o status de registro de push
Na guia Engagement no perfil de um usuário, você verá Push Registered For seguido do nome de um app. Se não existir informação do app para aquele dispositivo, você verá dois traços (--). Haverá uma entrada para cada dispositivo que pertence ao usuário.
Se o nome do app na entrada do dispositivo for prefixado por Foreground:, o app está autorizado a receber tanto notificações por push em primeiro plano (visíveis para o usuário) quanto notificações por push em segundo plano (não visíveis para o usuário) naquele dispositivo.
Por outro lado, se o nome do app na entrada do dispositivo for prefixado por Background:, o app está autorizado apenas a receber push em segundo plano e não pode exibir notificações visíveis ao usuário naquele dispositivo. Isso geralmente indica que o usuário desativou as notificações para o app naquele dispositivo.
Se um token por push for movido para um usuário diferente no mesmo dispositivo, o primeiro usuário não estará mais registrado para push.
Gerenciamento de tokens por push
Confira o gráfico a seguir para ações que levam a alterações ou remoção de tokens por push dos perfis de usuário.
| Ação | Descrição |
|---|---|
Método changeUser() chamado |
O método changeUser() da Braze alterna o ID de usuário ao qual os SDKs estão atribuindo dados de comportamento do usuário. Esse método é normalmente chamado quando um usuário faz login em um aplicativo. Quando changeUser() é chamado com um ID de usuário diferente ou novo em um dispositivo específico, o token por push daquele dispositivo será movido para o perfil da Braze correspondente ao ID de usuário correto. |
| Ocorre um erro de push | Alguns erros de push comuns que levam à remoção do token incluem MismatchSenderId, InvalidRegistration e outros tipos de bounces de push. Confira nossa lista completa de erros de push comuns. |
| O usuário desinstala o app | Quando um usuário desinstala o aplicativo de um dispositivo, a Braze removerá o token por push do perfil do usuário. |
Como isso funciona em uma escala mais ampla?
Quando um usuário abre um novo aplicativo e concede acesso push a partir de um prompt de push, uma chamada é feita do SDK da Braze para os provedores de push. Quando essa chamada é feita, o provedor de push executa uma verificação para ver se tudo está configurado corretamente. Se estiver, um token por push é passado para o seu dispositivo. Quando esse token chega, o SDK comunica isso à Braze. Depois que a Braze recebe o token do provedor de push, ela atualiza ou cria um novo perfil de usuário. Esses usuários são então considerados registrados.
Se quisermos lançar uma campanha, criamos uma Campaign na Braze que gera uma carga útil de push para enviar ao provedor de push. A partir daí, o provedor entrega a carga útil de push ao dispositivo do usuário e o SDK passa o estado do envio de mensagens para a Braze.
| Etapas de registro | Etapas de envio de mensagens |
|---|---|
| 1. O cliente (dispositivo) se registra no provedor de push 2. O provedor gera e entrega o token por push 3. Envio dos tokens para a Braze |
1. A Braze envia a carga útil de push para o provedor 2. O provedor entrega a carga útil de push ao dispositivo 3. O SDK passa as estatísticas de envio de mensagens para a Braze |
Perguntas frequentes
O que acontece quando um usuário que aceitou push exclui e depois reinstala meu app?
Suponha que um usuário aceite push, receba algumas mensagens por push e depois exclua o app. Isso removerá o consentimento de push no nível do dispositivo. A partir daqui, o primeiro bounce de push após a desinstalação fará com que esse usuário seja automaticamente removido do envio de mensagens por push futuras. Depois disso, se o usuário reinstalar o app, mas não abri-lo, a Braze não conseguirá enviar uma notificação por push para ele, pois os tokens por push não foram concedidos novamente para o seu app.
Além disso, se o usuário reativasse o push em primeiro plano, seria necessário o início de uma sessão para atualizar essas informações no perfil de usuário e voltar a receber mensagens por push.
Quando os tokens por push expiram?
Infelizmente, o APNs e o FCM não definem isso de forma clara. Os tokens por push podem expirar quando um app é atualizado, quando os usuários transferem seus dados para um novo dispositivo ou quando reinstalam um sistema operacional. Na maioria das vezes, não temos insight sobre por que os provedores de push expiram determinados tokens por push.
Para lidar com essa ambiguidade, nossas integrações de push do SDK sempre registram e atualizam os tokens no início da sessão para garantir que temos o token mais atualizado.