Skip to content

Registro push

Este artigo aborda o processo pelo qual um usuário é atribuído a um token por push e como o Braze envia mensagens por push aos seus usuários.

Sobre tokens por push

Quando um app solicita permissões de push de um dispositivo, o provedor de serviço de push do dispositivo gerará um token por push para esse app. Cada app recebe seu próprio token por push único e anônimo, que é como ele identifica o dispositivo e a instância atual do app ao enviar uma notificação por push.

Tenha em mente que os 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

Tokens por push são usados para enviar notificações por push tanto em primeiro plano quanto em segundo plano.

Quando um usuário aceita notificações por push para seu app, ele será considerado “registrado para push”, significando que agora pode ser segmentado usando o filtro de segmentação Foreground Push Enabled for App no Braze.

Múltiplos usuários em um dispositivo

Tokens por push são únicos tanto para o dispositivo quanto para o app, significando que tokens por push 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 tiver ativado as notificações por push para o seu app no telefone dele e Kim usar o telefone de Charlie para sair do perfil de Charlie e registrar o dela, o token por push será reatribuído ao perfil de Kim. O token por push permanecerá atribuído ao perfil de Kim nesse dispositivo até que ela se desconecte e Charlie se conecte novamente.

Um app ou site só pode ter uma inscrição push por dispositivo. Portanto, quando um usuário sai de um dispositivo ou site e um novo usuário faz o registro, 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:

O changelog do token por push na guia **Engagement** 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 maneira de os provedores de push (APNs/FCM) distinguirem entre vários usuários em um dispositivo, passamos o token por push para o último usuário que estava registrado para determinar qual usuário deve ser direcionado no dispositivo para push.

Registro de token por push

Cada plataforma de dispositivo lida com o registro de token por push de maneira diferente. Consulte o seguinte para detalhes específicos da plataforma:

É necessário solicitar a aceitação explícita dos usuários por meio da caixa de diálogo de permissão nativa do navegador. Receberá um token após a aceitação dos usuários. Ao contrário do iOS e do Android, que permitem que seu app mostre o prompt de permissão a qualquer momento, alguns navegadores modernos só mostrarão o prompt se forem disparados por um “gesto do usuário” (clique do mouse ou pressionamento de tecla). Se o seu site tentar solicitar permissão para notificações por push no carregamento da página, ele provavelmente será ignorado ou silenciado pelo navegador.

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

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

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

Perfil de usuário para John Doe com seu estado de inscrição push definido como Subscribed (Inscrito).

Existem duas maneiras de verificar o estado de inscrição por push de um usuário com a Braze:

  • Perfil do usuário: Você pode acessar perfis de usuários individuais através 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 Engajamento para visualizar e ajustar manualmente o estado da inscrição de um usuário.
  • 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. A Braze retornará um objeto de tokens por push que contém informações de capacitação por push por dispositivo.

Verificação do status do registro push

Na guia Engajamento no perfil de um usuário, você verá Push Registered For seguido pelo nome de um app. Se não houver informações do app para esse dispositivo, você verá dois traços(–). Haverá uma entrada para cada dispositivo que pertence ao usuário.

Se o nome do aplicativo da entrada do dispositivo for prefixado por Foreground:, o app estará autorizado a receber notificações por push em primeiro plano (visíveis para o usuário) e em segundo plano (não visíveis para o usuário) nesse dispositivo.

Changelog do push com um exemplo de token por push.

Por outro lado, se o nome do aplicativo da entrada do dispositivo for prefixado por Background:, o aplicativo só está autorizado a receber notificações por push em segundo plano e não pode exibir notificações visíveis ao usuário nesse dispositivo. Isso geralmente indica que o usuário desativou as notificações do app nesse dispositivo.

Se um token por push for movido para um usuário diferente no mesmo dispositivo, o primeiro usuário não será mais registrado por push.

Gerenciamento de tokens por push

Confira no gráfico a seguir as ações que levam à alteração ou remoção de tokens por push dos perfis de usuário.

Como isso se parece em uma escala mais ampla?

Quando um usuário abre um novo aplicativo e concede acesso push a partir de um prompt push, é feita uma chamada do SDK da Braze para os provedores push. Quando essa chamada é feita, o provedor de push executa uma verificação para ver se tudo está configurado corretamente. Em caso afirmativo, um token por push é passado para seu dispositivo. Quando esse token chega, o SDK o comunica à Braze. Depois que a Braze receber o token do provedor de push, atualizaremos ou criaremos um novo perfil de usuário. Esses usuários agora são considerados registrados.

Se quisermos lançar uma campanha, criamos uma campanha na Braze que gera uma carga útil de push para enviar ao provedor push. A partir daí, o provedor entrega a carga útil do push para o dispositivo do usuário e o SDK passa o estado do envio de mensagens para o Braze.

Um fluxograma que mapeia o processo de push mencionado entre 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 com aceitação exclui e depois baixa novamente o meu app?

Suponha que um usuário aceite o push, receba algumas mensagens no app e, posteriormente, exclua o aplicativo. Isso removerá o consentimento push no nível do dispositivo. A partir daqui, o primeiro push com bounce após a desinstalação resultará automaticamente na aceitação desse usuário de futuros envios de mensagens push. Depois disso, se um usuário reinstalar o aplicativo, mas não o iniciar, o Braze não poderá 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 voltasse a ativar o push em primeiro plano, seria necessário iniciar uma sessão para atualizar essas informações em seu perfil de usuário para começar a receber envios de mensagens push.

Quando os tokens por push expiram?

Infelizmente, os APNs e o FCM não definem isso de fato. 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 levar em conta essa ambiguidade, nossas integrações de SDK por push sempre registram e liberam tokens no início da sessão para garantir que tenhamos o token mais atualizado.
Github   Editar esta página no GitHub
New Stuff!