> ## 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.
# Relatórios de mensagens push
> Os relatórios de mensagens push mostram resultados de entrega, entrega confirmada, diagnósticos de falhas, taxas de cliques e atividade de audiência por assinatura para cada envio push.
Os relatórios de mensagens push ajudam você a rastrear o desempenho de cada notificação push, incluindo resultados de entrega, engajamento do usuário (CTR), confirmações no nível do dispositivo e diagnóstico de erros.
***
## 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](./confirmed-delivery) 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](#failure-message-troubleshooting). |
| **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](./analytics-metrics-glossary).
### 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](./android-firebase-credentials), faça o upload novamente do arquivo da conta de serviço e tente novamente. |
| **[DeviceTokenNotForTopic](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CommunicatingwithAPNs.html)** | APNs | O Bundle ID do token não corresponde à sua chave ou certificado APNs. Corrija no [token p8](./ios-p8-token-based-connection-to-apns) ou [configuração p12](./ios-p12-generate-certificates). |
| **Expired Certificate** | APNs | Seu certificado p12 expirou. Consulte [configuração de certificado](./ios-p12-generate-certificates). |
| **FcmV1InvalidToken / Not Found** | FCM | Token push inválido. Verifique as [credenciais do Firebase](./android-firebase-credentials). 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](./android-firebase-credentials) e faça o upload novamente para o OneSignal. |
| **SenderIdMismatch** | FCM | Incompatibilidade de Sender ID do FCM v1. Verifique as [credenciais do Firebase](./android-firebase-credentials). Os usuários devem reabrir o aplicativo para tokens atualizados. |
| **[TopicDisallowed](https://developer.apple.com/documentation/usernotifications/handling-notification-responses-from-apns)** | APNs | Incompatibilidade de token APNs. Verifique seu Team ID, Key ID e Bundle ID na [configuração p8](./ios-p8-token-based-connection-to-apns). |
***
## 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](./push#cancel-push-notifications). |
| **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](/docs/pt-BR/conversion-metrics) 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](/docs/pt-BR/conversion-metrics) 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](./custom-outcomes) (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.
Mensagens enviadas via API do OneSignal são retidas apenas por 30 dias. Use [Análise de Templates](./template-analytics) para rastrear o desempenho ao longo do tempo, ou [exporte seus dados](./exporting-data) para análise offline.
***
## 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.
| 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. |
Cada aba exibe o número de destinatários naquela categoria e permite que você aprofunde nos registros individuais de assinatura.
| Coluna | Descrição |
| ------------------------ | ---------------------------------------------------------------------- |
| **External ID** | Seu identificador de sistema (se definido). |
| **OneSignal ID** | ID de usuário único do OneSignal. |
| **Subscription ID** | Instância de assinatura única (dispositivo + app/navegador). |
| **Dispositivo** | Tipo de navegador ou OS. Se você vir `()`, o dispositivo foi excluído. |
| **Status da Assinatura** | Status atual (por exemplo, Subscribed, Unsubscribed). |
| **Enviado** | Hora em que a mensagem foi enviada. |
| **Entrega Confirmada** | Hora em que a entrega foi confirmada pelo dispositivo, ou `-` se não. |
| **Clicado** | Timestamp se o usuário clicou, ou `-` se não. |
| **Falhou** | Indica se a entrega falhou. |
| **Cancelado** | Indica se o usuário cancelou após receber a mensagem. |
| **Mensagem de falha** | Mensagem de erro se a entrega falhou (por exemplo, "Invalid token"). |
Os dados de atividade da audiência estão disponíveis apenas por **30 dias** a partir do momento em que a mensagem é enviada. Exporte os resultados se precisar retê-los por mais tempo.
### 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.
As exportações permitem que você analise resultados offline, compartilhe com outras equipes ou mescle com suas ferramentas de CRM e analytics.
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](./mobile-sdk-reference#addobserver-push-subscription-changes) | [web](./web-sdk-reference#addeventlistener-push-subscription-changes)) 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. |
Use [Event Streams](./event-streams) para detectar cancelamentos em tempo real ao enviar mensagens.
Se você passar longos períodos sem enviar para todos os usuários, os cancelamentos se acumulam silenciosamente e aparecem como um grande pico quando você retoma o envio. Envie para todos os usuários pelo menos uma ou duas vezes por mês para detectar cancelamentos gradualmente. Consulte o [FAQ de tokens FCM expirados](./fcm-expired-token-faq) para mais informações sobre picos de cancelamento.
A Apple atrasa o reporte de cancelamentos em 14 dias ou mais. Para proteger a privacidade do usuário, a Apple não reporta imediatamente desinstalações ou revogações de permissão. Se um usuário abrir seu aplicativo após desabilitar push, o OneSignal detecta a mudança instantaneamente via SDK. Se o usuário nunca mais abrir o aplicativo, pode levar várias semanas para a Apple reportar o token inválido. Consulte o [Apple Forum](https://developer.apple.com/forums/thread/670868) e a [Technical Note](https://developer.apple.com/library/archive/technotes/tn2265/_index.html#//apple_ref/doc/uid/DTS40010376-CH1-TNTAG34) para mais detalhes.
Use o dashboard ou API para [excluir assinaturas antigas](./delete-users) para manter sua audiência limpa.
### 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
Como funciona a confirmação de entrega no nível do dispositivo e o que afeta as taxas de confirmação.
Definições de todas as métricas de entrega, engajamento e conversão em todos os canais.
Rastreie o desempenho de notificações push em envios usando templates.
Controle a taxa de entrega para gerenciar a carga do servidor durante envios de alto volume.