1. Verifique o código de erro retornado por Obter status do relatório e veja se consegue encontrar o motivo da falha usando o índice Códigos de erro.
2. Se o problema persistir, contacte a equipa de suporte da Singular. Recomendamos que guarde o ID do relatório, pois a equipa pode utilizá-lo para encontrar a chamada de API específica que devolveu o erro e verificar as razões técnicas pelas quais não pôde ser concluída.

Geralmente, os dados de ontem devem estar prontos para si às 8 horas da manhã no seu fuso horário local. Se não estiverem prontos, verifique o parâmetro "status" retornado pelo ponto de extremidade Disponibilidade de dados. Ele pode incluir mais informações sobre o problema (consulte a referência do Ponto de extremidade de disponibilidade de dados para obter mais informações). Se houver um problema de logon (o Singular não pôde fazer logon na fonte para extrair os dados), vá para a página Conectores de dados no aplicativo Singular e insira novamente suas credenciais.

No entanto, pode não haver um problema imediatamente identificável, como um erro de login. As extrações de dados podem ser atrasadas por vários motivos. Observe que a equipe do Singular é alertada sobre atrasos de dados automaticamente e começa a trabalhar imediatamente no problema. Enquanto isso, você pode:

• Consultar todas as suas outras redes e deixar as que sofreram atrasos para mais tarde
• Esperar pelo menos uma hora e verificar novamente
• Em casos urgentes, se tiver esperado e a fonte ainda não estiver preenchida, pode notificar o apoio Singular, mas tenha em mente que provavelmente já estão a trabalhar no problema.

Para entender por que você está recebendo valores N/A, confira Solução de problemas de "N/A" e dados ausentes em relatórios.

Às vezes, em vez de obter todas as métricas de uma campanha em uma única linha, você obterá as métricas da rede de anúncios (como Custo) em uma linha e as métricas do rastreador de atribuição (como Instalações) em uma segunda linha.

Para entender por que isso acontece, consulte Unir dados da rede e do rastreador (parte do nosso guia, Noções básicas sobre dados de relatórios únicos).

Recebe este erro quando a sua consulta inclui um filtro que não existe. Por exemplo, pode ter tentado filtrar por uma aplicação que não existe na página Aplicações, ou por um SO que não existe de todo. Examine o valor de filtro devolvido e corrija a consulta de forma adequada.

Para obter uma lista de todos os campos que pode filtrar e todos os valores válidos para cada campo, utilize o ponto de extremidade de filtros.

Se você incluiu dimensões personalizadas na sua consulta, use o ponto de extremidade Dimensões personalizadas para verificar se as dimensões ainda estão disponíveis. Este erro pode surgir se você ou a sua equipa tiverem feito alterações na página de configuração das dimensões personalizadas desde que a consulta foi escrita.

Além disso, para dimensões personalizadas, certifique-se de usar a ID da dimensão (em vez do "nome de exibição").

Saiba mais nas Perguntas frequentes sobre dimensões personalizadas.

Se você incluiu métricas ou eventos de coorte na sua consulta, use o ponto de extremidade Métricas de coorte para verificar se as métricas e os períodos usados estão disponíveis. Certifique-se de que utilizou o nome da métrica (em vez do "nome de apresentação").

Um motivo pelo qual seus dados podem mudar ao longo do tempo é que o Singular mostra os dados conforme são relatados por suas redes e rastreadores. Alguns desses parceiros podem informar dados estimados antes de terem os dados finais. Por exemplo, o Twitter afirma que "os relatórios do Twitter são finalizados dentro de 24 a 48 horas após a veiculação das impressões. Antes dessa altura, estimamos os dados para fornecer feedback em tempo real, mas os dados estão sujeitos a alterações"(fonte).

Isto resulta de uma solução alternativa para um problema técnico com algumas das redes de anúncios das quais extraímos dados.

Por vezes, as métricas da rede de publicidade para os criativos de uma campanha não correspondem exatamente à métrica da rede de publicidade para a campanha.

Por exemplo, aqui estão os dados obtidos ao nível do criativo que totalizam 50 cliques, enquanto os dados obtidos ao nível da campanha mostram 45 cliques para a mesma campanha:

Nestes casos, para alinhar os dados, a Singular adiciona uma linha criativa fictícia à base de dados e atribui-lhe o valor necessário para que as métricas das criativas somem a métrica de toda a campanha. Por vezes, este valor é negativo. O nome do criativo nesta linha fictícia é apresentado como "Dados criativos em falta".

Estas linhas fictícias são normalmente apresentadas apenas nos resultados da API (não nos relatórios que executa na plataforma Web Singular). Você pode ocultá-las adicionando o seguinte à sua consulta: display_alignment=False

leia mais em Perguntas frequentes e solução de problemas de Relatórios criativos

O Singular oferece algumas métricas que são calculadas com base em outras métricas na linha. Por exemplo, o CPI (custo por instalação) é o custo dividido pelo número de instalações. Recomendamos evitar o uso dessas métricas em relatórios de API porque em qualquer consulta agregada (onde as métricas são somadas com uma operação "+"), você obtém resultados sem sentido.

Por exemplo:

Verifique se a sua consulta inclui dimensões criativas, como creative_id, creative_name, asset_id, asset_name, etc. Algumas redes, como o Google Ads, fornecem dados de país por campanha, mas não por anúncio, por isso, se o relatório estiver dividido por anúncios, não é possível ver as informações do país.

Para obter mais informações sobre os recursos e as limitações do Google Ads, consulte Conector de dados do AdWords (Google Ads).

A API Singular e a interface de utilizador Singular (em app.singular.net) utilizam o mesmo código para extrair os dados da base de dados Singular, pelo que os resultados devem corresponder sempre. Se não corresponderem, isso provavelmente significa que você não executou exatamente a mesma consulta.

Compare suas configurações de consulta na interface de usuário do Singular com a consulta da API, prestando atenção às seguintes diferenças em particular:

• Consulta de diferentes conjuntos de datas
• Uso de métricas de discrepância em vez de métricas regulares
• Exibição de linhas fictícias em relatórios de criação (consulte Por que recebo "Dados de criação ausentes" na dimensão "Nome da criação"?)

Você também pode usar ferramentas de desenvolvedor para verificar a chamada da API get_new_data que é executada quando você usa a interface do usuário.

Só é possível executar 100 relatórios assíncronos ao mesmo tempo. Se já submeteu 100 relatórios, aguarde que um relatório termine antes de submeter outro.

Isto pode ocorrer por vários motivos. Aguarde alguns instantes e tente novamente a chamada à API. Se estiver a executar o mesmo código todos os dias para obter os seus relatórios, deve adicionar novas tentativas ao código em caso de erros 500.

Se o problema persistir, contacte o suporte da Singular.

Para a maioria das redes, o Singular atualiza os dados diariamente, portanto, executar seus relatórios todos os dias é uma boa prática. Não há razão para consultar os dados com mais frequência. Veja Executando Relatórios Diários para mais informações.