Visão geral
O throttling push no OneSignal permite que você controle a taxa na qual notificações push são entregues aos usuários. Isso é particularmente útil para gerenciar capacidade do servidor e garantir uma experiência do usuário suave durante envios de alto volume.Benefícios
- Gerenciar carga do servidor – Previna sobrecarga distribuindo entrega de mensagem ao longo do tempo.
- Preservar desempenho – Evite degradação de desempenho durante envios em massa.
- Melhorar experiência do usuário – Mantenha consistência e responsividade entre dispositivos.
Opções de configuração
O throttling deve ser habilitado no nível de configurações globais para estar disponível para uso.Configurações globais de throttling
Habilite throttling para todas as mensagens push em Settings > Push & In-App > Throttling. Uma vez habilitado, esta configuração se aplica a todas as notificações push por padrão, mas pode ser sobrescrita para mensagens individuais.
Navegar para Configurações de Push Throttling
Substituição de throttling por mensagem
Você pode sobrescrever configurações globais de throttling em mensagens individuais.- Durante a criação da notificação, marque a caixa “Override throttling setting”
- Defina sua taxa desejada de mensagens por minuto
- Para desabilitar throttling para uma mensagem específica, insira “0” no campo mensagens por minuto
throttle_rate_per_minute.
O throttling deve ser habilitado no nível de configurações globais para estar disponível para
qualquer uso.
Como funciona o throttling
Processo de conversão de taxa
O OneSignal converte sua configuração por minuto para uma taxa por segundo para otimizar a entrega:- O sistema divide sua taxa de throttle por 60 (segundos por minuto)
- O resultado é arredondado para baixo para o número inteiro mais próximo (OneSignal não pode enviar mensagens parciais)
- Esta taxa por segundo é então aplicada durante todo o processo de entrega
Exemplo de conversão de throttling
- Você define 1019 mensagens por minuto
- Cálculo 1019 ÷ 60 = 16.98 mensagens por segundo
- Arredondado para baixo 16 mensagens por segundo
- Taxa de entrega real 16 × 60 = 960 mensagens por minuto
- Diferença 59 mensagens a menos por minuto do que a taxa definida
Limitações e Considerações
Janela de Entrega de 24 Horas
Todas as notificações com throttle devem completar a entrega dentro de 24 horas após serem enviadas. Se sua taxa de throttling faria com que a entrega excedesse 24 horas, o OneSignal ajusta automaticamente a taxa para garantir conclusão dentro deste prazo.Exemplo de ajuste automático de throttling
Se você definir uma taxa de throttle de 10 mensagens por minuto para 20.000 usuários (o que
levaria aproximadamente 33 horas), o OneSignal ajustará automaticamente a
taxa para cerca de 14 mensagens por minuto para garantir que a entrega seja concluída dentro da
janela obrigatória de 24 horas.
Compatibilidade com Outros Recursos
Fuso Horário e Intelligent Delivery
O throttling tem precedência sobre as opções de Fuso Horário e Intelligent Delivery. Quando o throttling está habilitado, esses recursos serão ignorados para aquela notificação. Para usar Fuso Horário ou Intelligent Delivery:- Desabilite throttling para aquela notificação específica em Delivery Schedule
- Defina “Override throttling setting” como “0”
- Para notificações via API, defina
throttle_rate_per_minute: 0
Journeys e Mensagens Automatizadas
O throttling não é suportado para:- Journeys
- Mensagens Automatizadas
Notificações enviadas via Journeys ou Mensagens Automatizadas não suportam
throttling. Essas mensagens são programadas automaticamente com base no comportamento do usuário e
não requerem controle manual de taxa.
Disponibilidade
O throttling está disponível apenas para:- Notificações push enviadas via API Create notification
- Notificações push criadas através da interface Messages > New Push