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

> Adicione o Google Analytics 4 ao seu projeto no Macaly

O Google Analytics 4 (GA4) mostra quem visita seu site, de onde essas pessoas vêm e o que fazem nele. É a ferramenta padrão para entender o tráfego de um site.

O agente o adiciona em uma única etapa. Você só precisa do seu ID de métricas.

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

<Note>
  **O Macaly também tem analytics integrado.** Se você só quer ver visualizações de página e número de visitantes, confira [Analytics](/docs/pt-BR/features/analytics). Ele funciona de imediato, sem configuração. O GA4 é para quando você precisa de insights mais profundos, segmentação de público ou integração com o Google Ads.
</Note>

## Por que usar o Google Analytics 4

* **Saiba exatamente de onde vêm seus visitantes.** Veja quais canais trazem tráfego: busca orgânica, redes sociais, anúncios ou acessos diretos.
* **Meça o que realmente importa.** Defina metas como cadastros, compras ou envios de formulário e acompanhe o quanto seu site converte.
* **Entenda como as pessoas usam seu site.** Veja em quais páginas elas passam mais tempo, onde desistem e quais dispositivos usam.
* **Deixe seus anúncios mais inteligentes.** Se você usa o Google Ads, o GA4 devolve os dados de conversão para você otimizar seu investimento.

## O que você precisa

Antes de começar, confira se você tem:

* Uma **conta do Google Analytics**. Crie uma gratuitamente em [analytics.google.com](https://analytics.google.com)
* Seu **ID de métricas** (Measurement ID). Ele tem o formato `G-XXXXXXXXXX` e fica em **Administrador → Fluxos de dados → seu fluxo**

<Accordion title="Como encontrar seu ID de métricas">
  1. Acesse [analytics.google.com](https://analytics.google.com)
  2. Clique em **Administrador** (ícone de engrenagem) no canto inferior esquerdo
  3. Em **Coleta e modificação de dados**, clique em **Fluxos de dados**
  4. Clique no seu fluxo da Web (ou crie um, se ainda não tiver)
  5. O **ID de métricas** fica no topo. Ele começa com `G-`
</Accordion>

## Adicione o GA4 ao seu projeto

Abra o chat no seu projeto do Macaly e peça ao agente:

```
Adicione o Google Analytics 4 ao meu site. Meu ID de métricas é G-XXXXXXXXXX.
```

O agente adiciona o script de rastreamento do GA4 ao seu projeto. As visualizações de página são registradas automaticamente a partir do momento em que ele entra no ar.

<Tip>
  Substitua `G-XXXXXXXXXX` pelo seu ID de métricas real.
</Tip>

## Confira se está funcionando

<Steps>
  <Step title="Abra o relatório Tempo real do GA4">
    Acesse [analytics.google.com](https://analytics.google.com) e clique em **Relatórios → Tempo real** na barra lateral esquerda.
  </Step>

  <Step title="Visite seu site">
    Abra seu projeto publicado no Macaly em uma aba do navegador.
  </Step>

  <Step title="Procure atividade">
    Em poucos segundos, você deve aparecer como usuário ativo no relatório Tempo real. Se você navegar entre páginas, verá eventos de visualização de página aparecerem.
  </Step>
</Steps>

<Info>
  Os dados em tempo real aparecem em segundos. Os relatórios padrão do GA4 podem levar de 24 a 48 horas para serem preenchidos por completo.
</Info>

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

O GA4 rastreia visualizações de página automaticamente, mas você pode ir além. Peça ao agente que adicione rastreamento para ações específicas:

| O que rastrear | Exemplo de prompt |
| - | - |
| **Cliques em botões** | *"Registre quando alguém clicar no botão 'Começar' como um evento do GA4 chamado `cta_click`"* |
| **Envios de formulário** | *"Envie um evento do GA4 chamado `form_submit` quando o formulário de contato for enviado"* |
| **Compras** | *"Registre as compras como eventos `purchase` do GA4 com o valor do pedido"* |
| **Cadastros** | *"Dispare um evento `sign_up` do GA4 quando um usuário criar uma conta"* |

O agente adiciona o código de rastreamento e envia os eventos ao GA4 para que apareçam nos seus relatórios.

## GA4 vs. Google Tag Manager

* **Use o GA4 diretamente** se você só precisa de analytics. É mais simples e você resolve tudo em uma mensagem.
* **Use o [Google Tag Manager](/docs/pt-BR/integrations/google-tag-manager)** se pretende adicionar várias ferramentas. O GTM permite gerenciar o GA4, o Meta Pixel e outras ferramentas em um único painel.

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

## Bom saber

* Os eventos do GA4 podem levar de **24 a 48 horas** para aparecer nos relatórios padrão. Use o relatório **Tempo real** para conferir na hora
* **Eventos integrados**, como visualizações de página, rolagens, cliques em links externos e downloads de arquivos, são rastreados automaticamente assim que o GA4 está ativo
* Você pode conectar o GA4 ao **Google Search Console** para ver quais pesquisas levam pessoas ao seu site
* Se você adicionar o GA4 pelo [Google Tag Manager](/docs/pt-BR/integrations/google-tag-manager), não precisa adicioná-lo diretamente. Isso duplicaria a contagem dos seus dados


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