Google Analytics, Search Console e Ads
Produto sem dado de uso é dirigir de olhos fechados. Pra enxergar o que acontece fora da plataforma — tráfego, busca, campanha — o ClubPetro integra o ecossistema Google: Analytics (GA4), Search Console e Ads (além de Facebook Ads). Este post é sobre puxar dado de marketing pra dentro com vibe coding.
Por que trazer esse dado pra dentro
Os dados vivem espalhados em painéis do Google. Trazê-los pra plataforma permite cruzar com o nosso dado (cliente, receita, comportamento) e gerar insight que nenhum painel isolado dá. É Lealdade a Dados na veia: decisão de marketing guiada por evidência consolidada, não por aba aberta em três lugares.
O que integramos
- GA4 (
GA4_PROPERTY_ID) — comportamento e tráfego. - Search Console (
GSC_SITE_URL) — desempenho na busca orgânica. - Google Ads (client id, secret, developer token, customer id) — campanhas pagas.
- Facebook Ads — o outro lado da mídia paga.
Acesso via service account (GOOGLE_SERVICE_ACCOUNT_KEY) — credencial de máquina, não login de pessoa.
As armadilhas específicas de API do Google
Aqui a IA ajuda, mas o terreno tem pedras conhecidas:
- Autenticação é a parte difícil. Service account, escopos, permissão na propriedade — é onde a maioria trava. A integração só funciona depois que o acesso está concedido do lado do Google.
- Rate limits e cotas são reais e variam por API. Puxar muito dado pede paginação e respeito à cota (#37).
- Latência e volume. Relatório pesado demora; o padrão é puxar em background (Trigger.dev, Módulo 4) e gravar, não puxar ao vivo na tela.
- A API muda. Versões do GA4/Ads mudam de assinatura — alimente a doc atual na IA, não a memória dela (#33).
O padrão que se repete
Igual ao resto do módulo: cliente abstraído, secrets em env, resiliência, degradação graciosa. Dado de marketing é importante, mas se o Google oscila, a plataforma não pode cair junto — mostra o último dado conhecido e segue.
O uso maduro
A graça não é ter o número do Google replicado — é cruzar com o nosso. "Esse canal traz cliente que fica?", "essa campanha vira receita?". A integração é meio; o insight cruzado é o fim.
⚠️ Armadilha #36: subestimar a autenticação do Google e orçar a integração como "só chamar a API". A chamada é a parte fácil. Service account, escopos e permissões são onde o tempo de verdade vai.
Próximo da série: #37 — Rate limit, retry, idempotência e secrets.