Ativação de push e inscrição de push

Este artigo de referência aborda os conceitos de ativação de push e estados de inscrição de 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.

As seguintes opções de estado de inscrição existem: Subscribed, Opted-In e Unsubscribed.

Por padrão, para que seu usuário receba suas mensagens por push, o estado de inscrição por push deve ser Subscribed ou Opted-In, e eles devem ter o push em primeiro plano habilitado. Você pode substituir essa configuração, se necessário, ao criar uma mensagem.

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

Revise as seguintes maneiras de atualizar o estado de inscrição por 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

Você pode atualizar o estado de inscrição de um usuário com a API REST do Braze usando o endpoint /users/track endpoint para atualizar seu atributo push_subscribe.

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

Você pode verificar o estado de inscrição por push de um usuário com o Braze de qualquer uma das seguintes maneiras:

• Perfil do usuário: Você pode acessar perfis de usuários individuais através do dashboard do 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. O Braze retorna um objeto de tokens de push que contém informações de habilitação de push por dispositivo.

Ações do usuário no iOS e status de push

A tabela a seguir mostra como diferentes ações do usuário afetam a ativação de push no iOS, o registro de push em primeiro ou segundo plano e o status de inscrição de push na Braze. Quando um usuário instala seu app e inicia a primeira sessão, o estado geralmente é o mostrado na primeira linha. Cada ação subsequente pode atualizar alguns desses valores, mas não outros.

^{* Se o app não usar push provisório, Foreground Push Enabled será false até que o usuário permita notificações por push. Se o app usar push provisório, Foreground Push Enabled será true no início da primeira sessão. Para saber mais, consulte Autorização provisória e push silencioso.}

^{** A partir da versão 7.5.0 do Braze Swift SDK, a propriedade de configuração optInWhenPushAuthorized controla se o estado de inscrição de push é automaticamente definido como Opted-In quando a permissão de push é autorizada. Para saber mais, consulte Atualizando estados de inscrição de push.}

Permissão de push

Todas as plataformas com push ativado — iOS, Web e Android — exigem opt-in explícito por meio de um prompt do sistema no nível do SO, com algumas pequenas diferenças descritas abaixo.

Como a decisão do usuário é final e você não pode perguntar novamente após uma recusa, usar mensagens no app de push primer é uma estratégia importante para aumentar suas taxas de opt-in.

Prompts nativos de permissão de push do SO

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

Android

Antes do Android 13, a permissão não era necessária 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 de push. Nesse ponto, o usuário está com push ativado com um token de push válido para aquele dispositivo e um estado de inscrição padrão de Subscribed.

A partir do Android 13, a permissão de push deve ser solicitada e concedida pelo usuário. Seu app pode solicitar manualmente a permissão ao 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 exige permissão explícita do usuário antes de enviar qualquer notificação, enquanto o push provisório permite enviar notificações silenciosamente, diretamente para a central de notificações, sem som ou alerta.

Autorização provisória e push silencioso

Antes do iOS 12 (lançado em 2018), todos os usuários precisavam fazer opt-in explícito para receber notificações por push.

No iOS 12, a Apple introduziu a autorização provisória, permitindo que marcas enviem notificações por push silenciosas para a central de notificações dos usuários antes que eles façam opt-in explícito, dando a você a chance de demonstrar o valor das suas mensagens antecipadamente. Consulte autorização provisória para saber mais.

Web

Para Web, você deve solicitar opt-in explícito do usuário por meio do diálogo nativo de permissão do navegador.

Diferentemente do iOS e do 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 pressionamento de tecla). Se seu site tentar solicitar permissão de notificação por push no carregamento da página, provavelmente será ignorado ou silenciado pelo navegador.

Por isso, você deve solicitar permissão apenas quando o usuário clicar em algum lugar do seu site, e não aleatoriamente quando uma página carregar.

Tokens de push

Tokens de push são identificadores anônimos únicos gerados pelo dispositivo do usuário e enviados à Braze para identificar para onde enviar a notificação de cada destinatário.

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

1. Push em primeiro plano oferece a capacidade de enviar notificações por push regulares e visíveis para o primeiro plano do dispositivo do usuário.
2. Push em segundo plano está disponível independentemente de um dispositivo específico ter feito opt-in para receber notificações por push daquela marca. O push em segundo plano permite que marcas enviem notificações por push silenciosas — notificações que intencionalmente não são exibidas — para dispositivos, a fim de dar suporte a funcionalidades essenciais como rastreamento de desinstalação.

Quando um perfil de usuário tem um token de push de primeiro plano válido associado a um app, a Braze considera o usuário como “registrado para push” naquele app. A Braze então fornece um filtro de segmentação específico, Foreground Push Enabled for App, para ajudar a identificar esses usuários.

Múltiplos usuários em um dispositivo

Os tokens de push são específicos tanto para o dispositivo quanto para o app, então não é possível usar tokens de push para distinguir entre múltiplos usuários que estão usando o mesmo dispositivo.

Por exemplo, digamos que você tem dois usuários: Charlie e Kim. Se Charlie ativou notificações por push para seu app no telefone dele e Kim usa o telefone de Charlie para sair do perfil de Charlie e entrar no dela, o token de push será reatribuído ao perfil de Kim. O token de 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 de 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 forma de os provedores de push (APNs/FCM) distinguirem entre múltiplos usuários em um dispositivo, passamos o token de push para o último usuário que fez login para determinar qual usuário direcionar no dispositivo para push.

Múltiplos dispositivos e um usuário

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

Filtro Foreground Push Enabled

Foreground Push Enabled é um filtro de segmentação na Braze que permite que profissionais de marketing identifiquem facilmente usuários que permitem que a Braze envie notificações por push e usuários que não expressaram preferências para não receber notificações por push.

O filtro Foreground Push Enabled leva em consideração o seguinte:

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

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

Outros cenários específicos de plataforma

• web
• android
• ios

Práticas recomendadas

Consulte nosso artigo dedicado sobre Práticas recomendadas de push para orientações detalhadas sobre como otimizar o uso de push na Braze.