Capacitação e inscrição por push

Este artigo de referência aborda os conceitos de capacitação push e estados de inscrição push na Braze, incluindo as diferenças fundamentais de comportamento entre iOS, Android e Web.

Estados da inscrição push

Um “estado de inscrição por push” no Braze identifica a preferência global de um usuário quanto ao seu desejo de receber notificações por push. Como o estado da inscrição é baseado no usuário, ele não é específico de nenhum aplicativo individual. Os estados de inscrição tornam-se sinalizadores úteis ao decidir quais usuários devem ser direcionados para notificações por push.

Há três opções de estado da inscrição push: Subscribed, Opted-In, e Unsubscribed.

Por padrão, para que o usuário receba suas mensagens por push, o estado da inscrição no push deve ser Subscribed ou Opted-In, e ele deve estar ativado para a capacitação. Você pode substituir essa configuração, se necessário, ao criar uma mensagem.

Atualização dos estados da inscrição push

Há três maneiras de atualizar o estado da inscrição push de um usuário:

Aceitação automática (padrão)

Por padrão, o Braze define o estado da inscrição push de um usuário como Opted-In quando ele autoriza pela primeira vez as notificações por push para o seu app. A Braze também faz isso quando um usuário reativa as permissões push nas configurações do sistema após tê-las desativado 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 de SDK

Você pode atualizar o estado da inscrição de um usuário com o Braze SDK usando o método setPushNotificationSubscriptionType na Web, Android ou iOS. Por exemplo, você pode usar esse método para criar uma página de configurações no seu app em que os usuários possam ativar ou desativar manualmente as notificações por push.

API REST

É possível atualizar o estado da inscrição de um usuário com a Braze REST API usando o endpoint /users/track para atualizar o atributo push_subscribe.

Verificação do estado da inscrição push

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 do Braze na página User Search ]. 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][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.

Permissão de push

Todas as plataformas com capacitação push – iOS, Web e Android – exigem aceitação explícita por meio de um pedido de aceitação do sistema em nível de sistema operacional, com algumas pequenas diferenças descritas abaixo.

Como a decisão do usuário é final e não é possível perguntar novamente depois que ele recusar, usar push primer mensagens no app é uma estratégia importante para aumentar suas taxas de aceitação.

Solicitações de permissão push do sistema operacional nativo

Plataforma	Captura de tela	Descrição
iOS		Isso não se aplica ao solicitar permissão provisória de push .
Android		Essa permissão push foi introduzida no Android 13. Antes do Android 13, não era necessária permissão para enviar push.
Web

Android

Antes do Android 13, não era necessária permissão para enviar notificações por push. No Android 12 e versões anteriores, todos os usuários são considerados Subscribed na 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.

A partir de Android 13, a permissão push deve ser solicitada e 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 quando seu app criar um canal de notificação.

iOS

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

O push autorizado requer permissão explícita de um usuário antes de enviar qualquer notificação, enquanto o provisional push permite enviar notificações silenciosamente, diretamente para a central de notificações, sem nenhum som ou alerta.

Autorização provisória e push silencioso

Antes do iOS 12 (lançado em 2018), todos os usuários devem fazer a aceitação explícita para receber notificações por push.

No iOS 12, a Apple introduziu a autorização provisória, permitindo que as marcas enviem notificações por push silenciosas para a central de notificações de seus usuários antes da aceitação explícita, dando-lhe a chance de demonstrar o valor de suas mensagens antecipadamente. Consulte a autorização provisória para saber mais.

Web

Para a Web, é necessário solicitar a aceitação explícita do usuário por meio da caixa de diálogo de permissão do navegador nativo.

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.

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

Tokens por push

Push tokens 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.

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. O push em segundo plano está disponível independentemente do fato 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.

Vários dispositivos e um usuário

O estado da inscrição push é baseado no usuário e não é específico de nenhum app individual. O estado da inscrição push é o valor que foi definido pela última vez. Portanto, se um usuário tiver aceitado notificações por push, seu estado de inscrição será Opted-in em todos os dispositivos elegíveis. Se, posteriormente, um usuário cancelar explicitamente a inscrição nas notificações por push por meio do seu aplicativo ou de outros métodos fornecidos pela sua marca, o estado da inscrição por push dele será atualizado para Unsubscribed e nenhum dispositivo registrado poderá receber notificações por push.

Filtro ativado por push

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 por push e os usuários que não expressaram preferências para não receber notificações por push.

O filtro Push Enabled leva em conta o seguinte:

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

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

Outros cenários específicos da plataforma

• android
• ios
• web

Práticas recomendadas

Consulte nosso artigo dedicado às práticas recomendadas de push para obter orientações detalhadas sobre como otimizar o uso do push no Braze.