Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

O OneSignal ajuda você a alcançar seus usuários de forma eficaz—sem sobrecarregá-los. Enviar muitas mensagens pode levar a cancelamentos de inscrição, desengajamento ou uma experiência ruim do usuário. A Limitação de Frequência permite que você controle a frequência com que os usuários recebem notificações push do seu aplicativo, definindo limites no número de mensagens enviadas por minuto, hora, dia ou semana.
A Limitação de Frequência está disponível em Planos Pagos selecionados.

​
Como funciona a limitação de frequência

Exemplo: Definindo um limite de frequência de 3 notificações por período de 24h Dia 1:
  • 9:00 AM: Enviar Notificação 1. Usuário recebe Notificação 1. (Contagem: 1) ✅
  • 1:00 PM: Enviar Notificação 2. Usuário recebe Notificação 2. (Contagem: 2) ✅
  • 5:00 PM: Enviar Notificação 3. Usuário recebe Notificação 3. (Contagem: 3) ✅
O usuário agora atingiu o limite de 3 notificações para sua janela móvel de 24 horas, que começou às 9:00 AM no Dia 1. Dia 2:
  • 8:00 AM: Enviar Notificação 4. Usuário está limitado e não recebe Notificação 4 porque a janela de 24 horas das 9:00 AM do Dia 1 ainda não expirou. A contagem ainda está em 3.
  • 9:00 AM: A janela de 24 horas da Notificação 1 (9:00 AM do Dia 1) é redefinida. A contagem cai para 2. O usuário agora pode receber outra notificação.
  • 9:01 AM: Enviar Notificação 5. Usuário recebe Notificação 5. (Contagem: 3) ✅
  • 10:00 AM: Enviar Notificação 6. Usuário está limitado e não recebe Notificação 6.
  • 11:00 AM: Enviar Notificação 7. Usuário está limitado e não recebe Notificação 7.
  • 1:00 PM: A janela de 24 horas da Notificação 2 (1:00 PM do Dia 1) é redefinida. A contagem cai para 2.
  • 2:00 PM: Enviar Notificação 8. Usuário recebe Notificação 8. (Contagem: 3) ✅
Neste exemplo, as notificações 4, 6 e 7 seriam limitadas e não entregues ao usuário, enquanto 1, 2, 3, 5 e 8 seriam entregues.

​
Quando usar a limitação de frequência

A Limitação de Frequência é particularmente útil em cenários onde o volume de mensagens pode se tornar excessivo:
  • Ambientes de Campanha Complexos: Grandes organizações com várias equipes ou campanhas de marketing sobrepostas.
  • Gatilhos de Alta Frequência: Sistemas que enviam notificações com base em eventos frequentes (por exemplo, atualizações de preços de ações ou alertas de notícias automatizados).

​
Como habilitar a limitação de frequência

Você pode configurar a limitação de frequência no nível do aplicativo através do Painel OneSignal:
1
Navegue até Configurações > Push & In-app > Limitação de Frequência.
2
Defina o número máximo de mensagens que um usuário pode receber em um determinado período de tempo.

​
Notas importantes

  • A limitação se aplica a todas as mensagens push, independentemente da origem (API, Journeys ou envios manuais).
  • Mensagens bloqueadas devido à limitação são descartadas, não enfileiradas para depois.
Por exemplo, se o limite estiver definido como 2/dia e um usuário já recebeu 2 mensagens de API, uma mensagem de Journey será descartada, a menos que a limitação seja sobreposta.

​
Sobrepor a limitação de frequência

Em alguns casos, você pode querer enviar uma mensagem mesmo que exceda o limite. Você pode sobrepor a limitação de frequência por mensagem:
No Agendamento de Entrega da mensagem, selecione Sobrepor configurações de limitação de frequência.

​
Notas sobre sobrepor

  • A limitação de frequência deve estar habilitada no painel OneSignal.
  • Mensagens sobrepostas ainda contam para o limite. Isso afeta se mensagens futuras serão entregues.

​
Relatórios

Quando a limitação está habilitada, você pode monitorar como ela impacta suas notificações através de relatórios de mensagens do painel ou visualizar a API de mensagem. Cada mensagem com limitação habilitada mostrará um status de:
  • Limitada: A limitação de frequência está habilitada para o aplicativo e quantas foram limitadas.
  • Sobreposta: A limitação de frequência está habilitada para o aplicativo, mas foi sobreposta para a notificação.