Skip to main content

Funcionalidades

FuncionalidadeSuportadoNotas
Definir frequência da pipelineSimPara mais detalhes, acesse.
Sincronização Full loadSimConsulte as tabelas
Sincronização IncrementalSimConsulte as tabelas
Conexão via OAuthSim

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 campoDescriçãoExemplo
ID da contaIdentificar única da conta atrelado aos anúncios. Encontre seu ID aqui.1471426329522916
Autorizar e salvarAutorize 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 campoDescriçãoExemplo
Data de inícioDetermina 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 deletadosMarque 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".