Logotipo do Google Analytics 4

Análise web

Conectar Google Analytics 4 para Excel, Planilhas Google, IA e REST

Dados de eventos e tráfego do GA4 em SQL. Integre-os ao Search Console e ao seu banco de dados de produtos sem precisar exportar os dados para o BigQuery.

Comece gratuitamente 13 destinos

Uma conexão, todas as superfícies

Para onde seus dados GA4 podem ir

Google Analytics 4 dados de API em tempo real como tabelas SQL
Consultas federadas + qualquer outro conector · um SQL de todas as fontes · todos os planos
Agente de rede
  • 1 conexão de saída
  • 0 portas de entrada
  • Somente leitura · credenciais permanecem inalteradas

funciona em

O Query Streams transforma uma propriedade do GA4 em 9 tabelas SQL — visão geral do tráfego, fontes de tráfego, páginas, eventos, engajamento, geografia, comércio eletrônico, transações e uma tabela de usuários ativos em tempo real — legíveis no Microsoft Excel, Google Sheets, Power BI, assistentes de IA via MCP e um endpoint REST. Sem exportação para o BigQuery, sem projeto vinculado, sem espera de 24 horas para que uma tabela apareça: uma chave de conta de serviço e um ID de propriedade, e os dados já podem ser consultados.

  1. Para sua equipe, fornecedores e parceiros.

  2. GA4 para Excel Microsoft Excel · Suplemento do Excel

    Importe resultados do GA4 em tempo real diretamente para uma planilha e atualize-os sob demanda — Excel para desktop, Excel Online, Microsoft 365.

    Guia GA4

  3. GA4 para Planilhas Google Suplemento de planilhas

    Execute uma consulta GA4 salva na barra lateral e arraste as linhas para a planilha. Os colaboradores que compartilharam a planilha podem atualizá-la por conta própria.

    Guia GA4

  4. Pergunte à Nova sobre o GA4. Nova AI · texto para SQL

    Faça uma pergunta em linguagem simples. O Nova já conhece suas tabelas GA4, escreve e executa o SQL, explica a resposta e a exibe em um gráfico — sem necessidade de escrever consultas ou fornecer credenciais.

    Como funciona o Nova

  5. GA4 para Visualizador de Dados Compartilhamento de resultados · equipe, fornecedores, parceiros · celular, tablet, computador

    Compartilhe um resultado do GA4 em tempo real com qualquer pessoa — um colega, um fornecedor, um parceiro — como uma tabela que pode ser adicionada aos favoritos e que é atualizada automaticamente ao ser aberta em um celular, tablet ou computador. Eles veem os resultados, nunca o SQL ou as credenciais.

    Como funciona o Visualizador de Dados
  6. Para aplicativos e sistemas

  7. API REST GA4 endpoint HTTP

    Publique uma consulta GA4 como um endpoint JSON autenticado que qualquer aplicativo pode chamar, com uma especificação OpenAPI 3.1 e coleções prontas para Postman, Insomnia e Hoppscotch. Nenhuma porta de banco de dados é aberta.

    Como funciona a API REST

  8. GA4 para Power BI Power Query M

    Cole o arquivo M do Power Query gerado no Editor Avançado do Power BI e o relatório exibirá os resultados do GA4 em tempo real via HTTPS — sem driver ODBC, sem porta de banco de dados aberta.

    Como funciona o Power BI

  9. GA4 para Airtable Plataforma de automação

    Sincronize linhas do GA4 em uma base do Airtable de acordo com uma programação ou busque-as dentro de um script de automação do Airtable.

    Guia GA4

  10. GA4 para Baserow Plataforma de automação

    Alimente uma tabela Baserow do GA4 através do endpoint REST — hospedado localmente ou na nuvem Baserow.

    Guia GA4

  11. GA4 para SeaTable Plataforma de automação

    Mantenha uma base SeaTable atualizada com dados GA4 sem exportar um arquivo ou expor o banco de dados.

    Guia GA4

  12. GA4 para Smartsheet Plataforma de automação

    Integre os resultados do GA4 a uma planilha do Smartsheet para que os planos e relatórios sejam lidos do sistema de origem, e não da exportação da semana passada.

    Guia GA4

  13. GA4 para Anvil Anvil Works · Plataforma de aplicativos

    Faça backup de um aplicativo Anvil Python com GA4 por meio do endpoint REST, em vez de incorporar as credenciais do banco de dados no aplicativo.

    Guia GA4
  14. Para ferramentas de IA

  15. Servidor GA4 MCP Clientes Claude, Cursor e MCP

    Conceda ao assistente de IA acesso somente leitura ao GA4 com o esquema necessário para escrever SQL corretamente — sem credenciais no chat.

    Guia GA4
  16. Entregue às pessoas

  17. Alertas e relatórios GA4 Slack · Discord · E-mail · Webhook

    Programe uma consulta GA4 para que os resultados sejam entregues no Slack, Discord, por e-mail ou por um webhook assinado — ou retenha a mensagem até que a contagem de linhas, um limite ou uma variação percentual ultrapasse o valor definido.

    Como funcionam os alertas e relatórios

Como funciona

5 etapas, sem alteração no firewall de entrada

01

Crie uma conta de serviço do Google e conceda a ela acesso de leitura à propriedade GA4.

02

Instale o Agente de Rede e forneça a chave da conta de serviço e o ID numérico da propriedade. A chave permanece no agente.

03

Escolha qual das 9 tabelas sincronizar. Visão geral do tráfego, fontes de tráfego, visualizações de página e eventos estão ativados por padrão.

04

Escreva SQL comum para ga4.traffic_sources, ga4.page_views e o restante — ou deixe o Nova fazer isso.

05

Leia os dados no Excel, Planilhas Google, Power BI, MCP ou REST, integrados à plataforma que armazena seus cadastros e receitas.

Análise detalhada do recurso

O que o GA4 lhe oferece

Sem o desvio pelo BigQuery

A maneira usual de importar dados do GA4 para o SQL é vincular um projeto do BigQuery, aguardar o início da exportação, pagar pelo armazenamento e, em seguida, consultar uma tabela de eventos aninhada. Este método elimina todas essas etapas.

  • Os dados provêm da própria API de relatórios do GA4, portanto, não há exportação para configurar nem nada a esperar.
  • Na primeira sincronização, ele lê o histórico desde o lançamento do GA4 em outubro de 2020, portanto, o histórico está lá em vez de começar desde o dia em que você o configurou.
  • As fileiras chegam como agregados de grãos diurnos com colunas nomeadas. — data, origem, meio, campanha, canal, sessões, usuários, taxa de engajamento — em vez de blocos de eventos aninhados que você precisa desaninhar.
  • A resposta completa da API é armazenada em uma coluna JSON chamada raw_data.

As 9 mesas

  • Tráfego — Visão geral do tráfego, fontes de tráfego, visualizações de página, engajamento do usuário.
  • Público — dados geográficos, eventos.
  • Comércio — Visão geral do comércio eletrônico, transações.
  • Agora — usuários_ativos_em_tempo_real.

Dois relógios, e qual mesa funciona com qual?

O GA4 possui uma versão para processamento em lote e outra para processamento em tempo real, e elas se comportam de maneira diferente. Ter clareza sobre isso é o que diferencia um relatório confiável de um relatório com o qual você pode questionar.

  • As oito tabelas de lotes abrangem o período até ontem. O GA4 não finaliza os números de um dia por um ou dois dias, portanto, cada passagem incremental lê novamente os três dias anteriores e permite que os números se estabilizem, em vez de congelar a primeira versão visualizada.
  • realtime_active_users está realmente online — uma janela móvel de trinta minutos, atualizada sob demanda quando uma consulta a acessa, com uma janela de atualização de trinta segundos.
  • Essa tabela é um instantâneo, não um histórico: ela responde quem está no site agora, não quem estava nele às quatro horas de ontem.

Compartilhado por todos os conectores de API.

Como funciona cada conector de API

  • Sua conta se transforma em mesas — Os endpoints são mapeados para tabelas SQL tipadas com chaves primárias e índices, então você escreve SELECT, JOIN e GROUP BY em vez de percorrer o JSON.
  • Você escolhe o que será sincronizado e com que frequência. — Cada tabela tem seu próprio intervalo, ou nenhum. Quando a API do fornecedor oferece suporte, somente os registros que foram alterados desde a última execução são recuperados.
  • A cópia é sua. — Ele reside em um arquivo DuckDB criptografado com AES-256-GCM, localizado ao lado do agente, em sua máquina. Não está em nossa nuvem.
  • O fornecedor só recebe notícias suas. — o agente chama a API diretamente da sua própria rede, portanto, o Query Streams não precisa do seu token para responder a uma consulta.

Bom saber

  • É uma cópia sincronizada, não um proxy em tempo real. — Uma consulta lê o que já foi buscado, portanto, retorna na velocidade do SQL e nunca consome seu limite de taxa da API. Tabelas selecionadas também podem atualizar uma linha desatualizada à medida que você a lê.
  • Os limites de tarifa são respeitados para você. — cada conector opera bem dentro dos limites publicados pelo fornecedor, portanto, um relatório não pode fazer com que sua conta seja limitada para todos os outros usuários que o utilizam.
  • Nada é desperdiçado. — Os campos que a tabela não nomeia são mantidos em uma coluna JSON raw_data que você ainda pode consultar.
  • Integre-o aos seus bancos de dados. — Uma tabela de API e uma tabela do SQL Server na mesma instrução é uma consulta comum aqui, não um projeto de integração.

SQL entre fontes diferentes

Integre o GA4 ao restante dos seus dados.

O GA4 sabe de qual fonte a sessão veio, mas não sabe o seu valor. Seu banco de dados conhece a conta e seu processador de pagamentos conhece o dinheiro. Uma única instrução pode colocar os três lado a lado. Cada fonte executa apenas a parte que consegue, transmite o resultado de volta e a junção ocorre de forma centralizada — as fontes nunca se comunicam entre si e nada é copiado para lugar nenhum.

3 conexões · 3 agentes

Google Analytics 4 Análise web
PostgreSQL Motor relacional
Listrado Pagamentos e faturamento

Uma declaração

-- sessões do GA4, a conta do seu banco de dados, receita do Stripe
SELECIONAR   g.session_source, SUM(g.sessions) AS sessions, SUM(i.amount_due) AS invoiced
DE     ga4_site.ga4.fontes_de_tráfego1 g
JUNTAR     pg_crm.clientes.públicos2      c LIGADO c.utm_source = g.session_source
JUNTAR     cobrança.stripe.faturas3      i LIGADO i.cliente = c.stripe_id
GRUPO POR g.session_source
ORDER BY faturado DESC;

As três partes são conexão, esquema e tabela — e o nome da conexão é o que você definiu. Colunas ilustrativas; suas tabelas serão suas tabelas. As tabelas em lote do GA4 são executadas até o dia anterior, portanto, o dia mais recente em um relatório como este é o dia anterior a hoje — essa é a janela de finalização do próprio GA4, não um atraso de sincronização. O modo somente leitura se aplica a todos os elementos: apenas SELECT, WITH e EXPLAIN, com um limite máximo de dados que uma única fonte pode fornecer para uma única consulta. Como funcionam as consultas federadas

Detalhes da conexão

O que o GA4 precisa

Autenticação
Uma chave de conta de serviço do Google com acesso de leitura à propriedade, armazenada no agente. Escopo somente leitura.
Propriedade
O ID numérico da propriedade GA4
Estendeu a mão por cima
HTTPS da sua rede para a API de dados do GA4. Nada de entrada.
Esquema
ga4 — então ga4.traffic_sources, ga4.page_views
Tabelas
9, dos quais quatro estão ativados por padrão: traffic_overview, traffic_sources, page_views, events
Frescor
As tabelas de lotes são executadas até ontem, com os três dias anteriores sendo relidos a cada passagem, conforme o GA4 as finaliza.
História
Retornar a 01/10/2020 na primeira sincronização
Atualização ao vivo
realtime_active_users apenas — uma janela contínua de 30 minutos com uma janela de atualização de 30 segundos
Cópia local
Um arquivo DuckDB criptografado com AES-256-GCM ao lado do agente, em sua máquina.

A tabela em tempo real é limitada às primeiras centenas de combinações que o Google retorna em um instantâneo, o que é uma limitação da API em tempo real e não deste conector. Para uma visão completa do dia, use as tabelas em lote.

Em uma consulta entre fontes, a parte intermediária de uma referência de três partes é ga4. Uma conexão chamada ga4_site que lê fontes de tráfego é escrita como ga4_site.ga4.traffic_sources.

Documentação do fornecedor: marketingplatform.google.com

Perguntas frequentes

Perguntas sobre o Google Analytics 4

Quais ferramentas conseguem ler dados do Google Analytics 4 por meio de fluxos de consulta?

Tudo isso, a partir de uma única conexão: Excel, Planilhas Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e relatórios agendados. Conecte a conta uma única vez e todas as plataformas lerão a mesma conexão somente leitura — não há configuração por ferramenta nem necessidade de uma segunda cópia dos dados.

Preciso abrir uma porta no firewall para minha conta do Google Analytics 4?

Não. O Agente de Rede do Query Streams é executado dentro da sua rede e abre uma única conexão criptografada de saída. Nada fica à escuta do tráfego de entrada, nenhuma VPN é necessária e a conta mantém suas regras de firewall existentes.

É possível alterar dados usando o recurso Query Streams no Google Analytics 4?

Não. O agente impõe o modo somente leitura no ponto de execução — uma instrução por vez, apenas SELECT e similares. As credenciais permanecem no agente e nunca são enviadas para o Query Streams.

O que o Query Streams precisa para se conectar ao Google Analytics 4?

Um host acessível, uma função e sua senha — o agente carrega o driver, portanto, nada é instalado na conta. Autenticação: uma chave de conta de serviço do Google com acesso de leitura à propriedade, armazenada no agente. Escopo somente leitura. Propriedade: o ID numérico da propriedade GA4. Acessado via: HTTPS da sua rede para a API de Dados do GA4. Sem tráfego de entrada. Esquema: ga4 — portanto, ga4.traffic_sources, ga4.page_views.

Posso combinar o Google Analytics 4 com outro banco de dados na mesma consulta?

Sim, trata-se de uma consulta federada. Uma única instrução pode referenciar o Google Analytics 4 e suas outras conexões simultaneamente, escritas como conexão.esquema.tabela. Cada origem executa apenas a parte que consegue e transmite o resultado de volta; a junção ocorre centralmente, portanto, as origens nunca se conectam entre si e nada é copiado ou agendado. O modo somente leitura se aplica a cada parte — apenas SELECT, WITH e EXPLAIN — e há um limite para a quantidade de dados que uma origem pode fornecer em uma única consulta. Consultas federadas são um recurso do plano; a página de consultas federadas exibe os limites atuais de origem e tamanho.

Coloque o GA4 onde o trabalho acontece.

Instale o agente, aponte-o para sua conta e escolha um destino.

Comece gratuitamente Todos os conectores

Somente leitura Apenas envio As credenciais permanecem com o agente.