Perguntas frequentes e solução de problemas sobre conectores de dados

Conectores de dados são integrações que extraem seus dados de campanha de uma rede de anúncios ou outra fonte de mídia para a Singular. Existem conectores de dados que extraem dados de relatórios de campanha, bem como conectores para extrair dados de monetização de anúncios.

Para analisar os dados da sua campanha na Singular, primeiro você precisa adicionar um conector de dados para cada uma de suas redes parceiras na página Data Connectors (Conectores de Dados) (Settings > Data Connectors (Configurações > Conectores de Dados)). Se este artigo

 

Solução de problemas

Por que não consigo encontrar o conector de dados que estou procurando na lista?

1. Verifique se é um conector menos ativo

Por padrão, a página Data Connectors (Conectores de Dados) mostra apenas os conectores de dados dos quais os dados foram extraídos nos últimos 30 dias.

Para mostrar a lista completa de conectores, alterne para Show connectors without data in the last 30 days (Mostrar conectores sem dados nos últimos 30 dias):

screenshot-app.singular.net-2019.08.11-14-02-53.png

2. Verifique se está disponível para o seu tipo de conta

Os conectores de dados baseados em arquivo (com base em arquivos de relatório enviados por e-mail à Singular pelo parceiro de rede ou compartilhados por meio do S3 etc.) estão disponíveis apenas para clientes de nível empresarial. Incentive seus parceiros a ajudar a Singular a criar um conector de dados baseado em API.

Por que diz "O conector de dados já existe"?

Você não pode criar vários conectores para a mesma rede de anúncios com as mesmas credenciais.

Se você não encontrar o conector existente na lista, tente alternar Mostrar conectores sem dados nos últimos 30 dias:

screenshot-app.singular.net-2019.08.11-14-02-53.png

Por que eu tenho uma linha chamada "Singular Tracker"?

Quando você integrar o Singular SDK e começar a enviar eventos do SDK, um novo conector de dados chamado "Singular Tracker" será adicionado automaticamente. Isso é para que você possa acompanhar se seus dados de atribuição Singular foram extraídos com sucesso.

singular_dc.png

Por que não estou vendo os dados de ontem quando executo um relatório, mesmo que a “Última data da consulta” seja ontem?

Isso provavelmente ocorre porque não havia dados para ontem na rede de anúncios.

A “Última data consultada” significa que a Singular extraiu dados da rede para essa data sem encontrar um erro. No entanto, às vezes os dados extraídos da rede estão simplesmente vazios. Isso pode acontecer, por exemplo, se você não executou nenhuma campanha usando essa rede de anúncios.

O que significa quando um conector de dados mostra "os dados estão vazios no momento"?

Se você desativou Mostrar conectores sem dados nos últimos 30 dias, poderá ver a seguinte mensagem de erro:

DC_dataisempty.png

Isso significa que a Singular conseguiu consultar os dados com sucesso, mas a rede não tem dados de custo para relatar. Se a rede não relatar dados por 30 dias, seu conector de dados será filtrado pela alternância.

Perguntas frequentes

Geral

O que é um conector de dados?

Um conector de dados extrai dados de uma rede de anúncios ou outra fonte para a Singular.

Existem conectores de dados que extraem dados de relatórios de campanha, bem como conectores para extrair dados de monetização de anúncios.

Saiba mais sobre como gerar relatórios
Saiba mais sobre os relatórios de monetização de anúncios

Por que há várias linhas na tabela para a mesma rede de anunciantes?

Às vezes, isso ocorre porque você está extraindo dados de campanha e dados de monetização de anúncios da mesma rede, e isso requer dois conectores de dados separados.

Outra possibilidade é que sua organização tenha simplesmente adicionado vários conectores de dados para a mesma rede de anúncios, cada um com suas próprias credenciais de login.

screenshot-app.singular.net-2019.08.11-12-27-43.png

Por que alguns conectores têm "Monetização de anúncios no título?

Os conectores com "Monetização de anúncios" no nome são conectores especiais para dados de monetização de anúncios. O resto são conectores de relatórios de campanha.

Saiba mais sobre os relatórios de monetização de anúncios

Como a Singular extrai dados das redes de anúncios? Quais métodos ele pode usar?

A Singular usa métodos diferentes para extrair dados, dependendo da maneira como a rede de anúncios (ou outra fonte) disponibiliza seus dados. O conector de dados pode ser baseado na API da rede de anunciantes, relatórios transferidos como arquivos (por FTP, Google Drive, etc.), e-mails, acesso ao painel ou até mesmo uma combinação de dois ou mais desses métodos.

Observação: Os conectores de dados baseados em arquivo (que usam FTP, e-mail, Google Drive etc. para obter os dados da rede) só podem ser usados por clientes de nível empresarial. Incentive sua rede de parceiros a trabalhar com a Singular para criar um conector de dados baseado em API.

Saiba mais sobre relatórios por e-mail e relatórios do Google Docs

Adicionando um conector de dados

[Google AdWords] Como encontro minha ID de cliente da MCC?

Para localizar sua ID de cliente (para contas de administrador e contas individuais):

  1. Faça login na sua conta do Google Ads.
  2. Clique no ícone de ajuda no canto superior direito.
  3. Encontre a ID do cliente na parte inferior do menu.

Para obter mais informações sobre o conector de dados do Google AdWords, consultePerguntas frequentes sobre os conectores de dados do AdWords (Google Ads).

[Apple Search Ads] Como encontro minhas credenciais de autenticação de API?

screenshot-app.singular.net-2020.01.27-14-31-13.png

Para obter as credenciais de autenticação de API necessárias:

  1. Faça login na sua conta do Apple Search Ads.
  2. Vá para Settings (Configurações) > API e clique em Create API Certificate (Criar certificado API).
  3. Selecione o certificado que você acabou de criar e clique em Actions (Ações) > Download Certificate (Baixar certificado). Um arquivo ZIP é baixado para o seu computador contendo as duas credenciais necessárias. Abra os arquivos (se você não conseguir abri-los, altere a extensão do arquivo para .txt).
  4. Copie todo o conteúdo do arquivo .key para a "Autenticação da API: RSA Private key file" (incluindo "-----BEGIN PRIVATE KEY-----", "-----END PRIVATE KEY-----").
  5. Copie todo o conteúdo do arquivo .key para o campo "Autenticação da API: Certificate .pem file" (incluindo "-----BEGIN CERTIFICATE-----", "-----END CERTIFICATE-----").
[Vungle] Como encontro minha chave de API de relatórios?

Para obter sua chave de API de relatórios do Vungle, consulteInstruções de Vungle.

Instruções adicionais: A integração especial da Singular com o Vungle depende de relatórios do S3 e precisa ser configurada para você pelo Vungle. Para concluir a configuração do conector de dados Vungle, envie uma mensagem para singular@vungle.com incluindo o e-mail da sua conta Vungle e as datas de início da sua campanha (se as campanhas já tiverem sido lançadas). Com cópia para seus representantes Vungle e Singular. Pode levar até 72 horas para configurar sua integração no lado do Vungle.

Depois de adicionar um conector de dados, quando ele começa a extrair dados?

Depois de adicionar um conector de dados, a Singular começa a extrair os dados imediatamente. Você verá que o status do conector na página é ● Pendente. Volte mais tarde para ver quando a extração é feita.

As próximas extrações de dados serão realizadas diariamente à meia-noite do seu horário local. Você pode examinar a coluna Next Update (Próxima atualização) para ver quando a próxima extração está agendada.

Status e mensagens do conector

Quais são os diferentes status do conector?
Status Definição
● Active (Ativo) A Singular tem dados de ontem deste conector e não temos conhecimento de nenhum problema de login.
● Inactive (Inativo) Há um problema de login ou atraso de dados (os dados de ontem devem estar disponíveis no horário diário esperado, que por padrão é 8h, horário local).
● Pending (Pendente) Você adicionou recentemente este conector e a Singular está extraindo dados dele pela primeira vez.
● No Integration (Sem integração) A Singular não tem integração com essa rede de anúncios para obter relatórios de campanha ou dados de monetização de anúncios.
Por que um conector está ativo (status verde), mas ainda marcado com um ícone “Action Required” (Ação necessária)?

O status verde indica que a Singular conseguiu extrair dados de ontem, mas às vezes ainda há um problema que você precisa corrigir. Verifique a mensagem para ver o que você precisa fazer.

screenshot-app.singular.net-2019.08.11-12-33-09.png

Por que recebo a mensagem “Uma ou mais de suas contas não foram encontradas na rede. Clique em Editar e desmarque a(s) conta(s)”?

Isto geralmente acontece quando você removeu uma conta de uma rede independente (SAN), como o Facebook, mas não a removeu de sua lista de contas Singular. Você pode resolver facilmente este problema editando o conector de dados como indicado na mensagem.

Por que recebo a mensagem "Nenhum e-mail recebido"?

Este conector de dados foi configurado para receber relatórios por e-mail, mas a Singular não recebeu um relatório por e-mail. Entre em contato com a rede de anúncios para notificá-los.

Saiba mais sobre relatórios por e-mail e relatórios do Google Docs

O que devo fazer em caso de problemas de login?

Passe o mouse sobre o conector e selecione o ícone Edit (Editar). Insira novamente suas credenciais para ter certeza de que estão corretas. Se você estiver habilitando a conexão através de uma rede, como o Facebook, certifique-se de estar conectado como o usuário correto da rede (não um usuário pessoal, por exemplo).

Datas de dados

Qual é a "Data mais recente consultada"?

Este é o último dia para o qual a Singular retirou dados com sucesso deste conector de dados. Se tudo estiver funcionando corretamente, a data deve ser hoje/ontem.

Screen_Shot_2019-08-11_at_12.35.56.png

Qual é a data da "Última Atualização"?

Esta é a data e a hora em que a Singular acessou os dados deste conector de dados pela última vez. É onde você pode ver o quão frescos são os dados que você vê na Singular.

Alguns exemplos:

  Última data consultada Última atualização Próxima atualização
Se você estiver verificando o status do conector em 2 de janeiro, enquanto os dados estão sendo consultados, você verá: 31 de dez 1 de Jan 12:04 AM Em andamento
Se você estiver verificando o status do conector em 2 de janeiro depois que os dados foram consultados, você verá: 1 de Jan 2 de Jan 12:04 AM 3 de Jan 12:04 AM
Se você estiver verificando o status do conector logo após ter adicionado um conector de dados, você verá: - - Em andamento

Observação: A data da "Última Atualização" sempre se aplica ao frescor dos dados da "Data mais recente consultada", mas não se aplica necessariamente às datas anteriores.

Por exemplo, se a "Última Data Consultada" for ontem e a "Última Importação de Dados" for hoje às 00:04 da manhã, você sabe que os dados que você vê na Singular para ontem estão atualizados a partir das 00:04 da manhã -- mas os dados que você vê na Singular para 3 dias atrás podem ser menos frescos que isso.

Ferramentas do conector

O que o ícone "Run Test Report” (Executar relatório de teste.) faz?

screenshot--2019.08.11-12-38-32.png

Clique em Run Test Report (Executar relatório de teste) para executar automaticamente um relatório na página de consulta de relatório da Singular para o conector de dados selecionado. Isso permite que você verifique quais dados a Singular está extraindo desse conector de dados.

Os parâmetros para o relatório de teste são:

  • O relatório cobre apenas ontem.
  • As dimensões e métricas são todos dados da rede de anúncios (em vez de dados do rastreador de atribuição).
O que é o CSV de dados brutos?

O CSV de dados brutos é uma cópia da última importação de dados da Singular extraída desse conector de dados para a data que você vê no campo "Última data de consulta". Normalmente, isso significa os dados de ontem.

Você pode baixar o CSV de dados brutos passando o mouse sobre um conector de dados e clicando no ícone Raw Data CSV (CSV de dados brutos).

screenshot--2019.08.11-12-38-32_1_.png

Os dados neste arquivo em formato CSV são "brutos", pois não foram submetidos a conversões de moeda ou a nenhuma outra etapa de processamento de dados da Singular. No entanto, os nomes de dimensão são mapeados para nomes de dimensão Singular.

Você pode usar o CSV de dados brutos para solucionar alguns problemas com seus dados. Por exemplo, se você vir dados ausentes ou inesperados em seus relatórios Singular para uma determinada rede de anunciantes, o CSV de dados brutos poderá mostrar se o problema já existia quando os dados foram extraídos da rede de anunciantes.