> ## 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 de email

> Rastreie entrega de email, aberturas, cliques, rejeições, supressões e relatórios de spam nos relatórios de mensagens de email do OneSignal.

Relatórios de mensagens de email exibem estatísticas de entrega, taxa de abertura, taxa de cliques e diagnósticos de erro para cada email. Os relatórios atualizam em tempo real conforme os destinatários interagem com a mensagem.

<Note>
  Se o email for enviado via Journey ou usando Templates, veja [Journey Analytics](./journeys-analytics) ou [Template Analytics](./template-analytics) para detalhes adicionais.
</Note>

<Frame caption="Visualização de snapshot de dados de mensagem de email em tempo real">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c4f0241-Frame_16310.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=d811b41ef15ec7fc17978750e6d2be86" alt="Relatório de mensagem de email mostrando estatísticas de entrega e métricas de engajamento" width="1201" height="531" data-path="images/docs/c4f0241-Frame_16310.png" />
</Frame>

## Estatísticas de entrega

Audience Activity e dados de mensagens enviadas via API são retidos por \~30 dias. Para reter desempenho histórico, exporte dados usando o Dashboard ou API. Veja [Exportando Dados](./exporting-data).

### Delivered

Entenda quantos destinatários receberam sua mensagem, e por que outros não receberam.

| Metric               | Definition                                                                                                                                                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sent**             | The number of emails sent from OneSignal, including both those successfully sent to the email service provider and failures. This is a composite metric.                                                                              |
| **Audience**         | The number of Subscriptions in the targeted Segment(s).                                                                                                                                                                               |
| **Remaining**        | The number of Subscriptions in the target audience that haven't yet received the email (queued or in flight). Appears on the dashboard delivery report.                                                                               |
| **Delivered**        | The number of emails successfully delivered to the recipient's inbox server.                                                                                                                                                          |
| **Failed**           | The number of emails unable to be delivered to the inbox, excluding bounces. May include failures reported by the ESP or OneSignal delivery failures.                                                                                 |
| **Suppressed**       | The number of emails blocked due to prior bounces or spam reports to protect sender reputation. Only recorded for apps configured to use OneSignal email.                                                                             |
| **Bounced**          | The number of emails rejected due to invalid addresses, full inboxes, sender reputation, or DMARC issues. These addresses are added to a [Suppression List](/docs/en/suppressions), either managed by OneSignal or a third party ESP. |
| **Reported as Spam** | The number of recipients who marked the email as spam. These addresses are added to a [Suppression List](/docs/en/suppressions), either managed by OneSignal or a third party ESP.                                                    |
| **Unsubscribed**     | The number of recipients who opted out of receiving emails.                                                                                                                                                                           |
| **Total Opens**      | The total number of times the email was opened, including repeats.                                                                                                                                                                    |
| **Total Clicks**     | The total number of times a link in the email was clicked, including repeats.                                                                                                                                                         |
| **Unique Opens**     | The number of individual Subscriptions who opened the email. Used with Delivered to calculate the open rate.                                                                                                                          |
| **Unique Clicks**    | The number of individual Subscriptions who clicked a link in the email. Used with Delivered to calculate the click rate.                                                                                                              |

**Total vs Unique clicks and opens**

Unique clicks and opens are counted once per Subscription, regardless of how many times that user opens or clicks the same email. Total clicks and opens count every interaction, including repeats from the same user.

As seguintes métricas são específicas para relatórios de mensagens de email:

| Nome          | Descrição                                                                                                                                                                                    |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Remaining** | Emails ainda em fila para envio. Pode levar até 8 horas dependendo da sua [Reputação](./email-deliverability) e das políticas do provedor de caixa de entrada (Gmail, Yahoo, Outlook, etc.). |

Para definições detalhadas de métricas em todos os canais, veja o [Glossário de Métricas](./analytics-metrics-glossary).

### Open rate

Eventos de abertura são contados quando o email é visualizado, embora configurações de privacidade e comportamento da caixa de entrada possam afetar a precisão. Veja [Por que eventos de abertura estão baixos?](#why-are-open-events-low%3F).

| Nome             | Descrição                                                                                            |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| **Unique Opens** | Contagem de destinatários individuais que abriram o email.                                           |
| **Total Opens**  | Número total de vezes que o email foi aberto, incluindo repetições.                                  |
| **Open Rate**    | `(Unique Opens / Delivered) * 100%`. Mede quantos emails entregues foram abertos pelo menos uma vez. |

<Info>
  **Unique vs. Total Opens**

  * **Open Rate** é sempre baseada em aberturas únicas.
  * Use **Total Opens** para ver engajamento repetido dos mesmos destinatários.
</Info>

<Warning>
  A precisão da taxa de abertura pode ser afetada por recursos de privacidade da caixa de entrada (por exemplo, Apple Mail Privacy Protection), bloqueadores de anúncios e rastreamento de imagens sendo desabilitado. Esses fatores podem causar aberturas sendo **super-reportadas** (devido ao pré-carregamento automático de imagens) ou **sub-reportadas** (quando pixels de rastreamento são bloqueados).

  Para insights de engajamento mais confiáveis, compare Taxa de Abertura com **CTR** e **CTOR**.
</Warning>

### Click-through rate

Meça engajamento através de cliques em links em seu email. O rastreamento de cliques pode ser habilitado ou desabilitado por envio de email. Para mais sobre comportamento de links, veja [URLs, links e deep links](./links) e [Links de cancelamento de assinatura e cabeçalhos de email](./unsubscribe-links-email-subscriptions).

| Nome                          | Descrição                                                                                                                                                                                     |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Click-Through Rate (CTR)**  | `(Unique Clicks / Delivered) * 100%`. Mede quantos emails entregues resultaram em um clique. Requer que [Rastreamento de Cliques esteja habilitado](./unsubscribe-links-email-subscriptions). |
| **Total Clicks**              | Todos os cliques em links, incluindo cliques repetidos do mesmo usuário. Veja [URLs, Links and Deep Links](./links).                                                                          |
| **Click to Open Rate (CTOR)** | `(Unique Clicks / Unique Opens) * 100%`. Mede quão engajador foi o email depois de ser aberto.                                                                                                |

<Info>
  **CTR vs CTOR** — CTR mede cliques como porcentagem de entregas; CTOR mede cliques como porcentagem de aberturas. Use ambos para avaliar qualidade da mensagem. Adicione parâmetros UTM aos links para rastreamento em ferramentas como Google Analytics.
</Info>

<Warning>
  Se Rastreamento de Cliques está habilitado mas eventos de clique estão baixos, verifique por bloqueio em nível de navegador (por exemplo, Brave ou Firefox). Entre em contato com `support@onesignal.com` se o problema persistir.
</Warning>

### Unsubscribed and reported as spam

Entenda opt-outs e reclamações de spam para que você possa melhorar segmentação e entregabilidade.

| Nome                 | Descrição                                                                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Unsubscribes**     | Número de destinatários que optaram por não receber emails. Status é atualizado imediatamente.                                             |
| **Reported as Spam** | Destinatários que marcaram sua mensagem como spam. Esses endereços são automaticamente adicionados à [Lista de Supressão](./suppressions). |

<Warning>
  Monitore taxas de cancelamento e spam de perto. Taxas muito altas podem resultar na desabilitação do seu app. Use segmentação e otimização de tempo de envio para reduzir reclamações. Veja [Entregabilidade de Email](./email-deliverability) e [Melhores práticas de reputação de email](./email-reputation-best-practices).
</Warning>

***

## Conversões

<Info>
  **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.
</Info>

***

## Message statistics

Analise tendências de desempenho ao longo do tempo, incluindo engajamento e problemas de entrega.

<Frame caption="Estatísticas de Mensagem em visualização de 24 horas">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b515604ef097dd62b783a810d8d491d2e2fce84b69bddfa8877b6fb0ce65d0e6-Screenshot_2025-05-13_at_15.51.04.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=6e1c62efd8a9a62016c8f01f5a589de0" alt="Gráfico de estatísticas de mensagem mostrando tendências de entrega e engajamento em 24 horas" width="1633" height="582" data-path="images/docs/b515604ef097dd62b783a810d8d491d2e2fce84b69bddfa8877b6fb0ce65d0e6-Screenshot_2025-05-13_at_15.51.04.png" />
</Frame>

Visualize métricas por:

* 30 dias (padrão)
* 24 horas
* 60 minutos

Você pode alternar métricas adicionais como Bounced, ESP Failed, Sent, Spam, Suppressed, Total Clicks e Total Opens.

Use o ícone de exportação no canto superior direito do gráfico para baixar os dados.

***

## Atividade do público

O relatório **Atividade do público** mostra como cada inscrição interagiu com uma mensagem específica. Os resultados são agrupados em categorias para que você possa ver rapidamente como os destinatários se engajaram.

<Frame caption="Abas e tabela de atividade do público">
  <img src="https://mintcdn.com/onesignal/uUnoewrrt1DvIru9/images/push/audience-activity.png?fit=max&auto=format&n=uUnoewrrt1DvIru9&q=85&s=1568714f2133e3e9ef98c36de476e28f" alt="Captura de tela de atividade do público" width="2150" height="402" data-path="images/push/audience-activity.png" />
</Frame>

<Tabs>
  <Tab title="Categorias">
    | Categoria                 | Descrição                                     |
    | ------------------------- | --------------------------------------------- |
    | **Enviado**               | Mensagem foi enviada para o dispositivo.      |
    | **Entrega confirmada**    | Entrega foi confirmada pelo dispositivo.      |
    | **Não confirmou entrega** | Confirmação de entrega não foi recebida.      |
    | **Clicou**                | Usuário clicou na notificação.                |
    | **Não clicou**            | Usuário não clicou na notificação.            |
    | **Falhou**                | Entrega falhou.                               |
    | **Cancelou inscrição**    | A inscrição cancelou após receber a mensagem. |

    Cada aba exibe o número de destinatários naquela categoria e permite que você analise os registros de inscrição individuais.
  </Tab>

  <Tab title="Colunas da tabela">
    | Coluna                  | Descrição                                                             |
    | ----------------------- | --------------------------------------------------------------------- |
    | **External ID**         | Seu identificador de sistema (se configurado).                        |
    | **OneSignal ID**        | ID de usuário único do OneSignal.                                     |
    | **Subscription ID**     | Instância de inscrição única (dispositivo + app/navegador).           |
    | **Device**              | Tipo de navegador ou SO. Se você vê `()`, o dispositivo foi deletado. |
    | **Subscription status** | Status atual (por exemplo, Inscrito, Inscrição cancelada).            |
    | **Sent**                | Horário em que a mensagem foi enviada.                                |
    | **confirmed receipt**   | Horário em que a entrega foi confirmada pelo dispositivo.             |
    | **Clicked**             | Timestamp se o usuário clicou, ou `-` se não.                         |
    | **Failed**              | Indica se a entrega falhou.                                           |
    | **Unsubscribed**        | Indica se o usuário cancelou inscrição após receber a mensagem.       |
    | **Failure message**     | Mensagem de erro se a entrega falhou (por exemplo, "Token inválido"). |
  </Tab>
</Tabs>

<Note>
  Dados de atividade do público estão disponíveis apenas por **30 dias** a partir do momento em que a mensagem é enviada. Exporte os resultados se você precisar retê-los por mais tempo.
</Note>

***

### Por que a atividade do público é útil

A atividade do público ajuda você a ir além das contagens de entrega mostrando quais usuários específicos se enquadram em cada resultado. Use para:

* **Diagnosticar problemas de entrega** revisando entregas falhadas ou não confirmadas.
* **Medir engajamento** comparando cliques vs. não-cliques.
* **Rastrear churn** identificando cancelamentos de inscrição vinculados a uma mensagem.
* **Segmentar públicos** para retargeting ou exportação.

***

### Exportando resultados

Você pode baixar dados do público com o menu **Export**:

* **Selected activity** – exporta apenas a aba visualizada atualmente (por exemplo, todos os usuários que não clicaram).
* **All activities** – exporta o relatório completo de todas as categorias.

Exportações permitem que você analise resultados offline, compartilhe com outras equipes ou mescle com suas ferramentas de CRM e análise.

***

### Fazendo retargeting de usuários

De qualquer aba, clique em **Send a retargeted message** para agir naquele grupo específico.

Você pode enviar:

* **New push**
* **New SMS**

Isto permite que você faça follow-up apenas com os usuários no grupo de atividade selecionado.

#### Exemplos de casos de uso

* Envie um push de retargeting para usuários em **Não clicou**.
* Envie um SMS para usuários em **Não confirmou entrega** que podem não ser alcançáveis via push.
* Faça follow-up com usuários em **Entrega confirmada** para encorajar mais engajamento.

***

### Exemplo de fluxo de trabalho

<Steps>
  <Step title="Abra a aba Não clicou">
    Navegue para a aba **Não clicou** em Atividade do público.
  </Step>

  <Step title="Revise a lista de inscrições">
    Verifique quais inscrições receberam a notificação mas não se engajaram.
  </Step>

  <Step title="Envie uma mensagem de retargeting">
    Clique em **Send a retargeted message → New push** para fazer follow-up com este segmento.
  </Step>

  <Step title="Exporte para análise mais profunda">
    Se necessário, exporte a atividade do público para análise offline ou targeting multicanal em uma jornada.
  </Step>
</Steps>

***

## Click activity

A seção de Atividade de Clique mostra um detalhamento por link para que você possa ver quais links foram clicados e com que frequência. As definições de métricas (Unique Clicks, Total Clicks, CTR) são as mesmas que na seção [Click-through rate](#click-through-rate) acima.

<Info>
  **Campanhas de Auto Warm Up:** Emails enviados através de [Auto Warm Up](./email-warm-up) após 2 de fevereiro de 2026 mostram estatísticas de cliques individuais para cada link. Para campanhas de warm-up enviadas antes dessa data, todos os cliques em links são agrupados em "Todos os outros links."
</Info>

***

## FAQ

### Por que minhas estatísticas de email mostram zero aberturas ou cliques?

A causa mais comum são registros CNAME DNS ausentes. Sem registros CNAME configurados para seu domínio de envio, o OneSignal não consegue rastrear aberturas, cliques ou cancelamentos de assinatura — essas métricas ficam em zero mesmo que os emails estejam sendo entregues.

Para verificar se seus registros DNS estão configurados corretamente:

1. Acesse **Dashboard > Configurações > Email > Remetentes**.
2. Selecione seu domínio de envio e verifique se há um check verde ao lado de cada registro DNS, especialmente os registros CNAME usados para rastreamento de cliques e aberturas.
3. Se algum registro aparecer como ausente ou não verificado, siga o guia de [Configuração de DNS de email](./email-dns-configuration) para adicioná-los.

<Note>
  Após adicionar ou atualizar registros DNS, aguarde até 48 horas para propagação. Aberturas e cliques só são rastreados para emails enviados **após** a verificação dos registros — emails enviados anteriormente não são atualizados retroativamente.
</Note>

Se seus registros CNAME estão verificados e você ainda vê zero aberturas, verifique se recursos de privacidade da caixa de entrada estão bloqueando o rastreamento. Veja [Por que eventos de abertura estão baixos?](#why-are-open-events-low%3F) abaixo.

### Por que meus emails são marcados como falhados?

Razões de falha são mostradas na exportação de Atividade de Público. Causas comuns incluem:

* Domínios com erros de digitação ou inexistentes (por exemplo `@gmial.com`)
* Endereços de email já na lista de supressão do seu ESP
* Usar [Links de Cancelamento Personalizados](./unsubscribe-links-email-subscriptions) sem também cancelar via [Update User API](/reference/update-user) ou [CSV Upload](./import#csv-upload)
* Endereços previamente rejeitados
* Caixas de entrada limitando domínios de remetente não aquecidos (veja [Guia de Aquecimento](./email-warm-up))

### Por que eventos de abertura estão baixos?

Recursos de privacidade da caixa de entrada (por exemplo, Apple Mail Privacy Protection), bloqueadores de anúncios e carregamento de imagens desabilitado podem impedir que eventos de abertura sejam registrados. Rastreamento de abertura não é 100% confiável — teste em múltiplos dispositivos e redes para comparação. Veja a [seção Open rate](#open-rate) para detalhes sobre como recursos de privacidade afetam a precisão.

### Por que vejo emails em Pending?

Duas razões principais:

1. **Entrega agendada:** Especialmente se aquecimento automático está habilitado, a entrega é distribuída.
2. **Confirmação pendente:** Algumas caixas de entrada atrasam feedback de evento até 8 horas.

Se a mensagem permanece em Pendente, provavelmente foi enviada mas não confirmada. Verifique **Sent at** em Atividade de Público para pistas.

### Como exporto dados de atividade de público?

No relatório de mensagem de email, role até **Audience Activity** e clique em **Export CSV**. A exportação inclui status de entrega por destinatário, timestamps, eventos de clique e razões de falha.

### Qual é a diferença entre Bounced e Suppressed?

**Bounced** significa que o servidor de email do destinatário rejeitou o email (por exemplo, endereço inválido ou caixa de entrada cheia). **Suppressed** significa que o OneSignal bloqueou proativamente o envio porque o endereço já estava na [lista de supressão](./suppressions) — por exemplo, de um rejeição anterior, reclamação de spam ou cancelamento de assinatura.

***

## Páginas relacionadas

<Columns cols={2}>
  <Card title="Entregabilidade de email" icon="envelope-circle-check" href="./email-deliverability">
    Entenda fatores que afetam o posicionamento na caixa de entrada e como melhorá-los.
  </Card>

  <Card title="Melhores práticas de reputação de email" icon="shield-check" href="./email-reputation-best-practices">
    Mantenha forte reputação de remetente e evite filtros de spam.
  </Card>

  <Card title="Supressões" icon="ban" href="./suppressions">
    Visualize e gerencie endereços rejeitados, cancelados e reportados como spam.
  </Card>

  <Card title="Template analytics" icon="chart-bar" href="./template-analytics">
    Revise métricas de desempenho agregadas em todos os envios de um template.
  </Card>

  <Card title="URLs, links e deep links" icon="link" href="./links">
    Configure comportamento de links, rastreamento de cliques e deep linking em mensagens.
  </Card>

  <Card title="Email warm-up" icon="temperature-arrow-up" href="./email-warm-up">
    Aumente gradualmente o volume de envio para estabelecer reputação do domínio.
  </Card>

  <Card title="Configuração de DNS de email" icon="server" href="./email-dns-configuration">
    Adicione registros SPF, DKIM, DMARC e CNAME para habilitar rastreamento e autenticação.
  </Card>
</Columns>
