A API Campaign Manager 360 v3.5 foi descontinuada e vai ser desativada em 20 de fevereiro de 2023. Até essa data, todos os usuários precisam migrar para uma versão mais recente.

Práticas recomendadas para a geração de relatórios

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página lista algumas práticas recomendadas na geração de relatórios.

Salvar e reutilizar relatórios

É recomendável criar e salvar relatórios para consultas que você faz regularmente, porque inserir e excluir o mesmo relatório várias vezes desperdiça recursos. Usar períodos relativos como YESTERDAY ou LAST_7_DAYS facilita a reutilização dos relatórios.

Programar relatórios

Pode ser um desperdício de recursos usar relatórios ad hoc (ou únicos), porque eles são gerados de forma individual e, possivelmente, com base em um conjunto de dados incompleto. Com os relatórios programados, é possível aproveitar mais os recursos disponíveis, porque eles são gerados em massa. Além disso, há a garantia de que eles só vão ser gerados após o processamento dos dados do dia anterior. Consulte os campos de programação disponíveis para detalhes.

Usar espera exponencial ao pesquisar o status de relatórios

Não é possível prever quanto tempo vai levar para gerar um relatório. Isso pode variar de segundos a horas, dependendo de muitos fatores, como o período e a quantidade de dados a serem processados. Também não há correlação entre o tempo de geração do relatório e o número de linhas retornadas. Por isso, você precisa conferir regularmente o status do relatório em geração para identificar quando o processo foi concluído. Esse processo é chamado de "sondagem".

Embora a sondagem seja necessária, uma implementação ineficiente talvez esgote sua cota rapidamente se uma geração de relatório demorar muito para ser concluída. Use a espera exponencial para limitar as tentativas e economizar sua cota.

Fazer download de várias partes

Os arquivos de relatório podem ter vários gigabytes. Fazer o download desses relatórios em uma única solicitação pode levar a problemas de conexão. Além disso, se um download de solicitação única for interrompido, ele não vai poder ser retomado. Também não vai ser possível retomar esse tipo de download com falha. Evite esse problema usando downloads de várias partes para dividir downloads grandes em porções menores. Se apenas uma das partes falhar, o download vai ser retomado desse ponto.

Essa divisão tem muitos benefícios, mas cada parte gera uma solicitação individual. Use um tamanho mínimo de 10 MB para evitar o desperdício de cota. No entanto, se o tamanho médio do relatório for muito grande, aumente as partes de acordo com a velocidade da conexão.

Usar as cotas de relatórios

As três cotas abaixo servem para garantir o uso responsável dos relatórios do Campaign Manager 360 em todos os produtos:

  1. Execuções de relatórios ad hoc (por dia)

    Limita o número de relatórios ad hoc que uma conta/perfil de usuário do CM pode gerar no período de 24 horas. Para ficar abaixo da cota, faça o seguinte:

    • Reduza a quantidade de relatórios duplicados.
    • Programe relatórios gerados regularmente.
    • Desative scripts de API desnecessários.
  2. Relatórios programados ativos

    Limita o número de relatórios que uma conta/perfil de usuário do CM pode ter ativamente programados em um certo período. Para ficar abaixo da cota, faça o seguinte:

    • Reduza a quantidade de relatórios duplicados.
    • Desative relatórios programados desnecessários.
    • Desative scripts de API desnecessários.
  3. Relatórios simultâneos

    Limita o número de relatórios que uma conta/perfil de usuário do CM pode gerar ao mesmo tempo. Para ficar abaixo da cota, faça o seguinte:

    • Programe relatórios gerados regularmente.
    • Desative scripts de API desnecessários.
    • Implemente a lógica de espera.

Se você tiver otimizado a implementação de relatórios e ainda exceder a cota, fale com o suporte do Campaign Manager 360 pelo formulário de contato.