Métricas de entrega
O OneSignal envia notificações push para serviços push (Google FCM, Apple APNs, Huawei HMS) que as entregam aos dispositivos dos seus usuários (Assinaturas). As métricas Entregues, Cancelados e Falhos vêm desses serviços push. As métricas de Entrega Confirmada e Clicados vêm do SDK do OneSignal no dispositivo.| Métrica | Definição |
|---|---|
| Enviados | O número de mensagens enviadas com sucesso do OneSignal ao provedor. |
| Total Tentado | O número de mensagens que tentamos enviar. Métrica derivada calculada como Enviados + Limitados por frequência. |
| Audiência | O número de assinaturas nos segmentos alvo. |
| Entregues | O número de Assinaturas push para as quais o serviço push entregou a mensagem. |
| Cancelados | O número de Assinaturas push que não receberam a mensagem porque desinstalaram o aplicativo, limparam dados do navegador ou optaram por não receber push e não abriram o aplicativo desde então. |
| Falhos | O número de Assinaturas push que não receberam a mensagem devido a um erro. Consulte Solução de problemas de mensagem de falha. |
| Cliques | O número de cliques em uma notificação. |
| Limitados por frequência | O número de Assinaturas push para as quais a notificação não foi enviada devido às configurações de limite de frequência. |
| Entrega Confirmada | O número de Assinaturas push que confirmaram o recebimento da mensagem. |
| Restantes | O número de notificações ainda em fila no lado do OneSignal para envio. |
| Taxa de Cliques | Calculado como (Cliques / Entregues) * 100%. |
| CTR Confirmado | Calculado como (Cliques / Entrega Confirmada) * 100%. |
| Aberturas Influenciadas | O número de aberturas de aplicativo que ocorreram após receber a notificação, sem clicar. Baseado na janela de tempo definida em Settings > Push & In-App > Influenced Opens. |
Para definições detalhadas de métricas em todos os canais, consulte o Glossário de Métricas.
Solução de problemas de mensagem de falha
Estes erros impediram o OneSignal de entregar a mensagem ao provedor push:| Erro | Tipo | Etapas de Solução de Problemas |
|---|---|---|
| 401 Unauthorized | Web | O servidor push web deu um erro 401 não claro. Tente novamente com cautela — pode causar envios duplicados. |
| 404 Not Found | Web | Endpoint de assinatura push inválido (token ruim). |
| Authentication Error | FCM | Verifique suas credenciais FCM, faça o upload novamente do arquivo da conta de serviço e tente novamente. |
| DeviceTokenNotForTopic | APNs | O Bundle ID do token não corresponde à sua chave ou certificado APNs. Corrija no token p8 ou configuração p12. |
| Expired Certificate | APNs | Seu certificado p12 expirou. Consulte configuração de certificado. |
| FcmV1InvalidToken / Not Found | FCM | Token push inválido. Verifique as credenciais do Firebase. Os dispositivos devem reabrir o aplicativo para atualizar tokens. |
| None / Missing | FCM | A API do Firebase Cloud Messaging pode não estar habilitada em seu projeto. Ative no Console do Firebase e tente novamente. |
| Permission Denied | FCM | Verifique a mensagem de erro completa para saber qual permissão está faltando. Atualize a permissão para o arquivo da Conta de Serviço e faça o upload novamente para o OneSignal. |
| SenderIdMismatch | FCM | Incompatibilidade de Sender ID do FCM v1. Verifique as credenciais do Firebase. Os usuários devem reabrir o aplicativo para tokens atualizados. |
| TopicDisallowed | APNs | Incompatibilidade de token APNs. Verifique seu Team ID, Key ID e Bundle ID na configuração p8. |
Status de entrega
| Status | Descrição |
|---|---|
| Entregue | O serviço push relatou a entrega da mensagem aos destinatários. |
| Agendado | A mensagem está agendada para entrega futura. |
| Enviando | A mensagem está sendo enviada ativamente. |
| Na fila | A mensagem está esperando para ser enviada. |
| Cancelado | A mensagem foi cancelada manualmente. Consulte Cancelar notificações push. |
| Sem Destinatários | Nenhuma audiência válida no momento do envio (por exemplo, cancelada ou fora do segmento). |
| Falhou | O OneSignal não pôde enviar a mensagem devido a erros. |
Conversões
Em breve — As métricas de conversão estarão disponíveis nos relatórios de mensagens. Quando disponíveis, você verá as conversões atribuídas e influenciadas para cada mensagem diretamente em seu relatório. Consulte Métricas de conversão para obter detalhes sobre o modelo de atribuição e instruções de configuração.
Estatísticas de mensagem
O gráfico de estatísticas de mensagem rastreia cliques, sessões e resultados personalizados (legado, sendo substituído por métricas de Conversão) durante os 30 dias após um envio. Use-o para ver se o engajamento ocorreu imediatamente após a entrega ou continuou ao longo do tempo.
Atividade da audiência
O relatório de Atividade da audiência mostra como cada Assinatura interagiu com uma mensagem específica. Os resultados são agrupados em categorias para que você possa diagnosticar problemas de entrega, medir engajamento, identificar cancelamentos vinculados a uma mensagem específica e segmentar audiências para retargeting ou exportação.
- Categorias
- Colunas da tabela
| Categoria | Descrição |
|---|---|
| Enviado | A mensagem foi enviada ao dispositivo. |
| Entrega Confirmada | A entrega foi confirmada pelo dispositivo. |
| Não Confirmou Entrega | A confirmação de entrega não foi recebida. |
| Clicado | O usuário clicou na notificação. |
| Não Clicou | O usuário não clicou na notificação. |
| Falhou | A entrega falhou. |
| Cancelado | A assinatura cancelou após receber a mensagem. |
Retargeting de audiências
Na visualização Atividade da audiência, você pode enviar uma Mensagem Retargeted diretamente para qualquer categoria (por exemplo, todos os usuários que não clicaram). Isso facilita o acompanhamento de usuários que não se engajaram, reengajar aqueles que cancelaram ou reforçar o sucesso com usuários que confirmaram a entrega.Exportar resultados
Você pode baixar dados da audiência com o menu Export:- Selected activity – exporta apenas a aba visualizada atualmente (por exemplo, todos os usuários cuja entrega falhou).
- All activities – exporta o relatório completo em todas as categorias.
Exportando dados
Exporte dados de mensagens e usuários para CSV para análise offline.
Configurações da mensagem
O painel de configurações da mensagem exibe a configuração usada para o envio.- Audiência - Detalhes da audiência incluindo:
- Número total de destinatários - Quantas Assinaturas receberam a mensagem
- Como a mensagem foi enviada: Filtros de segmentação ou segmentos usados
- Agendamento - Quando a mensagem começou a enviar e opções de entrega por usuário selecionadas, se houver.
- Limitação - Qualquer limitação, limites de frequência ou substituições de canal
- Mensagem - O conteúdo da mensagem.
- Plataformas segmentadas (Android, iOS, navegadores específicos)
- Configurações Avançadas - Como Prioridade, Tempo de vida e Collapse ID.
- Dados Adicionais - Quaisquer dados personalizados adicionados à mensagem.
Perguntas frequentes
Quando os status de assinatura push são atualizados?
Os status de assinatura push são atualizados por dois mecanismos: 1. Quando o usuário abre seu aplicativo ou site O SDK do OneSignal verifica se o token push é válido e se as permissões de notificação ainda estão concedidas, depois atualiza o status da assinatura imediatamente. Por exemplo, se um usuário desabilitar as notificações push nas configurações do dispositivo e depois reabrir seu aplicativo, o SDK detecta a mudança e marca a assinatura como Cancelado imediatamente. Você pode capturar essas mudanças com o Observador de Assinatura do SDK (mobile | web) para sincronizar o status com seu próprio banco de dados. 2. Quando você envia notificações push Se um usuário desinstalar seu aplicativo, limpar dados do navegador, ou desabilitar push e nunca retornar, o OneSignal não pode detectar a mudança até que você envie uma notificação. O serviço push (FCM, APNs, HMS) reporta o token como inválido, e o OneSignal marca a assinatura como Cancelado. Esta detecção tipicamente leva 2 ou mais mensagens:| Envio | O que acontece |
|---|---|
| Mensagem 1 | Entregue ao dispositivo. O usuário então cancela nas configurações do dispositivo ou desinstala o aplicativo. |
| Mensagem 2 | O serviço push aceita a mensagem mas o dispositivo não a recebe. O OneSignal reporta “Entregue” porque o serviço push ainda não rejeitou o token. |
| Mensagem 3 | O serviço push rejeita o token. O OneSignal marca a assinatura como Cancelado. |
| Mensagem 4+ | O OneSignal não tenta entregar a esta assinatura. |
Por que meus números de Entregues não correspondem à Entrega Confirmada?
Entregues reflete o que o serviço push (FCM, APNs) reportou — ele aceitou a mensagem para entrega. Entrega Confirmada requer que o SDK do OneSignal no dispositivo reporte de volta, o que só acontece se o dispositivo estiver online e o aplicativo processar a notificação. Dispositivos offline, com o aplicativo fechado à força, ou sem o SDK aparecerão como Entregues mas não como Confirmados.Por quanto tempo os dados de atividade da audiência ficam disponíveis?
Os dados de atividade da audiência são retidos por 30 dias a partir do momento em que a mensagem é enviada. Exporte seus resultados antes que esta janela feche se você precisar mantê-los por mais tempo.Páginas relacionadas
Entrega Confirmada
Como funciona a confirmação de entrega no nível do dispositivo e o que afeta as taxas de confirmação.
Glossário de Métricas
Definições de todas as métricas de entrega, engajamento e conversão em todos os canais.
Análise de Templates
Rastreie o desempenho de notificações push em envios usando templates.
Limitação de push
Controle a taxa de entrega para gerenciar a carga do servidor durante envios de alto volume.