Pular para o conteúdo principal
Um prompt de permissão push é o diálogo do sistema operacional que pergunta aos usuários se seu aplicativo pode enviar notificações push. A resposta deles determina se você pode entregar notificações que aparecem como banners, aparecem na tela de bloqueio e reproduzem sons.
Prompts de permissão do sistema no iOS e Android lado a lado

Um dispositivo iOS e Android exibindo o prompt de permissão do sistema.

Trate a solicitação como uma estratégia. O prompt do sistema só pode ser exibido um número limitado de vezes: uma vez no iOS e duas vezes no Android (Google e Huawei). Se o usuário recusar todas as tentativas, ele deverá reativar as notificações manualmente nas configurações do sistema. Um prompt mal cronometrado pode custar permanentemente um assinante, e a audiência alcançável é a maior alavanca sobre o ROI de cada campanha push que você executa. Tanto a Apple quanto o Google recomendam explicar o valor das suas notificações antes de solicitar permissão. Sem contexto, os usuários têm maior probabilidade de recusar, e no iOS um prompt recusado não pode ser exibido novamente. Este guia cobre push de aplicativos móveis. Para push web, consulte Prompts de permissão push web.

Estratégia para uma alta taxa de opt-in

As taxas de opt-in de push dependem muito mais de quando e como você pergunta do que do que o prompt do sistema em si diz. Aplicativos que tratam a solicitação como uma estratégia consistentemente superam aplicativos que solicitam na primeira execução. Os princípios abaixo são os blocos de construção. A estratégia de exemplo abaixo mostra como combiná-los em um manual concreto.

Princípios

  • Pergunte após um momento de valor. Aguarde até que o usuário tenha acabado de vivenciar algo que valha uma notificação: concluir o onboarding, salvar um item, seguir um tópico, fazer um pedido ou finalizar a primeira sessão. Solicitar na primeira abertura, antes que o usuário entenda o que seu aplicativo faz, é a maior causa isolada de baixas taxas de opt-in.
  • Comece com notificações provisórias no iOS. As notificações provisórias são entregues silenciosamente na Central de Notificações sem qualquer prompt, então os usuários decidem se as mantêm com base em conteúdo real em vez de uma explicação hipotética. Esse é frequentemente o caminho de maior conversão no iOS e deve ser seu ponto de partida padrão.
  • Explique o valor com um soft prompt in-app. Um soft prompt é uma mensagem in-app do OneSignal que informa aos usuários que tipo de notificações você enviará e por que elas importam. Dispensar um soft prompt não consome uma tentativa do prompt do sistema, então você pode perguntar novamente a usuários que não estavam prontos.
  • Solicite novamente aos usuários que recusaram o soft prompt, não o prompt do sistema. Configure o soft prompt para reaparecer em uma cadência (por exemplo, a cada 2 semanas). Usuários que não estavam prontos recebem outra chance sem esgotar o limite do prompt do sistema.
  • Itere no texto e no timing. Publique o soft prompt, acompanhe a conversão no relatório da mensagem e ajuste o gatilho, a redação e a frequência. Pequenas mudanças no timing e no texto rotineiramente alteram as taxas de opt-in em dezenas de pontos percentuais.

Exemplo: estratégia de opt-in no onboarding

Este exemplo combina notificações provisórias para alcance imediato no iOS com um soft prompt em um momento de valor para o opt-in completo. Use-o como ponto de partida e adapte os tipos de notificação e os momentos de valor ao seu aplicativo. Para aplicativos Android e Huawei, pule a fase 1 e comece na fase 2. Fase 1: alcance silencioso no iOS
  1. Ative a autorização provisória no painel do OneSignal em Settings > Apple iOS > Advanced Configuration > Enable iOS 12 direct to history.
  2. Envie de 2 a 3 notificações de alta qualidade durante a primeira semana do usuário. Escolha conteúdo que demonstre o valor de se inscrever: uma recomendação personalizada, um alerta de última hora ou um resumo semanal. Os usuários as recebem silenciosamente na Central de Notificações, sem prompt.
Fase 2: converter em um momento de valor
  1. Em Messages > In-App, crie um soft prompt que faça referência ao valor que o usuário já vivenciou. Título de exemplo: “Receba alertas de última hora na sua tela de bloqueio.”
  2. Defina a audiência como Show to all users. A ação de clique Push Permission Prompt filtra automaticamente para usuários não inscritos.
  3. Acione a mensagem em um evento de alto sinal: abrir ou interagir com uma notificação provisória, seguir um tópico, adicionar um item ao carrinho ou 5 minutos de tempo de sessão.
  4. Adicione uma ação de clique Push Permission Prompt ao botão de CTA.
  5. Defina o agendamento como Multiple times com máximo por usuário 20 e intervalo entre exibições de 2 weeks (cerca de 10 meses de re-solicitação).
Fase 3: medir e iterar
  1. Após 1 a 2 semanas, verifique o relatório da mensagem para a conversão de prompt para opt-in.
  2. Instrumente o funil completo com os listeners do SDK: cliques no soft prompt, dispensas e o resultado do prompt do sistema. Encaminhe os eventos para sua ferramenta de analytics.
  3. Ajuste uma variável de cada vez (evento de gatilho, título, texto do CTA ou intervalo entre exibições) com base nos números.
Acione o soft prompt logo após o usuário abrir ou interagir com uma notificação provisória. Ele já viu valor nas suas notificações, o que aumenta significativamente a taxa de “Allow” no prompt do sistema.

Escolher uma abordagem

Você tem três formas de aumentar sua base de assinantes push com o OneSignal. A maioria dos aplicativos iOS deve combinar notificações provisórias com um soft prompt in-app; a maioria dos aplicativos Android deve começar pelo soft prompt. As três podem ser combinadas. Um padrão comum de alto desempenho no iOS é habilitar as notificações provisórias para alcance silencioso imediato, exibir um soft prompt em um momento de valor e expor um prompt programático a partir de uma central de preferências para usuários que queiram fazer opt-in sob demanda.
Mensagem in-app levando ao prompt de permissão push do sistema

Um soft prompt in-app seguido pelo prompt de permissão do sistema.


Pré-requisitos


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 ainda não está acionando o prompt de permissão do sistema automaticamente:
  • Remova quaisquer chamadas de requestPermission() ou optIn() invocadas na inicialização do aplicativo.
  • Remova chamadas nativas do iOS para requestAuthorizationWithOptions e qualquer código que gere tokens push diretamente.
  • Remova chamadas do Android para requestPermissions e qualquer código que gere tokens push diretamente.
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.
Lista de mensagens in-app do OneSignal exibindo o template Push Permission Prompt

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

Defina a audiência como Show to all users. O OneSignal filtra automaticamente esta mensagem apenas para usuários que ainda não se inscreveram em push, com base na ação de clique Push Permission Prompt.
Configuração de audiência definida para mostrar a todos os usuários

Defina a audiência como 'Show to all users'. A ação de clique Push Permission Prompt filtra automaticamente para usuários não inscritos.

3

Personalizar o design da mensagem

Personalize a aparência, a sensação e a redação para se adequar ao seu aplicativo. Diga aos usuários que tipo de notificações eles receberão e por que elas são valiosas.Consulte Design de mensagens in-app com arrastar e soltar ou Design de mensagens in-app com HTML para detalhes.
Editor de blocos de mensagens in-app com um prompt de opt-in push

O editor de blocos de mensagens in-app para criar mensagens de opt-in push.

4

Adicionar a ação de clique Push Permission Prompt

Adicione uma ação de clique Push Permission Prompt a qualquer botão ou imagem da sua mensagem. Quando tocada, o prompt de permissão do sistema aparece.
Dropdown de ação de clique com Push Permission Prompt selecionado

Adicionando uma ação de clique Push Permission Prompt a um botão.

Prompt nativo de permissão de notificação push do iOS

O prompt de permissão do sistema acionado pela ação de clique no iOS.

Se o usuário já recusou o prompt de permissão do sistema o número máximo de vezes (uma vez no iOS, duas vezes no Android), a ação de clique o envia para as configurações de notificação do seu aplicativo. Isso equivale a chamar requestPermission(fallbackToSettings: true) do SDK.
Mensagens in-app com uma ação de clique Push Permission Prompt não são exibidas para usuários que já permitiram notificações.
5

Escolher um gatilho

A audiência controla quem está apto a ver a mensagem. Os gatilhos controlam quando ela aparece. Procure acionar o prompt em um momento de valor: um ponto em que o usuário acabou de vivenciar algo que vale uma notificação.
Painel de configuração de gatilhos de mensagens in-app

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

Opções de gatilho, ordenadas aproximadamente da menor para a maior conversão:
  • Na abertura do aplicativo. Simples, mas raramente ideal. Use apenas se o valor do aplicativo for óbvio em segundos.
  • Após uma certa quantidade de tempo de sessão. Um bom padrão. Aguarda até que o usuário tenha explorado o aplicativo antes de perguntar.
  • Em um evento específico do usuário. Melhor para conversão. Acione após ações de alto sinal, como concluir o onboarding, salvar um item, seguir um tópico ou finalizar uma primeira compra.
  • Programaticamente, usando os métodos SDK de gatilho de mensagem in-app. Controle total sobre o timing e o contexto, incluindo combinar múltiplos sinais antes de solicitar.
Por exemplo, para aguardar até que o usuário tenha passado ao menos 5 minutos no aplicativo:
Gatilho de duração de sessão definido para 5 minutos

Gatilho configurado para exibir a mensagem após 5 minutos de tempo de sessão.

6

Agendamento e frequência

Controle com que frequência a mensagem aparece:
  • Only once. Baixa chance de converter usuários que não estavam prontos na primeira vez.
  • Every time conditions are met. Muito agressivo e pode incomodar os usuários.
  • Multiple times (recomendado). Defina um máximo por usuário com um intervalo entre exibições. Por exemplo, 20 exibições com intervalo de 2 weeks reapresenta o prompt a usuários não inscritos por cerca de 10 meses em uma cadência agressiva. Afrouxe o intervalo (por exemplo, 30 days ou 60 days) para aplicativos de menor engajamento ou utilitários em que uma cadência de 2 semanas pareça insistente.
Configuração de agendamento exibindo máximo de exibições e intervalo entre visualizações

Configurações de agendamento e frequência da mensagem in-app.


Exibir programaticamente o prompt de permissão

Você pode acionar o prompt de permissão do sistema manualmente usando os métodos SDK requestPermission() ou optIn(). Isso é útil para fluxos personalizados como: Passe fallbackToSettings: true para requestPermission() para que os usuários que já recusaram sejam redirecionados para as configurações de notificação do aplicativo em vez de silenciosamente não fazer nada.
Se uma assinatura foi retirada no nível do SDK via optOut() (exibida como notification_types: -2 no registro da assinatura), requestPermission() sozinho não alterará o status da assinatura. Use optIn() em vez disso. Ele solicita permissão e limpa o estado de opt-out.

Usar notificações provisórias do iOS

As notificações push provisórias foram introduzidas no iOS 12. Elas permitem entregar notificações à Central de Notificações sem exibir um prompt de permissão. Os usuários veem conteúdo real do seu aplicativo e decidem se querem manter, silenciar ou desativar as notificações com base nessa experiência. Por que funciona como estratégia:
  • Nenhum prompt do sistema para falhar. Você pode começar a alcançar os usuários já na primeira sessão, sem qualquer decisão prévia de opt-in.
  • Os usuários decidem com base em valor real, não em uma explicação hipotética.
  • Você ainda pode exibir um soft prompt depois para converter usuários provisórios em assinantes push completos, com banners, som e alertas na tela de bloqueio.
Compensações. As notificações provisórias têm visibilidade reduzida. Elas são entregues silenciosamente apenas na Central de Notificações: sem banner, sem som e sem alerta na tela de bloqueio, até que o usuário faça upgrade para a permissão completa.
Notificação push provisória do iOS com opções Keep e Turn Off

Uma notificação provisória solicitando ao usuário que mantenha ou desative as notificações.

Para ativar a autorização provisória, vá para o painel do OneSignal em Settings > Apple iOS > Advanced Configuration e marque Enable iOS 12 direct to history. Para o passo a passo completo, incluindo como os usuários interagem com notificações provisórias e como elas se combinam com o prompt padrão, consulte Notificações push provisórias do iOS.
Para um manual concreto que combina notificações provisórias com um soft prompt em um momento de valor, consulte o exemplo de estratégia de opt-in no onboarding.

Rastrear permissões push e resultados de prompt

Você pode encaminhar esses eventos do SDK para seu backend ou ferramenta de analytics de sua escolha.

FAQ

O que acontece se um usuário recusar o prompt de permissão do sistema?

No iOS, recusar o prompt de permissão do sistema desativa permanentemente as notificações push do seu aplicativo. O prompt não pode ser exibido novamente. No Android, o usuário tem mais uma chance (duas no total). Depois que todas as tentativas forem usadas, o usuário deve reativar as notificações manualmente em Configurações > Notificações no dispositivo. Tanto a ação de clique Push Permission Prompt quanto requestPermission(fallbackToSettings: true) lidam com isso enviando o usuário diretamente para as configurações de notificação.

Posso personalizar o prompt de permissão nativo do sistema?

Não. O prompt de permissão do sistema no iOS e Android é controlado pelo sistema operacional e não pode ser personalizado. Você só pode personalizar o soft prompt (a mensagem in-app exibida antes dele). Use o soft prompt para explicar o valor das suas notificações, definir expectativas e aumentar a chance de um “Allow” no prompt do sistema.

Posso solicitar aos usuários que têm notificações provisórias?

Sim, e você deve. Usuários provisórios são candidatos ideais para um soft prompt porque já viram notificações reais do seu aplicativo. Consulte Usar notificações provisórias do iOS para o padrão recomendado. Programe o soft prompt para logo depois que o usuário abrir ou interagir com uma notificação provisória.

Como solicito novamente aos usuários que recusaram push anteriormente?

Depois que o prompt de permissão do sistema tiver se esgotado (uma vez no iOS, duas vezes no Android), você não pode exibi-lo novamente. Em vez disso, use o método SDK requestPermission(fallbackToSettings: true) ou a ação de clique Push Permission Prompt em uma mensagem in-app. Ambos abrem as configurações de notificação do seu aplicativo para que o usuário possa habilitar as notificações manualmente. Combine isso com uma mensagem in-app explicando por que as notificações são valiosas.

Todas as versões do Android exigem um prompt de permissão do sistema?

Não. Apenas o Android 13 (API nível 33) e posteriores. O Android 13 introduziu a permissão de notificação em tempo de execução, exigindo consentimento explícito do usuário para notificações push. No Android 12 e anteriores, o aplicativo recebe permissão de notificação automaticamente na instalação.

Notificações push provisórias do iOS

Envie notificações para a Central de Notificações sem um prompt de permissão antecipado no iOS 12+.

Referência do SDK móvel

APIs de requestPermission, optIn, observador de permissão e listener de clique in-app.

Prompts de permissão push web

Configure soft prompts, slide-down e solicitações nativas de permissão push web.

Configuração de mensagens in-app

Habilite mensagens in-app no seu aplicativo para poder executar soft prompts.