> ## 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.

# Visão geral de análises

> Meça o desempenho de mensagens, engajamento de usuários e conversões no OneSignal. Abrange painéis, modelos de atribuição, tendências e exportação de dados.

## Visão geral

O OneSignal fornece análises para medir o desempenho de mensagens, rastrear o engajamento de usuários ao longo do tempo e atribuir resultados de negócios downstream como compras e cadastros. Você pode visualizar análises no Painel, recuperá-las por meio da API, transmitir eventos em tempo real para seus próprios sistemas usando Fluxos de Eventos ou exportar dados para CSV.

Relatórios de mensagens e tendências agregadas são abordados abaixo. Ir para outros recursos de análises:

<Columns cols={2}>
  <Card title="Fluxos de Eventos" icon="satellite-dish" href="./event-streams"> Envie eventos de mensagens em tempo real como enviados, abertos, clicados e descartados para seu data warehouse ou ferramentas de análise. </Card>
  <Card title="Exportando dados" icon="file-export" href="./exporting-data"> Exporte dados de mensagens e usuários para CSV para análise offline. </Card>
  <Card title="Análises de Jornada" icon="route" href="./journeys-analytics"> Meça conversão, abandono e desempenho em Jornadas de várias etapas. </Card>
  <Card title="Análises de Template" icon="file" href="./template-analytics"> Agregue análises em muitas mensagens enviadas do mesmo Template. </Card>
  <Card title="Métricas de conversão" icon="arrow-trend-up" href="./conversion-metrics"> Meça o impacto nos negócios, como receita e cadastros, com atribuição de último toque entre canais. </Card>
  <Card title="Resultados personalizados (legado)" icon="clock-rotate-left" href="./custom-outcomes"> Rastreie ações como compras ou cadastros em mensagens push e no aplicativo. Sendo substituído pelas Métricas de conversão. </Card>
  <Card title="Metas" icon="bullseye" href="./goals"> Defina uma métrica alvo em uma mensagem ou Jornada e acompanhe o progresso no relatório de entrega. </Card>
</Columns>

### Quais análises devo usar?

Escolha a ferramenta de análise certa com base em seu objetivo. A maioria das equipes usa mais de uma opção dependendo se estão otimizando campanhas, depurando entrega ou analisando comportamento a longo prazo.

| Seu objetivo                                                                  | Use isto                                            |
| ----------------------------------------------------------------------------- | --------------------------------------------------- |
| Revisar o desempenho de uma única mensagem no painel                          | [Relatórios de mensagens](#message-reports)         |
| Agregar desempenho em mensagens similares, ideal para mensagens transacionais | [Análises de Template](./template-analytics)        |
| Medir conversão em uma Jornada                                                | [Análises de Jornada](./journeys-analytics)         |
| Rastrear tendências de engajamento ao longo do tempo no painel                | [Tendências de engajamento](./engagement-analytics) |
| Monitorar mudanças no status de assinatura de usuários por canal              | [Tendências de assinaturas](#subscription-trends)   |
| Medir ações downstream como compras ou cadastros                              | [Métricas de conversão](./conversion-metrics)       |
| Enviar eventos de mensagens em tempo real para seu próprio stack de análise   | [Fluxos de Eventos](./event-streams)                |
| Exportar dados para análise offline                                           | [Exportando dados](./exporting-data)                |
| Rastrear se uma mensagem ou Jornada atingiu sua métrica alvo                  | [Metas](./goals)                                    |

***

## Relatórios de mensagens

Toda mensagem enviada pelo OneSignal tem um relatório de mensagem mostrando métricas de entrega, engajamento e resultados para esse envio específico. Os relatórios de mensagens abrangem uma única mensagem — eles não agregam dados em múltiplas mensagens.

Navegue até **Painel > Mensagens** e selecione uma mensagem para visualizar seu relatório, ou recupere relatórios programaticamente usando a [API View messages](/reference/view-messages) e/ou [Export audience activity CSV](/reference/export-csv-of-events).

<Note>
  Se você enviar mensagens usando Jornadas ou Templates, use [Análises de Jornada](./journeys-analytics) e/ou [Análises de Template](./template-analytics) para ver o desempenho agregado em vez de revisar cada mensagem individualmente.
</Note>

<Columns cols={2}>
  <Card title="Relatórios de mensagens push" icon="bell" href="./push-notification-message-reports"> Entrega, aberturas, cliques, entrega confirmada e resultados para notificações push. </Card>
  <Card title="Relatórios de mensagens no aplicativo" icon="message" href="./in-app-message-reports"> Impressões, cliques, descartes e métricas de conversão para mensagens no aplicativo. </Card>
  <Card title="Relatórios de mensagens de email" icon="envelope" href="./email-message-reports"> Envios, aberturas, cliques, devoluções e cancelamentos de assinatura para mensagens de email. </Card>
  <Card title="Relatórios de mensagens SMS" icon="comment-sms" href="./sms-message-reports"> Entrega, cliques, falhas e opt-outs para mensagens SMS/RCS. </Card>
  <Card title="Relatórios de mensagens de atividade ao vivo" icon="tower-broadcast" href="./live-activities#message-reports"> Atualizações, cliques, engajamento e eventos do ciclo de vida para Live Activities. </Card>
</Columns>

***

## Tendências agregadas

As tendências agregadas mostram como a atividade de mensagens e usuários muda ao longo do tempo em todo o seu aplicativo. Esses gráficos ajudam você a identificar sazonalidade, picos ou mudanças de engajamento a longo prazo.

Para uso do plano [relacionado ao faturamento](./billing-faq) (envios por canal, MAU e limites de faturamento), veja:

* **Aplicativo > Configurações > Uso** para o volume de mensagens no nível do aplicativo
* **Organizações > Faturamento** para limites do plano e uso entre aplicativos

### Tendências de engajamento

As Tendências de Engajamento rastreiam envios de mensagens, entregas, aberturas, cliques e cancelamentos de assinatura em todas as mensagens. As Tendências de Engajamento não mostram o desempenho de mensagens individuais — use [relatórios de mensagens](#message-reports) para isso.

Navegue até **Painel > Analytics > Tendências de Engajamento** para visualizar esses gráficos. Rastreie:

* Envios e entregas (chamados de "Impressões" para mensagens no aplicativo)
* Aberturas e cliques
* Cancelamentos de assinatura

<Frame caption="Gráfico de Tendências de Engajamento no Painel">
  <img src="https://mintcdn.com/onesignal/yPUIoSFfP3uW7fGS/images/docs/engagement-trends-analytics-overview.png?fit=max&auto=format&n=yPUIoSFfP3uW7fGS&q=85&s=88a1337a5344edbbe12a0931e61fa643" alt="Gráfico de Tendências de Engajamento mostrando aberturas, cliques e envios de mensagens ao longo do tempo" width="2776" height="1606" data-path="images/docs/engagement-trends-analytics-overview.png" />
</Frame>

<Card title="Tendências de engajamento" icon="chart-line" href="./engagement-analytics"> Rastreie envios de mensagens, aberturas, cliques e cancelamentos de assinatura ao longo do tempo. </Card>

### Tendências de assinaturas

As Tendências de Assinaturas mostram como as [Assinaturas](./subscriptions) (cada dispositivo ou canal pelo qual um usuário pode receber mensagens) se inscrevem e cancelam ao longo do tempo, divididas por canal. As Tendências de Assinaturas rastreiam a atividade de opt-in e opt-out — elas não rastreiam o engajamento de mensagens como aberturas ou cliques (use [Tendências de engajamento](#engagement-trends) para isso).

Navegue até o **Painel** do seu aplicativo para visualizar o gráfico de Tendências de Assinaturas. Rastreie:

* Crescimento ou declínio de usuários inscritos
* O impacto de solicitações de permissão
* Picos de cancelamento após campanhas

<Frame caption="Gráfico de Tendências de Assinaturas no Painel">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a7e0b1d61262c638b766a1ed946908873caa5bee801a0b6bcbfaf4b72080564d-Screenshot_2024-10-01_at_1.40.32_PM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=5f1ba8dc5a26af92a6ee97032359efc6" alt="Gráfico de Tendências de Assinaturas mostrando total de inscritos, novas inscrições e novos cancelamentos ao longo do tempo" width="2206" height="1216" data-path="images/docs/a7e0b1d61262c638b766a1ed946908873caa5bee801a0b6bcbfaf4b72080564d-Screenshot_2024-10-01_at_1.40.32_PM.png" />
</Frame>

| Métrica                 | Descrição                                                                                                                                                                                                                                                                                                       |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Total de Inscritos**  | A contagem de todas as Assinaturas inscritas. As contagens flutuam conforme os usuários instalam e desinstalam seu aplicativo, limpam dados do navegador, se inscrevem e cancelam suas mensagens, ou são excluídos. Para detalhes sobre como esses eventos são rastreados, veja [Assinaturas](./subscriptions). |
| **Novas Inscrições**    | A contagem de mudanças de status de assinatura de cancelado para inscrito. Isso inclui Assinaturas inscritas recém-criadas e Assinaturas atuais que se inscreveram em mensagens no período selecionado.                                                                                                         |
| **Novos Cancelamentos** | A contagem de mudanças de status de assinatura de inscrito para cancelado. Isso não inclui Assinaturas recém-criadas que nunca se inscreveram ou negaram o prompt push.                                                                                                                                         |

<Columns cols={2}>
  <Card title="Assinaturas" icon="address-book" href="./subscriptions">
    Aprenda como as Assinaturas são criadas, armazenadas e marcadas como inscritas ou canceladas.
  </Card>

  <Card title="Usuários" icon="user" href="./users">
    Os usuários podem ter múltiplas Assinaturas e são identificados por seu ID externo.
  </Card>
</Columns>

***

## Métricas de conversão

As métricas de conversão medem o impacto nos negócios de suas mensagens rastreando o que os usuários fazem após interagir com mensagens — como compras, cadastros ou visualizações de conteúdo.

Você define quais [Eventos Personalizados](./custom-events) contam como conversões, e o OneSignal atribui essas conversões às mensagens usando um modelo de **atribuição de último toque** em todos os canais (push, email, SMS, no aplicativo e RCS).

<Note>
  As métricas de conversão estão em **beta** e substituem o recurso legado [Resultados Personalizados](./custom-outcomes). Se você estiver configurando o rastreamento de conversões pela primeira vez, use [Métricas de conversão](./conversion-metrics).
</Note>

<Card title="Métricas de conversão" icon="bullseye" href="./conversion-metrics"> Detalhes completos sobre o modelo de atribuição, interações qualificadas por canal, janelas de atribuição e instruções de configuração. </Card>

### Resultados legados

<Warning>
  [Resultados Personalizados](./custom-outcomes) está sendo descontinuado. Os dados de resultados legados permanecem acessíveis como dados históricos, mas não aparecerão nos novos gráficos de métricas de conversão.
</Warning>

O recurso legado de Resultados Personalizados usa um modelo de atribuição diferente que abrange apenas notificações push e mensagens no aplicativo:

| Atribuição        | Quando se aplica                                                                                                                                                                                   |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Direta**        | O usuário clicou no bloco de mensagem no aplicativo ou notificação push, que iniciou uma nova sessão (aplicativo foi fechado >30s) e acionou o resultado.                                          |
| **Influenciada**  | O usuário **não** clicou em uma notificação push, mas abriu o aplicativo dentro da janela de influência (padrão: 24 horas) e acionou o resultado. Aplica-se às 10 notificações push mais recentes. |
| **Não atribuída** | O resultado ocorreu fora de qualquer janela de atribuição ou clique. Não vinculado a uma mensagem específica.                                                                                      |

***

## Perguntas Frequentes

### Por quanto tempo os dados de mensagens são retidos?

| Tipo de Mensagem               | Período de Retenção                               |
| ------------------------------ | ------------------------------------------------- |
| Mensagens enviadas pelo Painel | Tempo de vida do aplicativo                       |
| Mensagens enviadas por API     | 30 dias                                           |
| CSV de atividade de público    | 30 dias                                           |
| Mensagens de Jornadas          | Veja [Análises de Jornadas](./journeys-analytics) |

### Como agregar dados em múltiplas mensagens?

Cada mensagem tem um ID de mensagem único, o que torna a agregação manual via API possível, mas ineficiente.

**Abordagem recomendada**:

* Use [Análises de Template](./template-analytics) para agregar o desempenho de mensagens relacionadas enviadas do mesmo Template.
* Use [Análises de Jornadas](./journeys-analytics) para agregar o desempenho de Jornadas relacionadas.
