> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Relatórios

> Leia o dashboard, explore qualquer dimensão e acompanhe o tráfego chegando ao vivo.

**Web Analytics** é um grupo recolhível da barra lateral com seis entradas: Dashboard, Ao Vivo, Explorar, Metas, Filtros e Anotações. Todas, menos Ao Vivo, também são abas da página Web Analytics, então você passa de uma para outra sem sair dela.

## O que é registrado

| Linha                      | Gravada quando                                                                                       |
| -------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Sessão**                 | Um visitante chega. Uma linha por visita, atualizada enquanto ele navega.                            |
| **Visualização de página** | Cada página que ele abre, com o tempo de engajamento e até onde ele rolou.                           |
| **Meta**                   | O seu site chama `trackGoal`. Veja [Metas](https://www.notifuse.com/pt/docs/web-analytics/goals.md). |

O rastreador envia um beat a cada 7 a 30 segundos enquanto a pessoa está ativa (com mais frequência logo depois que a página abre, e depois com menos), e cada beat leva a visita inteira até aquele momento. Um relatório nunca fica pela metade: uma linha de sessão sempre reflete tudo o que se sabia sobre aquela visita na última vez em que ela foi vista.

> [!NOTE]
>
> Os beats param depois de cerca de dez minutos de tempo ativo acumulado na mesma página. Uma aba deixada aberta por uma hora não conta como uma hora de engajamento; abrir outra página reinicia o ritmo.

## Dashboard

![Dashboard com a comparação de períodos, o gráfico de sessões anotado com broadcasts e um lançamento, e os painéis de principais páginas e origens](https://www.notifuse.com/docs/assets/screenshots/web_analytics/dashboard.png)

Os números principais do período que você escolhe, com os detalhamentos que a maioria das pessoas olha primeiro: origens, páginas, países, dispositivos.

Clicar em uma linha de qualquer painel adiciona esse valor como filtro na página inteira; clicar de novo o remove. Os filtros se somam: você pode restringir a um país e a um canal, e todos os painéis acompanham.

## Ao Vivo

![Visão Ao Vivo com o mapa-múndi dos visitantes ativos neste momento](https://www.notifuse.com/docs/assets/screenshots/web_analytics/live.png)

Todos os visitantes ativos nos últimos 30 minutos, atualizados a cada 10 segundos, com um mapa de onde eles estão. O mapa mostra até 500 localizações distintas, e cada marcador traz o número de sessões naquele lugar.

## Explorar

![Explorar com origem, meio e campanha UTM aninhados como dimensões e as quatro medidas de sessão em cada linha](https://www.notifuse.com/docs/assets/screenshots/web_analytics/explore.png)

Detalhe as sessões por qualquer dimensão, filtre-as e exporte o resultado em CSV.

Explorar gera relatórios sobre **sessões**, com quatro medidas exibidas em cada linha:

| Medida                          | Significado                                          |
| ------------------------------- | ---------------------------------------------------- |
| Sessões                         | Número de visitas                                    |
| TimeScore Mediano               | Tempo de engajamento mediano dessas visitas          |
| Taxa de Rejeição                | Parcela das visitas abaixo do seu limite de rejeição |
| Profundidade Mediana de Rolagem | Até onde os visitantes desceram na página            |

As **Dimensões** ficam agrupadas como aparecem no seletor:

- **Canal**: Channel, Channel Group
- **UTM**: Source, Medium, Campaign, Term, Content
- **Tráfego**: Referrer, Referrer Domain, Referrer Path, Is Direct
- **Páginas**: Landing Page, Landing Domain, Landing Path, Exit Path
- **Dispositivo**: Device, Browser, Browser Type, Operating System, Connection Type, tamanho da tela e da viewport
- **Geo**: Country, Region, City, Language, Timezone
- **Hora**: Hour of Day, Day of Week, Is Weekend, Year, Month, Day, Week Number
- **Sessão**: Pageview Count, Duration (ms), SDK Version
- **Usuário**: Contact Email, quando o visitante é identificado
- **Personalizado**: de `custom_1` a `custom_10`, com os nomes que você deu a eles

> [!NOTE]
>
> As dimensões de tempo aqui são cíclicas e calculadas no fuso horário do relatório, não em UTC: "tráfego por hora do dia" corresponde à manhã do visitante e não muda quando o seu servidor muda de lugar. Os timestamps de início e de última atividade da sessão são usados pelo filtro de intervalo de datas; eles não servem para detalhamentos.

As dimensões no nível da visualização de página (Page Path, Page Number, Is Landing Page, Is Exit Page, Entry Type) pertencem ao schema de visualizações de página, e Goal Name, Goal Path e Goal Value ao schema de metas. Nenhum desses dois grupos pode ser escolhido em Explorar; as dimensões de meta alimentam a aba [Metas](https://www.notifuse.com/pt/docs/web-analytics/goals.md).

### Detalhar uma linha

O ícone de olho no fim de uma linha abre o detalhamento dela em largura total: quanto essa linha pesa e do que ela é feita.

![Detalhamento da linha search-paid de Channel Group: o caminho, os filtros e as sessões mínimas, as quatro medidas com a parcela de todas as sessões, um gráfico diário de sessões, e as tabelas Channel e UTM Campaign com participação e profundidade de rolagem](https://www.notifuse.com/docs/assets/screenshots/web_analytics/explore_breakdown.png)

- **A linha de contexto** mostra o caminho da linha (Country US › Region…), os filtros da página, o mínimo de sessões por linha e as dimensões usadas no detalhamento. O × em uma dimensão remove a tabela dela; **Adicionar dimensão** na barra escolhe outras entre as que ainda não estão no caminho.
- **As medidas** são as Sessões, o TimeScore Mediano, a Taxa de Rejeição e a Profundidade Mediana de Rolagem da própria linha, sem comparação. Sessões mostra também a parcela da linha em relação à linha pai, ou a todas as sessões no caso de uma linha de primeiro nível. Clicar em uma medida mostra o gráfico dela no período, na granularidade que você escolher.
- **Uma tabela por dimensão** lista os valores com Sessões, Participação nas sessões da linha, TimeScore, Retorno e Rolagem. O detalhamento abre nas duas primeiras dimensões do relatório que não estão no caminho da linha; se não sobrar nenhuma, ele pede que você escolha.

As tabelas mantêm o mínimo de sessões e os filtros sobre medidas do relatório, e param em 100 valores. Por isso, os valores de uma tabela podem não somar o total da linha: o rodapé diz quantas das sessões da linha ela mostra. O gráfico ignora esses dois limites e cobre todas as sessões da linha.

## Além das telas

Os três schemas definem mais do que as telas exibem, e a API de consultas de analytics alcança tudo isso. É o endpoint que o console chama, documentado na [Referência da API](https://www.notifuse.com/docs/api-reference.md).

- **Sessões** também definem Pageviews, Pages / Session, Avg Scroll Depth, Median Page Duration, Sessions with Goals, Goal Value e Identified Contacts.
- **Visualizações de página** definem Page Views, Unique Pages, Median Page Duration, Median Scroll Depth, Entries, Exits e Exit Rate, além das dimensões de página acima. Nenhuma tela do Web Analytics as consulta hoje.
- **Metas** definem Goals, Total Goal Value, Avg Goal Value, Median Goal Value e Converting Sessions.

> [!NOTE]
>
> Median Page Duration tem significados diferentes nos dois schemas. Nas sessões, é a mediana, entre as visitas, do tempo mediano por página de cada visita; a verdadeira mediana por página é a medida de mesmo nome no schema de visualizações de página.

## Dimensões personalizadas

Dez slots permitem registrar algo que só você sabe sobre uma visita, como um nível de plano, uma variante de teste ou o papel de um usuário logado.

Defina-os no seu site pelo número do slot:

```javascript
NotifuseAnalytics.setDimension(1, 'pro')
NotifuseAnalytics.setDimensions({ 1: 'pro', 2: 'variant-b' })
```

Eles também podem vir na URL: um link com `?custom_1=pro` preenche o slot 1 sempre que o rastreador é inicializado nessa página. Assim você marca o tráfego que você mesmo envia sem mexer no código da página.

> [!NOTE]
>
> A URL só preenche slots que ainda estão vazios na sessão. Um valor já definido por `setDimension` (ou por uma URL anterior na mesma visita) prevalece. Os valores são lidos uma vez, na inicialização, então uma mudança de rota no lado do cliente não os lê de novo.

Depois, dê um nome de exibição ao slot em **Configurações** → **Web Analytics** → **Dimensões personalizadas**. O nome é o que aparece nos relatórios; por baixo, o slot mantém a identidade `custom_1`, então renomeá-lo nunca reescreve os seus dados.

As dimensões personalizadas também podem ser _derivadas_ em vez de enviadas: uma [regra de atribuição](https://www.notifuse.com/pt/docs/web-analytics/attribution.md) pode gravar uma delas a partir do referenciador, de um valor UTM ou de um caminho de destino, para classificar um tráfego que você não marcou na origem.

> [!WARNING]
>
> Um [reprocessamento](https://www.notifuse.com/pt/docs/web-analytics/attribution.md#changing-rules-later) não toca nas dimensões personalizadas das linhas que as suas regras não gravam, então os valores enviados pelo seu rastreador continuam lá. Só Channel e Channel Group são apagados, porque só uma regra pode defini-los.

## Observações

- Os valores têm um limite de 256 bytes por dimensão personalizada. A verificação do próprio rastreador conta caracteres, então valores não ASCII devem ficar bem abaixo de 256 caracteres, senão o servidor rejeita o beat.
- As exportações em CSV respeitam os filtros e o período aplicados no momento, até 1.000 linhas.
- [Referência da API](https://www.notifuse.com/docs/api-reference.md)
