Conector de origem

Conector Facebook Ads

Integração do Facebook Ads com bancos de dados, warehouses e ferramentas de BI

Campanhas pagas na Meta e métricas de performance. A Datrise captura entidades do Facebook Ads como campaigns, ad sets, ads, spend, and conversion metrics, e entrega modelos normalizados e tipados para reporting em warehouse, atribuicao e fluxos de IA.

A Meta Marketing API v22 (Ads Insights + Ad objects) autentica com OAuth 2.0, as cargas incrementais usam updated_time (campaign/adset/ad objects); date range (time_range/date_preset) for Insights, e o fornecedor limita a No fixed numeric cap; usage is load-scored per app/ad-account and reported via the `X-FB-Ads-Insights-Throttle` response header (`app_id_util_pct`, `acc_id_util_pct`), with HTTP calls rejected once utilization nears 100%.

Dos 5 objetos, 4 sincronizam com upsert por chave primária e 1 como fluxos append-only, então cada execução incremental move só o que mudou desde a última marca d'água. Cada objeto chega na própria tabela (por exemplo `facebook_ads_campaigns`) com esquema derivado da API do Facebook Ads, não de um CSV, em qualquer um dos 43 destinos suportados.

A Datrise está em acesso antecipado: escolha um destino abaixo para ver o pipeline do Facebook Ads e entre na lista de espera para receber o conector com onboarding guiado.

Sync incrementalMapeamento orientado a schema43 destinos disponíveis

Quais dados do Facebook Ads a Datrise extrai

Cada objeto chega na própria tabela tipada. O modo de sync deriva do objeto: objetos de histórico fazem append, o restante faz upsert.

Objeto	Tabela de destino	Modo de sync
campaigns	facebook_ads_campaigns	Upsert por chave primária, incremental por updated-at
ad sets	facebook_ads_ad_sets	Upsert por chave primária, incremental por updated-at
ads	facebook_ads_ads	Upsert por chave primária, incremental por updated-at
spend	facebook_ads_spend	Upsert por chave primária, incremental por updated-at
conversion metrics	facebook_ads_conversion_metrics	Append incremental por timestamp

API do Facebook Ads: fatos de configuração do conector

Verificado na documentação do fornecedor em 2026-09-02. Valores desconhecidos ficam em branco, não são inventados.

API	Meta Marketing API v22 (Ads Insights + Ad objects)
Autenticação	OAuth 2.0 — OAuth 2.0 user or System User access token with `ads_read`/`ads_management` permissions on the ad account.
Paginação	cursor — Graph API cursor pagination via the `paging.cursors.after`/`before` values and `limit`; follow `paging.next` until it is absent rather than counting rows.
Limite de requisições	No fixed numeric cap; usage is load-scored per app/ad-account and reported via the `X-FB-Ads-Insights-Throttle` response header (`app_id_util_pct`, `acc_id_util_pct`), with HTTP calls rejected once utilization nears 100%
Cursor incremental	updated_time (campaign/adset/ad objects); date range (time_range/date_preset) for Insights — Ads Insights has no per-row modification timestamp, so incremental pulls must re-request a trailing window (commonly 7-28 days) because conversions continue attributing back to earlier report dates.
Webhooks	Não
Exportação em massa	Não
Detecção de exclusões	Sim — Filter campaign/adset/ad objects with `effective_status IN ["DELETED","ARCHIVED"]`; deleted objects stay queryable by ID (and can still return Insights via `ad.effective_status` filtering) for at least the 28 days after their last delivery date.

Referência oficial da API

Compare isto com todas as outras APIs documentadas

Destinos populares para Facebook Ads

Escolha um destino abaixo para abrir a pagina de pipeline pronta.

A
Airtable
Destino de planilha relacional para equipes de operações e go-to-market.
Ver pipeline
A
Amazon Athena
SQL serverless sobre tabelas do data lake no S3.
Ver pipeline
A
Amazon DynamoDB
Banco key-value e documental serverless na AWS.
Ver pipeline
A
Amazon QuickSight
BI serverless na AWS com SPICE e analytics embutido.
Ver pipeline
A
Amazon Redshift
Warehouse em escala petabyte na AWS com Spectrum.
Ver pipeline
A
Amazon S3 Data Lake
Zona de landing em object storage para parquet e snapshots.
Ver pipeline
A
Apache Superset
BI open source para exploração SQL, gráficos e publicação de dashboards.
Ver pipeline
A
Arquivos CSV
Destino de arquivos planos para exports e compartilhamento leve.
Ver pipeline
A
Azure Data Lake Storage
Armazenamento ADLS Gen2 para cargas analíticas.
Ver pipeline

Perguntas sobre o conector Facebook Ads

Quais dados do Facebook Ads o conector extrai?: 5 objetos: campaigns, ad sets, ads, spend e conversion metrics. Cada um vai para a própria tabela com tipos preservados; objetos com histórico (1: conversion metrics) são carregados como append-only.
A integração do Facebook Ads é incremental?: Sim. Depois da carga inicial completa, cada execução lê só os registros alterados desde a última marca d'água (updated-at ou timestamp do evento) e aplica upsert ou append conforme o objeto.
Para onde posso carregar os dados do Facebook Ads?: Para 43 destinos: bancos relacionais, warehouses, data lakes, planilhas e ferramentas de BI. Cada par Facebook Ads → destino tem a própria página com o mapeamento de objetos para tabelas.

Outras fontes de Ads

Outras fontes da mesma categoria, cada uma com a própria página de conector.

Acesso antecipado

Lance seu pipeline de Facebook Ads com onboarding guiado

Entre na lista de espera para ter acesso prioritário às integrações de Facebook Ads com setup guiado, mapeamento orientado a schema e sync incremental de nível produção.