Integração com a Google Ads API
Esta página descreve a ferramenta interna que a Ullr usa para gerar os relatórios de performance dos clientes, e existe para deixar claro o escopo do acesso: leitura de relatório, nada além disso.
O negócio
A Ullr é uma operação de gestão de tráfego pago conduzida por Thiago Santos, no Rio Grande do Sul. O serviço é estruturar, gerenciar e medir campanhas de Google Ads e Meta Ads para clientes de pequeno e médio porte, entre eles escritórios de advocacia, clínicas e comércio.
O faturamento vem do serviço de gestão prestado a esses clientes. Não há venda de software, de assinatura ou de dados. A ferramenta descrita aqui não é um produto: é um script interno que alimenta o relatório que eu entrego.
Quem usa a aplicação
Um único operador, eu mesmo. Não há login de cliente, não há painel de terceiros, não há acesso de outra agência. Os clientes recebem o resultado do trabalho em um relatório, nunca acesso à ferramenta.
O que a aplicação faz
Um script em Python autentica por OAuth na conta gerente (MCC 745-231-3397) e roda consultas GAQL de relatório nas contas de cliente que estão sob essa gerência. O resultado é gravado em CSV, localmente, e serve de base para o relatório semanal.
| Item | Valor |
|---|---|
| Tipo de acesso | Somente leitura (Reporting) |
| Usuários | Interno, um operador |
| Tipos de campanha | Search e social |
| Contas acessadas | Apenas as vinculadas ao MCC, com autorização do cliente |
| Frequência | Semanal, sob execução manual |
| Saída | Arquivo CSV local |
Campos lidos
Métricas de campanha por dia (custo, impressões, cliques, conversões) e, quando necessário, o relatório de termos de pesquisa, que é o que permite identificar desperdício e propor palavras negativas.
Exemplo da saída
O que a aplicação não faz
- Não cria, pausa nem edita campanhas, grupos de anúncios ou anúncios.
- Não altera orçamento, lance ou estratégia de lances.
- Não gerencia palavras-chave pela API. As negativas são aplicadas manualmente na interface, depois da minha análise.
- Não acessa conta em que eu não seja gestor autorizado pelo próprio cliente.
- Não expõe dado a terceiros, não revende e não publica dado de cliente.
- Não oferece painel, login ou API para o cliente final.
Dados e privacidade
Os CSVs ficam em armazenamento local, separados por conta de cliente, e são usados apenas para produzir o relatório daquele cliente. Nenhum dado pessoal de usuário final é coletado pela aplicação: as métricas são agregadas por campanha e por dia. As credenciais da API ficam fora de controle de versão.
Stack
- Python com a biblioteca oficial google-ads, autenticação OAuth 2.0.
- Google Analytics 4 e Google Tag Manager para a medição no site do cliente.
- Planilhas e CSV para o relatório entregue.
Summary in English
Ullr is a paid traffic management business run by Thiago Santos in Rio Grande do Sul, Brazil. We structure, manage and measure Google Ads and Meta Ads campaigns for small and medium businesses. Revenue comes from the management service, not from software or data.
The application described on this page is an internal, read-only reporting tool. A Python script authenticates via OAuth against our manager account (MCC 745-231-3397) and runs GAQL reporting queries against client accounts linked to that manager, writing the results to local CSV files that feed the weekly report we deliver to each client.
Scope: Reporting only. The tool does not create, pause or modify campaigns, ad groups, ads, budgets or bids. It does not access any account where we are not an authorised manager. There is no client-facing dashboard, no login for third parties, and no resale or redistribution of data. Users of the tool: internal only, a single operator.