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
Consulte também:
Solução de problemas
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):
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.
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:
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.
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.
Se você desativou Mostrar conectores sem dados nos últimos 30 dias, poderá ver a seguinte mensagem de erro:
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
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
À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.
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.
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
Para localizar sua ID de cliente (para contas de administrador e contas individuais):
- Faça login na sua conta do Google Ads.
- Clique no ícone de ajuda no canto superior direito.
- 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).
Para obter as credenciais de autenticação de API necessárias:
- Faça login na sua conta do Apple Search Ads.
- Vá para Settings (Configurações) > API e clique em Create API Certificate (Criar certificado API).
- 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).
- 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-----").
- Copie todo o conteúdo do arquivo .key para o campo "Autenticação da API: Certificate .pem file" (incluindo "-----BEGIN CERTIFICATE-----", "-----END CERTIFICATE-----").
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, 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
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. |
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.
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.
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
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
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.
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
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 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).
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.