Conectando Google Ads ao n8n

Investimento, cliques e impressões aparecem no Google Ads. Sessões e ações no site aparecem no GA4. Quando cada equipe consulta uma tela diferente, a pergunta “o tráfego pago está ajudando o negócio?” demora mais a ser respondida. Um primeiro passo é criar uma coleta confiável dos dados de mídia, antes de tentar unir tudo em um painel.

Este é um exemplo didático e anonimizado de arquitetura. Ele não reproduz um workflow de cliente nem promete conciliação perfeita entre plataformas.

Defina a pergunta antes de configurar o fluxo

Suponha que a equipe queira acompanhar diariamente custo, cliques e impressões por campanha. A granularidade escolhida é uma linha por conta, campanha e dia. Essa decisão determina a consulta ao Google Ads, a chave de armazenamento e a forma de comparação posterior. Se o objetivo mudar para hora ou dispositivo, a estrutura precisa ser revista: adicionar dimensões pode multiplicar linhas e alterar o significado de totais.

Também é preciso registrar a moeda da conta, o fuso horário usado na extração e a data a que cada número se refere. Sem esses campos, duas linhas com a mesma data podem representar períodos diferentes. Para custo, confira a unidade retornada pela API e converta apenas uma vez, com teste explícito.

Um fluxo possível no n8n

A arquitetura tem quatro etapas. Um gatilho inicia a coleta no horário definido. A etapa de origem consulta o relatório autorizado do Google Ads ou recebe uma carga de um serviço que já faz essa consulta. Uma etapa de transformação valida os campos e produz um formato comum. Por fim, uma operação de gravação insere ou atualiza as linhas na base de dados.

Em termos de fluxo: agendamento ou entrada controlada → coleta → normalização → gravação idempotente. “Idempotente” significa que repetir a mesma carga não deve duplicar o mesmo registro. Uma chave lógica pode combinar fonte, conta, campanha e data, desde que corresponda exatamente à granularidade escolhida. O banco deve impor essa unicidade; não dependa apenas de uma verificação visual no workflow.

Se houver um webhook na entrada, proteja-o. Defina autenticação, limites de acesso e validação do corpo recebido. Uma URL pública por si só não garante que a carga veio da fonte esperada. Nunca coloque credenciais, identificadores privados ou respostas integrais de API em capturas de tela publicadas.

O que validar antes de confiar nos números

Compare uma janela pequena com o relatório original, mantendo os mesmos filtros, datas e fuso. Verifique se custo, cliques e impressões têm o tipo correto; se campanhas sem movimento devem aparecer; e se uma reexecução atualiza a mesma linha. Registre quando a carga foi coletada e se ela terminou com sucesso. Alertas devem destacar falhas e ausência de dados, não apenas exceções técnicas.

Não some indiscriminadamente métricas de fontes diferentes. Cliques do Google Ads e sessões do GA4 descrevem eventos distintos; uma pessoa pode clicar e não gerar uma sessão medida, ou gerar várias sessões ao longo do tempo. A base única melhora o acesso e a comparação, mas não transforma essas métricas em equivalentes.

Quando esse exemplo ajuda

A abordagem faz sentido quando há rotina de consulta repetitiva, necessidade de histórico próprio e alguém responsável por monitorar o fluxo. Para um volume pequeno e uma pergunta pontual, exportar um relatório pode ser suficiente. Se a coleta se tornar crítica, documente permissões, limites da API, política de reprocessamento e manutenção do banco.

No próximo exemplo da série, a mesma disciplina será aplicada aos dados do GA4. Só depois vale desenhar uma camada de análise que mostre as duas fontes lado a lado.

Perguntas frequentes

O n8n substitui o Google Ads?

Não. Ele orquestra etapas de coleta e transformação; a fonte continua sendo o Google Ads ou um serviço autorizado que consulte seus relatórios.

Posso comparar cliques com sessões como se fossem a mesma métrica?

Não. Use-os como indicadores de etapas diferentes e investigue divergências antes de atribuir uma causa.

Preciso guardar todos os campos da API?

Não. Guarde os necessários para a pergunta de negócio, com identificadores, período, origem e metadados de coleta suficientes para auditoria.

Se sua equipe precisa reunir fontes de tráfego, comece pela definição das métricas e do período. A Koddahub pode ajudar a desenhar a coleta e a validação antes de montar o painel.