Conectando GA4 ao n8n

No exemplo anterior, reunimos custo, cliques e impressões de campanhas. Agora falta observar o que acontece depois que as pessoas chegam ao site. O GA4 pode fornecer relatórios de sessões e eventos, mas uma coleta automática não corrige uma medição mal configurada. Antes de montar o fluxo, a equipe precisa concordar sobre quais ações realmente importam.

Este é um exemplo didático e anonimizado. As telas de workflows servem de referência para a ideia de arquitetura, não como prova de resultados de uma operação específica.

Escolha a pergunta e a granularidade

Imagine que a pergunta seja: “Como evoluíram as sessões e as ações relevantes vindas de diferentes canais?” Para respondê-la, escolha dimensões e métricas compatíveis na Google Analytics Data API. Um relatório pode combinar período, dimensão de aquisição e métricas de atividade. A consulta deve ser testada com a propriedade real, porque nem toda combinação produz a mesma interpretação.

Defina se a tabela terá uma linha por dia e canal, por dia e campanha ou por outra combinação. Registre o ID da propriedade, a data, o fuso considerado e a data de coleta. Se mudar a granularidade depois, não misture linhas antigas e novas na mesma série sem marcar a mudança.

Organize o fluxo

Uma sequência possível é gatilho programado → requisição à Data API → validação da resposta → classificação das linhas → gravação. A chamada `runReport` retorna um relatório com as dimensões e métricas solicitadas. O n8n pode orquestrar a execução, transformar a resposta e direcionar linhas para o armazenamento escolhido.

Uma etapa de classificação pode separar, por exemplo, agregados por dia, canal ou ação. Isso não significa que o GA4 já tenha “tabelas prontas” para esses destinos. A separação é uma escolha de modelagem da equipe, que precisa ser documentada. O banco deve impedir duplicidade por propriedade, período e dimensões da linha. Quando for necessário reprocessar um dia, a atualização deve substituir o registro correspondente, não somar a mesma carga duas vezes.

Credenciais e permissões devem ficar em ambiente protegido. Os logs precisam mostrar resultado e falhas da execução sem expor tokens ou respostas que contenham dados sensíveis.

Verifique a qualidade do dado

Faça uma consulta manual para poucos dias e compare as linhas com o relatório do GA4 usando as mesmas definições. Confira se a propriedade recebe os eventos esperados, se há atraso no processamento e se as dimensões de aquisição refletem a pergunta escolhida. Valores ausentes precisam de tratamento explícito; substituir tudo por “zero” pode esconder falhas de medição.

Também vale medir a saúde do próprio fluxo: última coleta bem-sucedida, quantidade de linhas retornadas, período coberto e diferença em relação à execução anterior. Um workflow pode terminar sem erro de infraestrutura e ainda assim trazer um relatório vazio por filtro incorreto.

O que não concluir dessa coleta

Sessões do GA4 não são cliques do Google Ads. As duas plataformas têm escopos, critérios e janelas diferentes. Uma diferença entre os números pede investigação; não prova, sozinha, perda de tráfego ou defeito de integração. O objetivo da coleta é tornar essas diferenças visíveis e analisáveis.

Na etapa seguinte, Ads e GA4 serão exibidos em uma visão comum, mantendo o nome e a origem de cada métrica. Essa separação evita que um painel bonito crie uma falsa equivalência.

Perguntas frequentes

Posso coletar qualquer métrica do GA4?

Consulte a documentação da Data API e os metadados da propriedade para verificar disponibilidade, escopo e combinação com as dimensões escolhidas.

O n8n corrige eventos que o site não registrou?

Não. O fluxo trabalha com o que a propriedade disponibiliza. A instrumentação do site deve ser validada separadamente.

Devo consultar o dia atual?

Depende da necessidade. Dados recentes podem mudar; defina uma janela de reprocessamento e indique no painel quando cada período foi atualizado.

Antes de ampliar o painel, documente as definições de sessão, evento e período. A Koddahub pode ajudar a transformar essas definições em uma coleta auditável.