Skip to content

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.

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.

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 Configurações de contato da guia Engajamento:

Changelog do token por push na guia **Engajamento** do perfil de um usuário, que lista quando o token por push foi movido para outro usuário e qual era o token.

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.

Registro de token por push

Cada plataforma de dispositivo lida com o registro de token por push de forma diferente. Consulte os detalhes específicos de cada plataforma a seguir:

Você deve solicitar opt-in explícito 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 fazerem opt-in. Diferentemente do iOS e Android, que permitem que seu app exiba o prompt de permissão a qualquer momento, alguns navegadores modernos só exibirão o prompt se acionado por um “gesto do usuário” (clique do mouse ou tecla pressionada). Se o seu site tentar solicitar permissão de notificação por push no carregamento da página, provavelmente será ignorado ou silenciado pelo navegador.

Quando seu app é instalado, um token por push é gerado automaticamente para o app—no entanto, ele só pode ser usado para notificações por push em segundo plano até que o usuário faça opt-in explicitamente. Além disso, o registro é tratado de forma diferente entre as versões do Android:

O iOS não gera automaticamente tokens por push para um app quando ele é instalado. Além disso, o registro é tratado de forma diferente entre as versões do iOS:

Verificando o estado de inscrição de push do usuário

Perfil de usuário de John Doe com o estado de inscrição de push definido como Inscrito.

Existem duas formas de verificar o estado de inscrição de push de um usuário na Braze:

  • Perfil de usuário: Você pode acessar perfis de usuários individuais pelo dashboard da Braze na página Pesquisa de usuários. 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 Engajamento para visualizar e ajustar manualmente o estado de inscrição do usuário.
  • Exportação via 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 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 Engajamento do perfil de um usuário, você verá Push registrado para seguido do nome de um app. Se não houver informações 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.

Changelog de push com um exemplo de token por push.

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 quadro a seguir para ações que levam a alterações ou remoção de tokens por push dos perfis de usuários.

Como isso funciona em uma escala mais ampla?

Quando um usuário abre um novo aplicativo e concede acesso a 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. Após a Braze receber o token do provedor de push, atualizamos ou criamos um novo perfil de usuário. Esses usuários agora são considerados registrados.

Se quisermos lançar uma Campaign, 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.

Um fluxograma que mapeia o processo de push mencionado acima entre a Braze, o cliente e o serviço de Notificações por Push da Apple ou Firebase Cloud Messaging.

Perguntas frequentes

O que acontece quando um usuário que fez opt-in exclui e depois baixa novamente meu app?

Suponha que um usuário faça opt-in para push, receba algumas notificações por push e depois exclua o app. Isso removerá o consentimento de push no nível do dispositivo. A partir daqui, o primeiro push com bounce após a desinstalação resultará automaticamente no opt-out desse usuário de futuras notificações por push. Depois disso, se o usuário reinstalar o app mas não abri-lo, a Braze não conseguirá enviar um push para o usuário porque os tokens por push não foram concedidos novamente para o seu app.

Além disso, se um usuário reativar o push em primeiro plano, seria necessário o início de uma sessão para atualizar essa informação no perfil do usuário e começar a receber notificações por push.

Quando os tokens por push expiram?

Infelizmente, APNs e 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 dos casos, não temos realmente visibilidade 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 enviam os tokens no início da sessão para garantir que tenhamos o token mais atualizado.
New Stuff!