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

# Google Analytics 4

> Adiciona o Google Analytics 4 ao teu projeto Macaly

O Google Analytics 4 (GA4) mostra-te quem visita o teu site, de onde vem e o que faz. É a ferramenta padrão para compreender o tráfego de um site.

O agente adiciona-o num único passo. Só precisas do teu measurement ID.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

<Note>
  **O Macaly também tem análises integradas.** Se só quiseres ver visualizações de página e contagens de visitantes, dá uma vista de olhos às [Análises](/docs/pt/features/analytics). Funciona logo de início, sem configuração. O GA4 é para quando precisas de dados mais aprofundados, segmentação de audiências ou integração com o Google Ads.
</Note>

## Porquê usar o Google Analytics 4

* **Sabe exatamente de onde vêm os teus visitantes.** Vê quais os canais que trazem tráfego: pesquisa orgânica, redes sociais, anúncios ou visitas diretas.
* **Mede o que realmente importa.** Define objetivos como registos, compras ou envios de formulários e acompanha o quão bem o teu site converte.
* **Compreende como as pessoas usam o teu site.** Vê em que páginas passam tempo, onde desistem e que dispositivos usam.
* **Torna os teus anúncios mais inteligentes.** Se usares o Google Ads, o GA4 devolve dados de conversão para poderes otimizar o teu investimento.

## O que precisas

Antes de começares, garante que tens:

* Uma **conta Google Analytics**. Cria uma gratuitamente em [analytics.google.com](https://analytics.google.com)
* O teu **Measurement ID**. Tem um formato como `G-XXXXXXXXXX` e encontras em **Admin → Data Streams → o teu stream**

<Accordion title="Como encontrar o teu Measurement ID">
  1. Vai a [analytics.google.com](https://analytics.google.com)
  2. Clica em **Admin** (ícone de engrenagem) no canto inferior esquerdo
  3. Em **Data collection and modification**, clica em **Data streams**
  4. Clica no teu web stream (ou cria um se ainda não tiveres)
  5. O teu **Measurement ID** aparece no topo. Começa com `G-`
</Accordion>

## Adiciona o GA4 ao teu projeto

Abre o chat no teu projeto Macaly e pede ao agente:

```
Adiciona o Google Analytics 4 ao meu site. O meu measurement ID é G-XXXXXXXXXX.
```

O agente adiciona o script de monitorização do GA4 ao teu projeto. As visualizações de página são monitorizadas automaticamente a partir do momento em que fica em produção.

<Tip>
  Substitui `G-XXXXXXXXXX` pelo teu measurement ID real.
</Tip>

## Verifica que está a funcionar

<Steps>
  <Step title="Abre o relatório Realtime do GA4">
    Vai a [analytics.google.com](https://analytics.google.com) e clica em **Reports → Realtime** na barra lateral esquerda.
  </Step>

  <Step title="Visita o teu site">
    Abre o teu projeto Macaly publicado num separador do browser.
  </Step>

  <Step title="Verifica a atividade">
    Em poucos segundos, deverás ver-te a ti próprio como utilizador ativo no relatório Realtime. Se navegares entre páginas, verás aparecer eventos de visualização de página.
  </Step>
</Steps>

<Info>
  Os dados em tempo real aparecem em segundos. Os relatórios padrão do GA4 podem demorar entre 24 e 48 horas a preencher-se por completo.
</Info>

## Monitoriza mais do que visualizações de página

O GA4 monitoriza automaticamente as visualizações de página, mas podes ir mais além. Pede ao agente para adicionar monitorização a ações específicas:

| O que monitorizar | Prompt de exemplo |
| - | - |
| **Cliques em botões** | *"Monitoriza quando alguém clica no botão 'Começar' como um evento GA4 chamado `cta_click`"* |
| **Envios de formulários** | *"Envia um evento GA4 chamado `form_submit` quando o formulário de contacto for enviado"* |
| **Compras** | *"Monitoriza compras como eventos GA4 `purchase` com o valor da encomenda"* |
| **Registos** | *"Dispara um evento GA4 `sign_up` quando um utilizador criar uma conta"* |

O agente adiciona o código de monitorização e envia os eventos para o GA4, para que apareçam nos teus relatórios.

## GA4 vs Google Tag Manager

* **Usa o GA4 diretamente** se só precisares de análises. É mais simples e ficas pronto com uma mensagem.
* **Usa o [Google Tag Manager](/docs/pt/integrations/google-tag-manager)** se planeares adicionar várias ferramentas. O GTM permite-te gerir o GA4, o Meta Pixel e outros a partir de um único painel.

<Info>
  **Consentimento de cookies.** O GA4 define cookies para identificar visitantes recorrentes. Se o teu site tiver visitantes da UE, do Reino Unido ou de outras regiões com leis de privacidade, és responsável por garantir que existe uma solução de consentimento de cookies antes de o GA4 carregar. O agente pode configurá-la por ti com o [Iubenda](/docs/pt/integrations/iubenda).
</Info>

## Boa a saber

* Os eventos GA4 podem demorar **24 a 48 horas** a aparecer nos relatórios padrão. Usa o relatório **Realtime** para verificar de imediato
* Os **eventos integrados** como visualizações de página, scrolls, cliques de saída e downloads de ficheiros são monitorizados automaticamente assim que o GA4 estiver ativo
* Podes ligar o GA4 ao **Google Search Console** para veres que pesquisas trazem pessoas ao teu site
* Se adicionares o GA4 através do [Google Tag Manager](/docs/pt/integrations/google-tag-manager), não precisas de o adicionar diretamente também. Isso duplicaria a contagem dos teus dados


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.