Funcionalidades

Funcionalidade	Suportado	Notas
Definir frequência da pipeline	Sim	Para mais detalhes, acesse.
Sincronização Full load	Sim	Consulte as tabelas
Sincronização Incremental	Sim	Consulte as tabelas
Conexão via OAuth	Sim

Guia rápido

Para iniciar a criação de uma Pipeline, basta ir no módulo Coletar, "Pipelines" aperte em "Nova Pipeline".

Escolha a fonte de dados

Utilize uma fonte já cadastrada ou cadastre uma nova

Parâmetros para conexão (cadastro da fonte)

Nome do campo	Descrição	Exemplo
ID da conta	Identificar única da conta atrelado aos anúncios. Encontre seu ID aqui.	1471426329522916
Autorizar e salvar	Autorize que o aplicativo Dadosfera acesse e colete os dados da sua conta.

Para mais detalhes a respeito dos acessos necessários para realizar conexão, acesse.

Informações da pipeline

Atribua o nome e uma breve descrição para sua Pipeline.

Parâmetros para configurações da pipeline

📘
Limite de volume
O Facebook Ads possui uma limitação de rate limit, verifique aqui se sua coleta estará dentro do limite.

Nome do campo	Descrição	Exemplo
Data de início	Determina quantos dados históricos serão extraídos.	dd/mm/aaaa
Data final (opcional)	Determina quantos dados históricos serão extraídos.	dd/mm/aaaa
Incluir objetos deletados	Marque esta opção caso possua tabelas deletadas que deseja coletar

Clique em "Salvar e Continuar".

Especificar os objetos

Sincronização disponível para cada objeto:

campaigns
- Replication strategy: INCREMENTAL | FULL_TABLE
adsets
- Replication strategy: INCREMENTAL | FULL_TABLE
ads_insights_region
- Replication strategy: INCREMENTAL | FULL_TABLE
ads_insights_platform_and_device
- Replication strategy: INCREMENTAL | FULL_TABLE
ads_insights_hourly_advertiser
- Replication strategy: INCREMENTAL | FULL_TABLE
ads_insights_dma
- Replication strategy: INCREMENTAL | FULL_TABLE
ads_insights_country
- Replication strategy: INCREMENTAL | FULL_TABLE
ads_insights_age_and_gender
- Replication strategy: INCREMENTAL | FULL_TABLE
ads_insights
- Replication strategy: INCREMENTAL | FULL_TABLE
ads
- Replication strategy: INCREMENTAL | FULL_TABLE
adcreative
- Replication strategy: FULL_TABLE

Após inserir as credenciais você estará apto a visualizar e selecionar quais entidades da fonte conectada serão importados na coleta de dados e as colunas que serão importadas.

Além disso, pode definir o modo de sincronização por objeto. Para saber mais, acesse.

📘
Ao selecionar mais de uma entidade, para cada tabela ou view importada será criado um dataset diferente no catálogo.

Frequência

Por último, configure a frequência desejada para que sua pipeline rode. É possível escolher dentre as opções apresentadas ou inserir uma frequência customizada através de uma expressão cron. Para saber mais, acesse.

📘

O fuso horário padrão utilizado na frequência é o UTC.

Todos os métodos de frequência definem quando as extrações serão iniciadas. Eles não controlam por quanto tempo o trabalho de replicação será executado ou quando os dados estarão efetivamente no destino.

Pronto! Agora basta aguardar a coleta ser feita no horário e dia agendado.

Caso queira executar a pipeline imediatamente, é possível executá-la manualmente em até 30 segundos após a criação da pipeline. Vá em "Pipelines", "Lista" e "Sincronizar Pipeline".

Após alguns minutos, sua pipeline estará catalogada na aba de exploração como um Data Asset.

É possível também consultar na lista de pipelines os detalhes da pipeline, como: resumo, lista de entidades e colunas coletadas, histórico de execução e de micro-transformação, em "Ver pipeline".