GA4 Data API: relatório de campanhas, dimensões e cotas de tokens
Corpo do runReport, dimensões de origem e campanha, cotas de tokens e como evitar o erro de limite.
Resposta curta: a GA4 Data API (runReport) retorna sessões, conversões e receita por dimensões como sessionSourceMedium e sessionCampaignName. Ela tem cotas por propriedade, medidas em tokens; consultas pesadas e muitas dimensões consomem mais.
Corpo da requisição
{
"dateRanges": [{ "startDate": "30daysAgo", "endDate": "today" }],
"dimensions": [
{ "name": "sessionSourceMedium" },
{ "name": "sessionCampaignName" }
],
"metrics": [
{ "name": "sessions" },
{ "name": "conversions" },
{ "name": "totalRevenue" }
],
"limit": 10000,
"returnPropertyQuota": true
}Cotas e limites
| Item | Propriedade padrão |
|---|---|
| Tokens por dia | 200.000 |
| Tokens por hora | 40.000 |
| Requisições simultâneas | 10 |
| Linhas por resposta | até 250.000 (use paginação) |
| Dimensões por consulta | até 9 |
As propriedades GA4 360 têm cotas bem maiores. Confira os valores atuais na documentação oficial.
Como economizar tokens
- Janelas curtas: consulte 7 ou 30 dias, não anos.
- Menos dimensões de alta cardinalidade: combinar origem, campanha e página de destino explode o número de linhas.
- Evite filtros por expressão regular quando um filtro simples bastar.
- Monitore a cota: use
returnPropertyQuotae reduza o ritmo antes de receber erro de limite. - BigQuery: para painéis muito frequentes, exportar o GA4 para o BigQuery costuma ser mais adequado.
Cuidados de atribuição
O que o GA4 atribui à campanha depende de UTM e do modelo de atribuição. Os números de conversão podem diferir dos da plataforma de anúncio; explique ao cliente de qual fonte vem cada indicador.