Skip to main content

Campaign Manager 360 API ganha endpoint de relatórios em tempo real

O Google adicionou o endpoint reportData.query à API do Campaign Manager 360, permitindo que desenvolvedores consultem dados de performance de campanhas publicitárias em tempo real com uma única requisição. O novo recurso, noticiado pelo Search Engine Land, foi desenhado para relatórios em tempo real, dashboards e análises ad-hoc, dispensando a geração de relatórios baixáveis.

O Campaign Manager 360 é a plataforma do Google para gerenciamento de campanhas de display e mensuração de mídia. Com o novo endpoint, equipes técnicas que mantêm ferramentas próprias de análise ganham um caminho mais direto para os dados de campanha.

Como funciona o novo endpoint reportData.query

O endpoint reportData.query permite consultar dados de performance de campanha de forma síncrona, com resposta em JSON estruturado diretamente no corpo da chamada. Diferente do fluxo tradicional, o desenvolvedor não precisa criar um recurso Report antes de obter os dados. Em vez disso, as dimensões, métricas e filtros são definidos diretamente no corpo da requisição.

Consultas podem rodar por até 60 segundos. Esse limite torna o endpoint mais adequado para relatórios interativos e aplicações em tempo real do que para processamento pesado em lote.

O que muda para quem usa a API de relatórios

No fluxo existente da API de relatórios do Campaign Manager 360, o desenvolvedor precisa criar configurações de relatório, executar o relatório, aguardar a conclusão e baixar os arquivos gerados, geralmente em CSV ou Excel. Com o reportData.query, essa etapa de configuração e gestão de arquivos é eliminada, reduzindo a complexidade de implementação e acelerando o acesso aos dados.

O Google ressalta que o serviço Reports tradicional continua existindo e segue sendo a opção preferida para grandes conjuntos de dados, relatórios agendados e aplicações que dependem de arquivos CSV ou Excel para download. As duas opções seguem disponíveis: o endpoint novo atende consultas sob demanda, enquanto o fluxo clássico permanece para necessidades de processamento programado.

Para profissionais de marketing e agências que usam o Campaign Manager 360, o benefício prático é a possibilidade de alimentar dashboards e ferramentas de analytics com dados atualizados sem depender de processos agendados. A eliminação da configuração de relatórios reduz o trabalho de integração e abre espaço para análises ad-hoc mais frequentes.

O Google publicou os detalhes técnicos do novo endpoint no blog oficial de desenvolvedores de anúncios, onde equipes podem consultar a documentação e começar a testar a integração nos próprios painéis.

Estratégias de marketing baseadas em dados, toda semana

Cases reais, frameworks aplicáveis e análises do mercado brasileiro.