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

# Configuração

> Instale o snippet de rastreamento e configure a análise do seu site, sem cookies, no seu workspace.

![Dashboard do Web Analytics com sessões, TimeScore, taxa de rejeição, o gráfico de tráfego com anotações, as principais páginas e as principais origens](https://www.notifuse.com/docs/assets/screenshots/web_analytics/dashboard.png)

O Web Analytics registra as visitas ao seu site no seu próprio banco de dados, junto com os seus contatos. Ele não usa cookies, não armazena endereços IP e não depende de nenhum serviço de terceiros.

- **Dados próprios**: sessões, visualizações de página e metas ficam no banco de dados do seu workspace, em três tabelas particionadas por mês.
- **Sem cookies**: nenhum cookie é criado, e nenhum identificador acompanha um visitante de um site para outro. Uma sessão fica no `localStorage` e termina após 30 minutos de inatividade ou 24 horas depois de começar, o que acontecer primeiro.
- **Atribuição integrada**: 40 regras pré-configuradas classificam o tráfego em canais, para você ver o que os seus broadcasts trouxeram.
- **Ligado aos contatos**: as visitas de um visitante que você identifica são registradas na linha do tempo do contato, onde os segmentos podem alcançá-las.

## Ativar o Web Analytics

Acesse **Configurações** → **Web Analytics**, ative o recurso e adicione pelo menos um domínio.

> [!WARNING]
>
> O Web Analytics não pode ser ativado com a lista de domínios vazia. A lista define quais sites podem enviar tráfego para você e quais hosts podem receber uma identidade de um link de email rastreado.

## Instalar o snippet

Cole isto antes da tag de fechamento `</head>` de cada página que você quer rastrear.

```html
<script>
  window.NotifuseAnalyticsConfig = { workspace_id: "your_workspace", endpoint: "https://your-instance.com" };
</script>
<script async src="https://your-instance.com/na.js"></script>
```

A tela de configurações mostra este snippet já preenchido com o ID do seu workspace e o endpoint: copie-o de lá em vez de editar o exemplo.

O script é servido pela sua própria instância em `/na.js` e fica em cache por uma hora. Uma variante com hash, `/na.<hash>.js`, é servida com cache imutável de um ano; use-a se a sua CDN prefere URLs permanentes. As duas enviam beats para `POST /track`.

> [!NOTE]
>
> Tudo o que o rastreador não pode aceitar (um workspace desativado, um domínio que não está na sua lista, uma requisição que parece vir de um bot) recebe uma resposta de sucesso e é descartado. O SDK nunca tenta de novo algo que não pode dar certo, então um erro de configuração aparece como dados ausentes, e não como erros no console do navegador.

## Domínios permitidos

Cada entrada é um nome de host, com um curinga opcional no início.

| Entrada         | Corresponde a                                        | Não corresponde a                     |
| --------------- | ---------------------------------------------------- | ------------------------------------- |
| `example.com`   | `example.com`                                        | `www.example.com`, `shop.example.com` |
| `*.example.com` | `example.com`, `www.example.com`, `shop.example.com` | `example.org`                         |

Portas não fazem parte de um nome de host e não podem aparecer. Um curinga sobre um único rótulo, como `*.com` ou `*.io`, é recusado: ele entregaria a identidade de todos os destinatários a todos os links com esse sufixo.

> [!TIP]
>
> A maioria dos sites quer `*.example.com`. Essa entrada cobre o domínio raiz e todos os subdomínios, então `www` continua funcionando quando alguém o adicionar depois.

A lista também define quais páginas o console abre a partir da linha do tempo de um contato. **Ver site** é oferecido para uma visualização de página cujo host está na lista ou, enquanto a lista estiver vazia, é o domínio do site do seu workspace, com ou sem `www.`. Uma visualização de página registrada sem host abre no site do seu workspace. Para visualizar as páginas dos seus outros hosts, liste todos os hosts que você rastreia, incluindo o do seu site: quando a lista tem entradas, os beats de um host que não está nela são descartados.

## Configurações

![Configurações do Web Analytics com o botão de ativação, os domínios permitidos, o limite de rejeição e a identificação de contatos](https://www.notifuse.com/docs/assets/screenshots/web_analytics/settings.png)

| Configuração                           | O que faz                                                                                                                                                                                                              |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Status**                             | Liga ou desliga o rastreamento. Desativado por padrão.                                                                                                                                                                 |
| **Domínios permitidos**                | Os nomes de host que podem enviar tráfego, os únicos hosts para os quais um link de email rastreado pode entregar uma identidade, e os hosts cujas páginas a linha do tempo de um contato abre.                        |
| **Limite de rejeição**                 | Segundos de tempo de engajamento abaixo dos quais uma visita conta como rejeição. O padrão é 10.                                                                                                                       |
| **Identificar destinatários de email** | Permite que o Notifuse adicione uma identidade assinada aos links dos emails rastreados. Desativado por padrão. Veja [Identificar visitantes](https://www.notifuse.com/pt/docs/web-analytics/identifying-visitors.md). |
| **Dimensões personalizadas**           | Nomes de exibição de `custom_1` a `custom_10`. Veja [Relatórios](https://www.notifuse.com/pt/docs/web-analytics/reports.md).                                                                                           |
| **Localização dos visitantes**         | Se o país do visitante deve ser obtido (**Localizar visitantes**), e com qual precisão.                                                                                                                                |

O limite de rejeição se baseia no tempo de engajamento, não no número de páginas: um visitante que lê um artigo longo não é uma rejeição, e um que abre cinco páginas em quatro segundos é.

## Geolocalização

O país é obtido a partir do endereço IP do visitante com um banco de dados MaxMind GeoLite2 incluído. **O endereço IP em si nunca é armazenado**: ele é usado na consulta e depois descartado.

- **Região** e **Cidade** adicionam esses níveis com nome. Desativá-los remove os _nomes_ da região e da cidade.
- **Coordenadas** controla quanto da latitude e da longitude é mantido: `0` ≈ país (\~111 km), `1` ≈ região (\~11 km), `2` ≈ cidade (\~1 km). O padrão é `2`.

> [!NOTE]
>
> Uma coordenada é um nome de lugar em outra forma, então ela nunca é mantida com mais
> detalhe que o nome mais preciso que você armazena, seja qual for a precisão configurada.
> Com **Cidade** desativada, as coordenadas ficam limitadas a `1`; com os dois
> botões de nome desativados, a `0`. A configuração é um teto que esses botões podem
> baixar, nunca subir.
>
> As coordenadas ficam menos precisas em vez de serem descartadas, então o mapa Ao Vivo
> continua mostrando onde estão os visitantes. Um mapa vazio daria a entender que não
> há ninguém online.

As instâncias auto-hospedadas trazem o banco de dados em `/app/geoip/GeoLite2-City.mmdb`. Aponte `GEOIP_DB_PATH` para outro arquivo para usar o seu.

## Permissões

Alterar estas configurações exige a permissão de **escrita** em `web_analytics`. Ler os relatórios exige a permissão de **leitura** em `web_analytics`, e a seção **Web Analytics** aparece na barra lateral para um membro que tenha qualquer uma das duas.

O painel de configurações em si não é restrito: qualquer membro do workspace pode abri-lo e ver a configuração atual somente para leitura, incluindo os domínios permitidos.

## Observações

- Sessões, visualizações de página e metas são armazenadas em três tabelas particionadas por mês no banco de dados do seu workspace. Ainda não existe configuração de retenção: nada é excluído automaticamente.
- Uma sessão guarda no máximo 1000 ações registradas. Depois disso, a visita ainda é contada, mas as novas ações são descartadas.
- Excluir um contato remove o endereço dele de todas as linhas de analytics. O tráfego em si continua lá, anônimo.
- [Referência da API](https://www.notifuse.com/docs/api-reference.md)
