Requisitos
Antes de criar sua mensagem in-app:- Adicione permissões de rastreamento de localização ao seu aplicativo (para Android e iOS).
- Consulte nossa referência de localização do SDK Mobile para instruções de configuração específicas da plataforma.
- Habilite o compartilhamento de localização com o OneSignal no código do seu aplicativo.
Criar sua mensagem
1
Criar sua mensagem
No painel do OneSignal, vá para: Messages > In-App > New In-App
2
Público
- Se todos os usuários devem ver o prompt, selecione Show to all users.
- Caso contrário, direcione um Segmento específico.
3
Design da mensagem
- Explique claramente por que o acesso à localização beneficia o usuário. Por exemplo, “Habilite a localização para receber atualizações locais relevantes.”
- Seja conciso mas específico para aumentar a probabilidade de adesão.

Imagem mostrando blocos in-app e capacidade de adicionar ações de clique junto com visualização
Adicionar a Ação de Clique de Prompt de Permissão de Localização
1
Adicionar um botão ou imagem
Adicione um botão ou imagem com uma chamada para ação clara (por exemplo, “Habilitar Localização”).
2
Adicionar uma ação de clique
Nas opções:
- Clique em Add Click Action
- Selecione Location Permission Prompt
Tanto Android quanto iOS limitam a frequência com que prompts do sistema podem aparecer. Usar este soft pre-prompt ajuda a evitar essas limitações e permite tentativas repetidas se necessário.

Imagem mostrando blocos in-app e capacidade de adicionar ações de clique
Acionar a mensagem in-app
Você pode controlar quando e como o prompt é mostrado.Opção 1: Acionadores baseados em tempo
Mostre a mensagem depois que um usuário esteve no aplicativo por um período definido (por exemplo, após 30 segundos).
Imagem mostrando acionador in-app de sessão.
Opção 2: Acionadores programáticos
Controle exatamente quando o prompt aparece via SDK:1
Adicionar o código de acionador ao aplicativo.
Use o método
addTrigger do nosso SDK para definir uma chave como location_prompt e valor como true. Então chame isso quando quiser dentro do seu aplicativo.2
Adicionar o acionador à mensagem
Defina a mesma chave de acionador (
location_prompt) e valor (true) nas configurações da sua mensagem in-app.
Imagem mostrando acionador In-app programático.
Definir a frequência da mensagem
Para evitar enviar spam aos usuários:- Escolha Multiple times
- Defina um número de vezes para mostrar a mensagem
- Defina um intervalo entre cada tentativa

Exemplo de configuração de agendamento para prompts repetidos.
Melhores Práticas
- Sempre explique o benefício do acesso à localização aos usuários.
- Use segmentação ou acionadores para evitar perguntar em um momento ruim.
- Pre-prompts aumentam as taxas de adesão e evitam limites do sistema operacional.
- Garanta que as permissões de localização estejam configuradas corretamente em seu aplicativo antes de acionar a mensagem in-app.
Você começará a ver pontos de localização sendo rastreados em suas páginas de Usuários e Assinaturas.Crie mensagens acionadas por localização.