Mensagens no app com cartilha push

Você só tem uma chance de pedir permissão aos usuários por push, portanto, otimizar o registro de push é crucial para maximizar o alcance das suas mensagens push. Para ajudar a conseguir isso, você pode usar mensagens no app para explicar que tipo de mensagens seus usuários podem esperar receber se optarem pela aceitação, antes de mostrar a eles o pedido de aceitação push nativo. Isso é chamado de push primer.
Para criar uma mensagem no app com push primer na Braze, você pode usar o comportamento ao clicar no botão “Solicitar permissão de push” ao criar uma mensagem no app para iOS, Android ou Web.
Pré-requisitos
Esse recurso requer o comportamento ao clicar em um botão, que é compatível com as seguintes versões mínimas ou posteriores:
Além disso, observe os seguintes detalhes específicos da plataforma:
| Versão do sistema operacional | Informações adicionais |
| |———- | ———————- |
| Android 12 e versões anteriores A implementação de primers push não é recomendada porque o push é aceito por padrão. | |
| Android 13+ | Se um usuário negar duas vezes a solicitação de permissão de envio de mensagens, o Android bloqueará outras solicitações, inclusive as mensagens de push do Braze. Para conceder permissão depois disso, os usuários devem ativar manualmente o push para o seu app nas configurações do dispositivo. |
Informações gerais
- O prompt push pode ser exibido apenas uma vez por instalação, o que é imposto pelo sistema operacional.
- O prompt não será exibido se a configuração push do app estiver explicitamente ativada ou desativada. Ele só é exibido para usuários com autorização provisória.
- A configuração push do app está ativada: O Braze não mostra a mensagem no app, pois o usuário já fez a aceitação.
- A configuração push do app está desativada: É necessário redirecionar o usuário para as configurações de notificação por push do seu app nas configurações do dispositivo.
Remoção manual do código
A mensagem no app que você configurou usando este tutorial chama o código de prompt push nativo automaticamente quando um usuário clica no botão de mensagem no app. Para evitar a solicitação de permissão de notificação por push duas vezes ou no momento errado, o desenvolvedor deve modificar qualquer integração de notificação por push existente que tenha implementado para garantir que a mensagem no app seja o primeiro primer de notificação por push que os usuários vejam.
Sua equipe de desenvolvimento deve revisar a implementação de notificações por push para seu app ou site e remover manualmente qualquer código que solicite permissão por push. Por exemplo, remova as referências ao código a seguir:
1
requestAuthorizationWithOptions
1
requestAuthorization
1
2
3
braze.requestPushPermission()
// or
appboy.registerAppboyPushMessages()
1
android.permission.POST_NOTIFICATIONS
Etapa 1: Crie uma mensagem no app
Primeiro, crie uma mensagem no app e, em seguida, selecione o tipo e o layout da mensagem.
Para garantir que haja espaço suficiente para a mensagem e os botões, use um layout de tela cheia ou de mensagem modal. Se escolher tela cheia, note que é necessária uma imagem.
Etapa 2: Crie sua mensagem
Agora é hora de adicionar sua cópia! Lembre-se de que um push primer deve preparar o usuário para ativar as notificações por push. No corpo da mensagem, sugerimos destacar os motivos pelos quais os usuários devem ativar as notificações por push. Seja específico quanto ao tipo de notificações que você deseja enviar e o valor que elas podem oferecer.
Por exemplo, um app de notícias pode usar o seguinte push primer:
1
Breaking news on the go! Enable push notifications to get alerts for major stories and topics that matter to you.
Enquanto um app de streaming pode usar o seguinte:
1
Get push notifications from Movie Cannon? Notifications may include new movies, TV shows, or other notices and can be turned off at any time.
Para obter práticas recomendadas e recursos adicionais, consulte Criação de pedidos de aceitação personalizados.
Etapa 3: Especificar o comportamento do botão
Para adicionar botões à sua mensagem no app, arraste dois blocos de botões para a mensagem, que funcionam como os botões primário e secundário da mensagem no app. Também é possível arrastar uma linha para a mensagem e, em seguida, arrastar os botões para a linha, de modo que os botões fiquem na mesma linha horizontal (em vez de empilhados uns sobre os outros). Recomendamos “Allow notifications” (Permitir notificações) e “Not now” (Agora não) como botões iniciais, mas há muitos avisos de botões diferentes que você pode atribuir.
Depois de adicionar o texto do botão, especifique o comportamento ao clicar em cada botão:
- Botão 1: Defina essa opção como “Fechar mensagem”. Esse é seu botão secundário ou a opção “Not now” (Agora não).
- Botão 2: Defina essa opção como “Request Push Permission” (Solicitar permissão de push). Esse é o botão principal ou a opção “Permitir notificações”.

Etapa 4: Programação de entrega
Para definir o envio do push primer em um momento relevante, é necessário programar a mensagem no app como uma mensagem baseada em ação com Perform Custom Event como a ação-gatilho.
Embora o momento ideal varie, o Braze sugere esperar até que um usuário conclua algum tipo de ação de alto valor, indicando que ele está começando a ver valor em seu app ou site, ou quando houver uma necessidade convincente que as notificações por push possam atender (por exemplo, depois que ele fizer um pedido e você quiser oferecer a ele informações de rastreamento de envio). Dessa forma, a solicitação é benéfica para o cliente e não apenas para sua marca.

Etapa 5: Usuários-alvo
O objetivo de uma campanha de push primer é avisar os usuários em qualquer dispositivo em que eles ainda não tenham concedido permissões de push. Isso pode incluir usuários de primeira viagem ou usuários existentes que adquirem um novo dispositivo ou reinstalam seu aplicativo.
Supressão automática com push primer sem código: Se você usar a cartilha push sem código (a ação do botão “Request Push Permission”), não precisará adicionar filtros de inscrição push à sua segmentação. O SDK suprime automaticamente a mensagem no app em dispositivos que já têm um token por push ativo, independentemente do status de push do usuário em outros dispositivos. Para saber mais sobre o direcionamento de usuários com vários dispositivos, consulte Direcionamento de usuários com vários dispositivos.
Se não estiver usando o push primer sem código, adicione um filtro onde Foreground Push Enabled For App is false. Esse filtro identifica instalações de aplicativos individuais que ainda não têm aceitação de notificações por push em primeiro plano.
O uso de um filtro no nível do usuário, como Push Subscription Status is not Opted In, exclui os usuários que já têm pedido de aceitação em outro dispositivo, impedindo-os de receber o prompt em seu novo dispositivo.
Além disso, você pode decidir quais segmentos adicionais considera mais apropriados. Por exemplo, você pode direcionar usuários que concluíram uma segunda compra, usuários que acabaram de criar uma conta para se tornarem membros ou até mesmo usuários que visitam seu app mais de duas vezes por semana. O direcionamento de usuários para esses segmentos cruciais aumenta a probabilidade de aceitação e capacitação de usuários por push.
Direcionamento de usuários com vários dispositivos
Como o Braze captura os dados de usuários no nível do perfil e não do dispositivo, o direcionamento para usuários que possuem vários dispositivos pode ser um desafio. Os filtros de inscrição push na segmentação incluem ou excluem usuários com base no estado de inscrição de um único dispositivo, em vez do estado de inscrição do dispositivo direcionado específico. Além disso, os estados provisórios no iOS aumentam a complexidade, pois esses dispositivos tecnicamente têm tokens por push em primeiro plano, mas os usuários não têm aceitação explícita.
O problema com os filtros de inscrição push
Quando um usuário tem vários dispositivos com diferentes estados de inscrição push, os filtros de inscrição push na sua segmentação podem não conseguir direcionar alguns dispositivos. Considere estes cenários:
Scenario 1: User has two devices on different platforms
O usuário tem dois dispositivos:
- Dispositivo A: Android, aceitação para push
- Dispositivo B: iOS, sem aceitação do push
Filtros de segmento que não funcionam:
Push enabled = false- O usuário tem a capacitação push ativada em seu dispositivo Android, portanto, não se enquadra no segmento. O segmento não inclui o dispositivo iOS.Push subscription status is not opted in- O usuário tem a capacitação push ativada em seu dispositivo Android, portanto, não se enquadra no segmento. O segmento não inclui o dispositivo iOS.
Filtros de segmento que funcionam:
Push enabled for iOS = false- O usuário está ativado para push em seu dispositivo Android, mas estamos direcionando apenas para dispositivos iOS, portanto, o usuário se enquadra no segmento. O segmento inclui o dispositivo iOS.
Scenario 2: User has two iOS devices with different states
O usuário tem dois dispositivos iOS:
- Dispositivo A: Aceitação para push
- Dispositivo B: Capacitação provisória, mas sem aceitação
Filtros de segmento que não funcionam:
Push enabled = false- O dispositivo A tem aceitação para push, para que o usuário não caia no segmento. O segmento não inclui o dispositivo B.Provisionally opted in = true- O dispositivo A está totalmente aceito, o que significa que não está em um estado provisório. O usuário não se enquadra no segmento. O segmento não inclui o dispositivo B.Push enabled for app > iOS = false- O dispositivo A tem aceitação para push no iOS, portanto, o usuário não se enquadra no segmento. O segmento não inclui o dispositivo B.Push subscription status is not opted in- O dispositivo A tem aceitação para push, para que o usuário não caia no segmento. O segmento não inclui o dispositivo B.
Resultado: O uso de qualquer combinação desses filtros push faz com que o segmento exclua pelo menos um dispositivo.
Scenario 3: User has three or more devices on the same OS
O usuário tem três dispositivos:
- Dispositivo A: Aceitação para push
- Dispositivo B: Sem aceitação para push
- Dispositivo C: Sem aceitação para push
Filtros de segmento que não funcionam:
Push enabled = false- O dispositivo A tem aceitação para push, para que o usuário não caia no segmento. O segmento não inclui os dispositivos B e C.Push enabled for app > X = false- O dispositivo A tem aceitação para push no app especificado, para que o usuário não caia no segmento. O segmento não inclui os dispositivos B e C.Push subscription status is not opted in- O dispositivo A tem aceitação para push, para que o usuário não caia no segmento. O segmento não inclui os dispositivos B e C.
Resultado: O uso de qualquer combinação desses filtros push deixa pelo menos um dispositivo sem alvo.
Solução: Use o push primer sem código
A solução recomendada é usar o iniciador de push sem código (o botão de ação “Request Push Permission”) sem filtros adicionais de segmentação de status de push.
Supressão automática: O primer no-code push é suprimido automaticamente em dispositivos que já têm um token por push ativo. O SDK verifica se um usuário em seu dispositivo específico já tem um token por push. Se o SDK constatar que o usuário já fez a aceitação (por exemplo, a partir de uma solicitação anterior ou por meio das configurações do dispositivo), o SDK suprimirá automaticamente a mensagem no app sem a necessidade de filtros de segmentação adicionais. O primer é exibido em todos os outros cenários, inclusive se um usuário tiver aceitação provisória do push.
A vantagem de usar o push primer sem código é que a funcionalidade é suportada pelo SDK da Braze. Como o SDK pode detectar o status do token por push no dispositivo específico que exibe a mensagem, não é necessário depender de filtros de segmentação no nível do perfil que podem excluir usuários com vários dispositivos.
Considerações
Não é necessário um push primer com código: Você deve usar o push primer sem código para que a supressão automática funcione. Se você configurar lógica personalizada ou deep linking em vez de usar a ação do botão “Request Push Permission”, o SDK não poderá identificar que você está tentando exibir um push primer. Isso resulta na exibição da mensagem independentemente do estado de inscrição do dispositivo.
Supressão para usuários que fizeram a aceitação: Talvez você queira suprimir a mensagem no app para usuários que tenham explicitamente optado pela não aceitação do push (por exemplo, na solicitação nativa ou nas configurações do dispositivo) e redirecionar esses usuários com uma campanha de mensagens separada. Para fazer isso, use a seguinte lógica Liquid em combinação com o primer sem código:
1
2
3
4
{% if targeted_device.${foreground_push_enabled} == false %}
{% abort_message('user turned off push notifications') %}
{% endif %}
- message goes here -
O filtro targeted_device Liquid analisa apenas o dispositivo em que a mensagem está sendo exibida, e não o perfil do usuário. Nesse dispositivo, foreground_push_enabled é definido como true quando há um token por push ativo em primeiro plano e definido como false quando o sistema operacional informa que as notificações por push foram desativadas (por exemplo, o usuário as desativou explicitamente). Para dispositivos completamente novos que ainda não responderam a um estado de permissão push, foreground_push_enabled não está definido e não tem valor. Como a condição Liquid verifica especificamente ```false`, ela suprime o primer somente para dispositivos com uma aceitação explícita, enquanto os dispositivos nesse estado desconhecido ainda se qualificam e podem receber o primer push.
Etapa 6: Eventos de conversão
O Braze sugere configurações padrão para conversões, mas você pode querer configurar eventos de conversão em torno de primers push.
Editar esta página no GitHub