Conector de origem
Conector Meta Ads
Integração do Meta Ads com bancos de dados, warehouses e ferramentas de BI
Fonte de anúncios do Facebook e Instagram para gasto e engajamento. A Datrise captura entidades do Meta Ads como gasto de campanhas, impressões, cliques, conversões e segmentos de audiência, e entrega modelos normalizados e tipados para reporting em warehouse, atribuicao e fluxos de IA.
A Meta Marketing API v26.0 (Ads Insights + Ads Management, on the Graph API) autentica com OAuth 2.0, as cargas incrementais usam updated_time, e o fornecedor limita a Business Use Case (BUC) formula, not a flat number: Ads Insights calls/hour = 600 + 400 x active ads (Standard access) or 190,000 + 400 x active ads (Advanced access); Ads Management calls/hour = 300 + 40 x active ads (Standard) or 100,000 + 40 x active ads (Advanced) - throttling begins when the `X-Business-Use-Case-Usage` header's `total_cputime` or `total_time` reaches 100%.
Dos 5 objetos, 3 sincronizam com upsert por chave primária e 2 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 `meta_ads_campaign_spend`) com esquema derivado da API do Meta 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 Meta Ads e entre na lista de espera para receber o conector com onboarding guiado.
Quais dados do Meta 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 |
|---|---|---|
| campaign spend | meta_ads_campaign_spend | Upsert por chave primária, incremental por updated-at |
| impressions | meta_ads_impressions | Append incremental por timestamp |
| clicks | meta_ads_clicks | Append incremental por timestamp |
| conversions | meta_ads_conversions | Upsert por chave primária, incremental por updated-at |
| audience segments | meta_ads_audience_segments | Upsert por chave primária, incremental por updated-at |
API do Meta 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 v26.0 (Ads Insights + Ads Management, on the Graph API) |
|---|---|
| Autenticação | OAuth 2.0 — Requests use a System User or user access token obtained via Meta's OAuth flow, scoped with `ads_read`/`ads_management` permissions and tied to a Business Manager asset. |
| Paginação | cursor — Graph API list responses page via `paging.cursors.before`/`after` opaque cursors rather than page numbers or offsets. |
| Limite de requisições | Business Use Case (BUC) formula, not a flat number: Ads Insights calls/hour = 600 + 400 x active ads (Standard access) or 190,000 + 400 x active ads (Advanced access); Ads Management calls/hour = 300 + 40 x active ads (Standard) or 100,000 + 40 x active ads (Advanced) - throttling begins when the `X-Business-Use-Case-Usage` header's `total_cputime` or `total_time` reaches 100%. |
| Cursor incremental | updated_time — Campaign/ad set/ad objects expose an `updated_time` field for entity-level incremental sync; Insights (performance metrics) has no comparable cursor and is instead pulled by `time_range`/date, with data continuing to adjust for up to 28 days after the fact. |
| Webhooks | Sim — Graph API Webhooks (object change subscriptions for Page/App-level objects; not offered at the ad-account level for insights or ad-entity status) |
| Exportação em massa | Sim — Asynchronous Ads Insights report jobs (`POST <object>/insights` -> poll `async_status`/`async_percent_completion` -> `GET <report_run_id>/insights`) |
| Detecção de exclusões | Sim — Deleted campaigns, ad sets, and ads are not removed from the API; they persist with `effective_status`/`configured_status` set to `DELETED`, so a connector must watch for that status flip rather than for the object's disappearance. |
Destinos populares para Meta Ads
Escolha um destino abaixo para abrir a pagina de pipeline pronta.
- AAirtable
Destino de planilha relacional para equipes de operações e go-to-market.
Ver pipeline - AAmazon Athena
SQL serverless sobre tabelas do data lake no S3.
Ver pipeline - AAmazon DynamoDB
Banco key-value e documental serverless na AWS.
Ver pipeline - AAmazon QuickSight
BI serverless na AWS com SPICE e analytics embutido.
Ver pipeline - AAmazon Redshift
Warehouse em escala petabyte na AWS com Spectrum.
Ver pipeline - AAmazon S3 Data Lake
Zona de landing em object storage para parquet e snapshots.
Ver pipeline - AApache Superset
BI open source para exploração SQL, gráficos e publicação de dashboards.
Ver pipeline - AArquivos CSV
Destino de arquivos planos para exports e compartilhamento leve.
Ver pipeline - AAzure Data Lake Storage
Armazenamento ADLS Gen2 para cargas analíticas.
Ver pipeline
Perguntas sobre o conector Meta Ads
- Quais dados do Meta Ads o conector extrai?
- 5 objetos: campaign spend, impressions, clicks, conversions e audience segments. Cada um vai para a própria tabela com tipos preservados; objetos com histórico (2: impressions e clicks) são carregados como append-only.
- A integração do Meta 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 Meta Ads?
- Para 43 destinos: bancos relacionais, warehouses, data lakes, planilhas e ferramentas de BI. Cada par Meta 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 Meta Ads com onboarding guiado
Entre na lista de espera para ter acesso prioritário às integrações de Meta Ads com setup guiado, mapeamento orientado a schema e sync incremental de nível produção.