Consultar relatórios via API significa acessar dados de entrega, exibições ou proof-of-play de forma automatizada, sem depender exclusivamente da exportação manual no painel.
Esse tipo de integração é útil para empresas que precisam consolidar resultados, alimentar dashboards internos, prestar contas para anunciantes, acompanhar múltiplas unidades ou cruzar dados do AdLoop com outros sistemas.
A consulta via API deve ser usada com critério. Relatório automatizado só é útil quando os dados estão bem interpretados.
¶ Quando usar consulta de relatórios via API
Use esse tipo de integração quando você precisa:
- Gerar relatórios recorrentes.
- Consolidar campanhas de várias unidades.
- Acompanhar entrega em tempo quase real.
- Criar dashboard comercial ou operacional.
- Prestar contas para anunciantes.
- Integrar resultados ao CRM.
- Comparar campanhas próprias e campanhas pagas.
- Acompanhar proof-of-play por tela, campanha ou período.
- Criar alertas quando a entrega estiver abaixo do esperado.
Se você só precisa de um relatório pontual, a exportação manual pode ser suficiente.
A estrutura real depende dos recursos disponíveis no AdLoop, mas relatórios costumam envolver informações como:
- Campanha.
- Mídia.
- Dispositivo ou tela.
- Unidade.
- Período.
- Data e hora da exibição.
- Quantidade de exibições.
- Status da campanha.
- Progresso da entrega.
- Identificação do anunciante.
- Dados de proof-of-play.
- Possíveis falhas ou ausência de exibição.
Evite consultar dados sem saber como serão usados. Relatório demais, sem interpretação, vira ruído.
Antes de integrar, defina o tipo de relatório.
Relatório operacional responde:
- A campanha está rodando?
- Quais telas estão online?
- Houve falha?
- O Player exibiu a mídia?
- Algum dispositivo ficou sem registrar atividade?
Relatório comercial responde:
- O que foi entregue ao anunciante?
- Quantas exibições foram registradas?
- Em quais telas e períodos a campanha rodou?
- O que pode ser usado como comprovação?
- A entrega está compatível com o combinado?
Essa diferença evita enviar dados técnicos demais para o anunciante ou dados simplificados demais para a operação.
- Defina o objetivo do relatório.
- Escolha o recorte: campanha, tela, unidade, anunciante ou período.
- Defina a frequência de consulta.
- Valide quais dados estão disponíveis.
- Configure autenticação segura.
- Teste com uma campanha real controlada.
- Compare os dados da API com o painel.
- Documente a interpretação dos campos.
- Crie alertas ou dashboards apenas depois da validação.
- Revise periodicamente se os dados continuam fazendo sentido.
Relatórios dependem muito do período consultado.
Sempre valide:
- Data inicial.
- Data final.
- Fuso horário.
- Horário de funcionamento do estabelecimento.
- Campanhas pausadas ou encerradas.
- Dispositivos offline.
- Telas que ficaram desligadas.
- Conteúdos agendados fora do horário analisado.
Um erro comum é comparar períodos diferentes e concluir que a campanha teve baixo desempenho quando, na verdade, os filtros estavam errados.
- Consulte apenas os dados necessários.
- Evite chamadas excessivas à API.
- Use paginação ou filtros quando houver grande volume.
- Documente os campos do relatório.
- Separe dados operacionais de dados comerciais.
- Padronize nomes de campanhas e dispositivos.
- Armazene histórico quando precisar de análise longitudinal.
- Valide dados antes de enviar ao anunciante.
- Crie alertas para ausência de exibição.
- Mantenha logs de consulta e falha.
- Consultar relatório sem filtrar campanha.
- Misturar exibição comprovada com audiência estimada.
- Usar período errado.
- Desconsiderar telas offline.
- Tratar ausência de dado como falha sem investigar.
- Enviar relatório técnico demais para cliente final.
- Fazer consultas em frequência desnecessária.
- Não documentar o significado de cada campo.
- Não tratar erros de autenticação.
- Não validar fuso horário.
Ao conectar dados do AdLoop a um dashboard, prefira indicadores simples:
- Campanhas ativas.
- Exibições registradas.
- Exibições por tela.
- Exibições por unidade.
- Campanhas com baixa entrega.
- Dispositivos offline.
- Progresso da campanha.
- Entrega por anunciante.
- Comparativo entre previsto e realizado.
Evite dashboards poluídos. Quem opera tela precisa de decisão rápida, não de vaidade visual.
¶ Quando acionar suporte
Acione suporte quando:
- A API não retornar dados esperados.
- O painel e a API mostrarem números divergentes.
- Houver erro de autenticação.
- O período consultado parecer incorreto.
- Dados de uma campanha não aparecerem.
- O volume de dados estiver muito alto.
- O dashboard não atualizar.
- Os relatórios comerciais estiverem inconsistentes.
Envie campanha, período, endpoint ou fluxo usado, horário da consulta, resposta recebida e print do painel para comparação.
Pode ser possível, desde que os dados necessários estejam disponíveis e o relatório seja validado antes do envio automático.
Não necessariamente. Ele pode complementar, consolidar ou automatizar consultas, mas o painel continua sendo referência operacional para muitos usuários.
Depende da disponibilidade técnica e da frequência de atualização dos dados. Em muitos casos, consultas periódicas são mais estáveis do que tempo real absoluto.
Não. Exibição é o registro de que uma mídia foi exibida. Audiência é estimativa de pessoas potencialmente expostas. Não misture os conceitos em relatórios comerciais.
Antes de criar um dashboard ou relatório automático, defina uma tabela simples: campo, significado, origem, frequência de atualização e uso comercial. Sem isso, a API entrega dados, mas não entrega clareza.
Você chegou até aqui lendo a central de ajuda. Isso é um ótimo sinal.
Quando quiser ver a plataforma que está por trás de tudo isso, é só visitar o site.
Conhecer o AdLoop →