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.

Tokens por push

Compreender os tokens por push e o que eles são é fundamental para entender como enviamos mensagens por push aqui no Braze. Os tokens por push são um identificador anônimo exclusivo gerado pelo dispositivo de um usuário e enviado ao Braze para identificar para onde enviar a notificação de cada destinatário. Se um dispositivo não tiver um token por push, não há como enviar push para ele.

Os tokens por push são gerados por provedores de notificação por push. A Braze se conecta a provedores de serviço por push, como o Firebase Cloud Messaging Service (FCMs) para Android e o Apple Push Notification Service (APNs) para iOS, e esses provedores enviam tokens de dispositivo exclusivos que identificam seu app. Cada dispositivo tem um token exclusivo que é usado para envio de mensagens. Os tokens podem expirar ou ser atualizados.

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

1. O push em primeiro plano oferece a capacidade de enviar notificações por push visíveis regularmente para o primeiro plano do dispositivo do usuário.
2. As notificações por push em segundo plano estão disponíveis independentemente de um dispositivo específico ter aceitado receber notificações por push dessa marca. O push em segundo plano permite que as marcas enviem notificações por push silenciosas - notificações que intencionalmente não são exibidas - aos dispositivos para oferecer suporte a funcionalidades importantes, como rastreamento de desinstalação.

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

Vários usuários em um dispositivo

Os tokens por push são específicos de um dispositivo e de um app, portanto, não é possível usar tokens por push para distinguir entre vários usuários que estão 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:

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

As plataformas lidam com o registro de token por push e as permissões por push de diferentes maneiras:

• Android:
  • Android 13:
    A permissão push deve ser solicitada e concedida pelo usuário. Recebe um token após a permissão ser concedida pelo usuário. Seu aplicativo pode solicitar manualmente a permissão do usuário em momentos oportunos, mas, caso contrário, os usuários serão solicitados automaticamente depois que seu app criar um canal de notificação.
  • Android 12 e versões anteriores:
    Todos os usuários são considerados Subscribed em sua primeira sessão, quando a Braze solicita automaticamente um token por push. Nesse ponto, o usuário está ativado por push com um token por push válido para esse dispositivo e um estado de inscrição padrão de Subscribed.
    
    
• iOS: Não registrado automaticamente para push.
  • iOS 12 (com autorização provisória):
    Seu app pode solicitar autorização provisória ou push autorizado. O push autorizado exige permissão explícita de um usuário antes de enviar qualquer notificação (recebe um token depois que a permissão é concedida pelo usuário), enquanto o [provisional push][provisional-blog] permite enviar notificações silenciosamente, diretamente para a central de notificações, sem nenhum som ou alerta.
  • iOS 11 e posterior e iOS 12 (sem autorização provisória):
    Todos os usuários devem aceitar explicitamente o recebimento de notificações por push. Receberá um token após a aceitação dos usuários.
    
    
• Web: É 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.

Obter um token por push	Enviar um token por push
Os aplicativos devem se registrar em um provedor de push para obter um token por push para um dispositivo.	Os desenvolvedores podem então direcionar o dispositivo usando o token por push gerado pelos FCM/APNs.

Verificar o estado da inscrição push do usuário

Há duas maneiras de verificar o estado da inscrição push de um usuário na Braze:

1. 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 Engajamento para visualizar e ajustar manualmente o estado da inscrição de um usuário.
   
2. Exportação da API Rest: É possível exportar perfis de usuários individuais no formato JSON usando os pontos de extremidade de exportação Users by segment ou Users by identifier. 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.

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.

Ação	Descrição
changeUser() método chamado	O método Braze changeUser() alterna o ID do usuário ao qual os SDKs estão atribuindo dados de comportamento do usuário. Esse método geralmente é chamado quando um usuário faz o registro em um aplicativo. Quando o changeUser() for chamado com uma ID de usuário diferente ou nova em um dispositivo específico, o token por push desse dispositivo será movido para o perfil Braze apropriado com a ID de usuário correspondente.
Ocorre um erro de push	Alguns erros comuns de push que levam à remoção do token incluem MismatchSenderId, InvalidRegistration e outros tipos de bounces de push. Confira nossa lista completa de erros comuns de push.
Desinstalação pelo usuário	Quando um usuário desinstala o aplicativo de um dispositivo, o Braze removerá o token por push do usuário do perfil.

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.

Etapas de registro	Etapas do envio de mensagens
1. O cliente (dispositivo) se registra no provedor de push 2. O provedor gera e entrega o token por push 3. Flush tokens no Braze	1. Braze envia carga útil push para o provedor 2. O provedor entrega a carga útil do push ao dispositivo 3. O SDK passa as estatísticas de envio de mensagens para o Braze

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.