O que é um Data Source?
Uma Fonte de dados é definida pela Conexão de um workspace Uncover às Tabelas oferecidas por Provedor de dados específico. Vamos dissecar o significado dessas 3 entidades em seguida.
A página de Data Sources é a porta de entrada para o ambiente de gerenciamento e criação de conexões de dados. Ela contém todas Tabelas e Provedores conectados. Assim como intervalo de datas ingeridos e status de atualização.
Quem tem acesso às Data Sources?
A seção de Data Sources é um ambiente de gerenciamento de dados, que é essencial para que nossos Analistas e parceiros possam acompanhar e controlar a qualidade dos seus dados na Uncover. Por enquanto, apenas Analysts de um Workspace tem acesso a esse ambiente.
O que é um Provedor de dados?
Um Provedor de dados pode ser uma plataforma mídia, parceiro de dados, planilha, banco de dados, datalake ou qualquer outra entidade que armazena dados. Cada provedor de dados exige um tipo de configuração para que uma Conexão seja estabelecida.
A Uncover está trabalhando constantemente para lançar mais provedores de dados para enriquecer o mundo de mídia de nossos parceiros.
Criando uma Conexão
Uma Conexão é o resultado da configuração de um Provedor de dados. Essa configuração é variável de acordo com o provedor desejado. Como exemplo, para Google Ads os Customer IDs das contas desejadas são necessários para se conectar. Para Google Sheets, é o URL da planilha que será conectada.
A criação de uma Conexão é o primeiro processo da jornada de criação de um Data Source. De forma genérica a jornada consiste em:
Checar na nossa documentação se o Provedor exige algum pré requisito (procure por uma seção Antes de se conectar no artigo).
Na página de Data Sources, clicar em +New Connection.
Selecionar Provedor desejado
Preencher os campos de configuração necessários para se conectar.
Acesse nossa documentação específica de cada Provedor para entender o significado de cada campo de configuração e entender seus pré requisitos de conexão.
Autenticação
Para extrair os dados de um Provedor, a Uncover precisa ter uma conexão autenticada na conta desejada. Em alguns Provedores, isso significa apenas fornecer chaves de acesso (que funcionam como senhas). Em outros Provedores, a conta de interesse precisa estar vinculada a uma conta de propriedade da Uncover. Há ainda uma terceira via disponível para alguns provedores, onde um usuário que tenha acesso aos dados de interesse faz "Sign In" e permite que a Uncover leia esses dados através de sua conta. Em todo caso, a documentação do Provedor e a plataforma Uncover vão esclarecer qual método será utilizado, e seus requisitos.
Para os provedores que exigem "Sign In", é possível "re-autenticar" pelo menu "..." da conexão. Isso é necessário em casos que a autenticação expira resultando em erros de sincronização por esse motivo, e pode também ser útil para mudar o usuário que garante acesso aos dados, no caso da pessoa que havia previamente concedido acesso não ter mais essa permissão.
Adicionando Tabelas de um Provedor
A Tabela é a "filha" de uma Provedor de dados conectado. Ela possui colunas com formatos específicos e um SLA. Toda tabela possui um coluna de data, que é essencial para que o dado seja armazenado corretamente e serve de base para a definição do SLA.
Uma Tabela pode ser previamente conhecida ou totalmente customizada. Essa definição depende do tipo de Provedor de dados. Para provedores com APIs conhecidas como Google Ads e Facebook Marketing, as suas tabelas são pré determinadas pela Uncover. Para provedores genéricos como Google Sheets e BigQuery, as tabelas são criadas pelos usuários através de abas na planilha e datasets, respectivamente.
Assim como os Provedores possuem configurações específicas, cada Tabela exige dados de configuração. Após o sucesso da conexão com um Provedor dados, basta seguir os passos
Na página de Data Sources, clique em Add Tables, para uma Conexão feita. Ou, após finalizar o setup de um provedor, na página de confirmação, clique em Add Tables to this Provider
Selecione Tables desejadas.
Preencha os campos de configuração necessários de cada Table para se conectar.
Como dito anteriormente, as principais configurações de uma Tabela são relacionadas a definição da sua coluna de data. No caso mais genérico as configurações são:
Date column name: é a coluna de data que será usada como referência para armazenar os dados no banco de dados da Uncover;
Date column format: é o formato da data na coluna de data selecionada. Alguns formatos pre-selecionados são exibidos, mas é possível que isso seja totalmente customizado seguindo as diretrizes da standard 1989 C date codes (referência disponível em https://docs.python.org/3/library/datetime.html#:~:text=1989%20C%20standard%20requires);
Timezone da data contida nesta coluna,
Columns: configuração do tipo de dado de cada coluna da tabela sendo integrada. As possibilidades são "number" (valores numéricos) e "string" (valores textuais). Essa configuração é importante para garantir uma validação dos dados sendo integrados na nossa plataforma. Sempre que sua tabela for sincronizada, será garantido que não há linhas com valores em formatos inadequados.
Acesse a documentação de cada Provedor para mais detalhes sobre as configurações de suas Tabelas.
Definindo o SLA de uma tabela
Para cada tabela conectada, um Service Level Agreement pode ser cadastrado. Ele define qual o nível de atualização esperado para essa tabela em dias referentes ao dia de hoje. Esse SLA ajuda a garantir a atualização dos dados Uncover.
Para definir o SLA de uma tabela:
Acesse a página Data Sources no app.
Clique na seta diagonal ↗ ao lado direito da Tabela desejada para acessar a sua página.
Na página desta Tabela, preencha o campo SLA com o número de dias referente ao dia de hoje em que se espera que o dado esteja atualizado.
Exemplo: 20 implica que o dado precisa estar sempre atualizado até 20 dias atrás (D-20).