Pular para o conteúdo principal

​
Por que usar um prompt de permissão push?

Para enviar notificações push que podem aparecer como banners, mostrar na tela de bloqueio, reproduzir sons e muito mais, seu aplicativo deve primeiro obter a permissão do usuário. No iOS, Android, Huawei, Amazon e Web, isso envolve exibir um prompt de permissão no nível do sistema.

Um dispositivo iOS e Android exibindo o prompt de permissão no nível do sistema.

Este guia é para assinantes de push de aplicativos móveis. Para push web, consulte Prompts de Permissão Web.
No iOS, você também pode usar Notificações provisórias, que entregam silenciosamente ao centro de notificações sem solicitar ao usuário—ideal para testes ou onboarding de baixo atrito. Para o prompt de permissão recomendado no nível do sistema, tenha em mente:
  • O iOS permite o prompt de permissão apenas uma vez.
  • O Android permite duas vezes.
  • Depois disso, os usuários devem habilitar manualmente as notificações nas configurações do sistema.
Embora você possa acionar o prompt a qualquer momento usando nosso método SDK requestPermission(), é fundamental perguntar no momento certo e com o contexto adequado. Tanto a Apple quanto o Google recomendam fortemente explicar o valor de suas notificações primeiro. A melhor maneira de fazer isso? Use um “prompt suave”—uma mensagem in-app personalizada que introduz a solicitação. Se o usuário aceitar, o prompt do sistema aparece. Se ele recusar, nada acontece—sem problemas.

Exemplo mostra uma mensagem in-app que leva a um prompt de permissão push no nível do sistema.

​
Configurar um prompt de permissão push in-app

1

Remover quaisquer prompts de permissão automáticos

Antes de começar, certifique-se de que seu aplicativo não está acionando automaticamente o prompt push nativo:
  • Remova os métodos requestPermission() ou optIn() se você estiver chamando-os na inicialização do aplicativo.
  • Remova chamadas nativas do iOS para requestAuthorizationWithOptions e quaisquer métodos que geram tokens push.
  • Remova chamadas do Android para requestPermissions e quaisquer métodos que geram tokens push.
Além disso, certifique-se de estar usando a versão mais recente do SDK do OneSignal em seu aplicativo.
2

Criar ou editar a mensagem in-app

Vá para Messages > In-App e então:
  • Edite o template padrão Push Permission Prompt, ou
  • Clique em New Message para criar o seu próprio.

Edite o template padrão Push Permission Prompt ou crie o seu próprio.

Defina a audiência como: Show to all users Não se preocupe—este tipo de mensagem in-app é automaticamente mostrada apenas para usuários que não se inscreveram para push.

Defina sua audiência como "Show to all users" porque a ação de clique "Push Permission Prompt" garantirá que seja mostrada apenas para as assinaturas não inscritas.

3

Personalizar o design da mensagem

Personalize a aparência, sensação e redação para se adequar ao seu aplicativo. Mantenha claro e útil—informe aos usuários que tipo de notificações eles receberão e por que são valiosas.Consulte Design de Mensagens In-App com Arrastar e Soltar ou Design de mensagens in-app com HTML para detalhes.

O editor de blocos de mensagens in-app permite criar mensagens pedindo aos usuários para optar por notificações push.

4

Adicionar a ação de clique do prompt de permissão push

Adicione uma ação de clique Push Permission Prompt a qualquer botão ou imagem em sua mensagem. Quando tocado, o prompt do sistema é exibido.

O editor de blocos de mensagens in-app permite adicionar uma ação de clique a um botão para solicitar permissão push.

Exemplo do prompt de permissão obrigatório no iOS.

Se um usuário já negou a permissão, o botão irá direcioná-lo para as configurações de notificação do seu aplicativo.
Mensagens in-app que têm uma ação “Push Permission Prompt” não serão mostradas aos usuários que já permitiram notificações.
5

Escolher um gatilho

A audiência controla quem é elegível para ver a mensagem. Os gatilhos controlam quando ela é mostrada.

Opções de gatilho para controlar quando a mensagem é mostrada.

Você pode acionar a mensagem:
  • Na abertura do aplicativo
  • Após um tempo definido de sessão
  • Em um evento específico do usuário
  • Programaticamente (mais controle)
Por exemplo, para esperar até que o usuário tenha passado pelo menos 5 minutos no aplicativo:

Os gatilhos podem ser definidos para cronometrar quando os usuários veem a mensagem in-app.

6

Agendamento e frequência

Você pode controlar com que frequência a mensagem aparece:
  • Apenas uma vez – Baixa chance de conversões
  • Toda vez que as condições forem atendidas – Muito agressivo
  • ✅ Múltiplas vezes – Recomendado
Defina um máximo grande (por exemplo, 9999) e um atraso entre visualizações (por exemplo, 2 semanas) para lembrar gentilmente os usuários ao longo do tempo. Isso significa que a mensagem será mostrada uma vez a cada 2 semanas por um total de 9999 vezes.Queremos que o primeiro número seja uma quantidade muito grande porque sempre queremos solicitar aos usuários não inscritos que se inscrevam, mas não queremos incomodá-los, então pedimos apenas a cada 2 semanas. Você pode alterar a cadência de 2 semanas para mais ou menos dependendo do caso de uso.

Agende quando os usuários começarão a ver sua mensagem in-app e com que frequência eles a veem.

Atualize sua mensagem e ative-a. Agora você pode monitorar suas estatísticas e atualizar o intervalo entre dias conforme necessário.

​
Mostrar programaticamente o prompt de permissão obrigatório

Desenvolvedores: Você pode acionar o prompt de permissão push manualmente usando os métodos SDK requestPermission() ou optIn(). Isso é ótimo para fluxos personalizados, como:

​
Rastrear permissões push e resultados de prompt

Ao usar mensagens in-app para solicitar push, você pode rastrear ações de clique com o listener de clique de mensagem in-app. Para casos em que a mensagem in-app é exibida mas o usuário não clica no botão, você pode ouvir os eventos de ciclo de vida da mensagem in-app. Para rastrear os resultados do prompt de permissão no nível do sistema, você pode ouvir eventos com o listener de permissão push.
Ao usar esses métodos SDK, você pode enviar os eventos para seu backend ou ferramenta de analytics de sua escolha.

​
FAQ

​
Posso ainda solicitar aos usuários com notificações provisórias?

Sim! Na verdade, se você usar notificações push provisórias do iOS, é recomendado ainda solicitar aos usuários para push desta forma, mas seja estratégico!

​
Quando o Android começou a exigir prompts de permissão?

O Android começou a exigir permissão explícita do usuário para notificações push com o Android 13 (nível de API 33), que foi: