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

# Google Analytics

> Deixe agents responderem perguntas de tráfego e conversão direto do GA4

Conecte o Google Analytics e seus agents respondem as perguntas que normalmente significam montar um relatório na mão: de onde veio o tráfego, quais páginas convertem, como esta semana se compara com a passada. Pergunte em linguagem natural; o agent escolhe as dimensões e métricas certas nas suas propriedades do GA4.

**Esta integração é somente leitura.** Agents executam relatórios; nunca alteram a configuração do seu Analytics.

## O que os agents podem fazer

| Capacidade                        | Detalhes                                                                                             |
| --------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Listar contas e propriedades      | Toda propriedade GA4 que a conta Google conectada consegue ver.                                      |
| Listar fluxos de dados            | Os fluxos de web e app que alimentam cada propriedade.                                               |
| Explorar as métricas disponíveis  | Incluindo suas dimensões e métricas personalizadas.                                                  |
| Executar relatórios               | Qualquer relatório do GA4 — sessões, usuários, conversões, receita — em qualquer intervalo de datas. |
| Executar relatórios em tempo real | Quem está no site agora e o que está fazendo.                                                        |

## Experimente perguntar

* *"Como o tráfego desta semana se compara com o da semana passada?"*
* *"Top 10 páginas por conversões em junho, com o canal de cada uma."*
* *"De onde vêm nossos cadastros — orgânico, pago ou referral?"*
* *"Quantos usuários estão no site agora?"*
* *"Monte um resumo mensal: sessões, novos usuários, taxa de conversão, receita."*

## Conectar o Google Analytics

<Steps>
  <Step title="Abra Integrações">
    No dashboard da Leme, acesse **Integrações** e selecione **Google Analytics**.
  </Step>

  <Step title="Entre com o Google">
    Selecione **Conectar** e aprove com uma conta Google que tenha acesso às propriedades do Analytics que você quer que os agents leiam. Acesso de leitor basta.
  </Step>

  <Step title="Habilite nos seus agents">
    Vincule a conexão aos agents que devem usá-la — agents de marketing e de relatórios são o encaixe usual.
  </Step>
</Steps>

O Google Analytics é uma conexão **compartilhada**: os agents veem as propriedades que a conta conectada vê. Se você quer que os agents alcancem só algumas propriedades, conecte uma conta cujo acesso ao Analytics esteja restrito exatamente a elas.

## Permissões

| Ação                                     | Categoria | Padrão   |
| ---------------------------------------- | --------- | -------- |
| Listar propriedades, executar relatórios | Leitura   | Permitir |

Nada mais a configurar — a integração não tem ações de escrita. Veja [Permissões e aprovações](/pt-BR/permissions) para o modelo geral.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Nenhuma conta ou propriedade aparece">
    A conta Google conectada não tem acesso a nenhum GA4. Conceda a ela pelo menos o papel de Leitor na propriedade, no admin do Analytics, ou reconecte com outra conta.
  </Accordion>

  <Accordion title="Os números diferem um pouco da interface do GA4">
    Pequenas diferenças são normais: o GA4 aplica amostragem e ajustes por atraso de processamento, e os dados recentes (últimas 24–48h) ainda estão assentando. Para comparações exatas, use o mesmo intervalo de datas e fuso horário do relatório no GA4.
  </Accordion>

  <Accordion title="A métrica que o agent usou não é a que eu quis dizer">
    O GA4 tem métricas quase duplicadas (usuários vs. usuários ativos, conversões vs. eventos principais). Nomeie a métrica exata, ou peça ao agent para listar as métricas disponíveis da propriedade e escolham juntos.
  </Accordion>

  <Accordion title="Nossos dados antigos do Universal Analytics não estão lá">
    Apenas propriedades GA4 são suportadas — o Google aposentou o Universal Analytics, e os dados dele não estão disponíveis pelas APIs atuais.
  </Accordion>
</AccordionGroup>