Google Ads API: como puxar gasto e conversões por campanha com GAQL
Consulta GAQL com cost_micros e conversions_value, SearchStream, conversão de micros e uso em agência com várias contas.
Resposta curta: a Google Ads API consulta dados com GAQL (Google Ads Query Language) pelo GoogleAdsService. Para relatório, use SearchStream e leia metrics.cost_micros (gasto em micros, dividido por 1.000.000) e metrics.conversions_value (valor das conversões).
Consulta de campanhas
SELECT
campaign.id, campaign.name, campaign.status,
segments.date,
metrics.impressions, metrics.clicks,
metrics.cost_micros, metrics.conversions, metrics.conversions_value
FROM campaign
WHERE campaign.status != 'REMOVED'
AND segments.date DURING LAST_30_DAYS- segments.date: uma linha por dia, para histórico e pacing.
- Campanhas removidas: a API as devolve, a menos que você filtre.
- SearchStream x Search: o stream é indicado para volumes grandes por não paginar.
Valores em micros
O gasto vem em micros da moeda da conta: 150.000.000 micros = 150,00. Converta antes de somar com outras fontes.
Indicadores derivados
| Indicador | Cálculo |
|---|---|
| Custo | cost_micros ÷ 1.000.000 |
| ROAS | conversions_value ÷ custo |
| CPA | custo ÷ conversions |
| CPC médio | custo ÷ clicks |
| CTR | clicks ÷ impressions |
Uso em agência
- Várias contas: consulte por cliente, usando a conta de administrador quando houver.
- Credenciais: exige token de desenvolvedor, autenticação OAuth e identificação do cliente; guarde com segurança.
- Conversões: o valor depende da configuração das ações de conversão em cada conta. Revise antes de comparar clientes.
Sem programar
Exporte o relatório de campanhas por dia em CSV e envie para a plataforma. Ela conciliará com pedidos ou comissões e gerará o relatório do cliente.