Como criar 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 C standard requires);
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.