Conector de origem
Conector X Ads
Integração do X Ads com bancos de dados, warehouses e ferramentas de BI
Fonte de performance de anúncios para analytics de campanhas no X. A Datrise captura entidades do Twitter/X Ads como métricas de campanhas, gasto, engajamento e performance de conversões, e entrega modelos normalizados e tipados para reporting em warehouse, atribuicao e fluxos de IA.
A X Ads API v12 (ads-api.x.com) autentica com OAuth 1.0a, as cargas incrementais usam updated_at, e o fornecedor limita a published per-window caps: 450 writes/minute, 10,000 core entity reads and 2,000 other account reads per 15 minutes at the ad-account level, 250 synchronous analytics requests and 5 global reads per 15 minutes at the user-token level, plus a limit of 100 concurrent asynchronous stats jobs per ad account.
Dos 4 objetos, 3 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 `twitter_x_ads_campaign_metrics`) com esquema derivado da API do X 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 X Ads e entre na lista de espera para receber o conector com onboarding guiado.
Quais dados do Twitter/X 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 metrics | twitter_x_ads_campaign_metrics | Append incremental por timestamp |
| spend | twitter_x_ads_spend | Upsert por chave primária, incremental por updated-at |
| engagement | twitter_x_ads_engagement | Upsert por chave primária, incremental por updated-at |
| ad conversion performance | twitter_x_ads_ad_conversion_performance | Upsert por chave primária, incremental por updated-at |
API do Twitter/X Ads: fatos de configuração do conector
Verificado na documentação do fornecedor em 2026-09-14. Valores desconhecidos ficam em branco, não são inventados.
| API | X Ads API v12 (ads-api.x.com) |
|---|---|
| Autenticação | OAuth 1.0a — The Ads API is OAuth 1.0a only: every HTTPS call to ads-api.x.com must carry an OAuth 1.0a signed Authorization header built from the app's consumer key/secret plus a user access token/secret for a user with advertising access, and the vendor documents no OAuth 2.0 or app-only bearer path for these endpoints. |
| Paginação | cursor — Collection GETs return an opaque `next_cursor` that you pass back as `cursor`, with `count` defaulting to 200 and capped at 1000, and `next_cursor` comes back null on the last page. |
| Limite de requisições | published per-window caps: 450 writes/minute, 10,000 core entity reads and 2,000 other account reads per 15 minutes at the ad-account level, 250 synchronous analytics requests and 5 global reads per 15 minutes at the user-token level, plus a limit of 100 concurrent asynchronous stats jobs per ad account |
| Cursor incremental | updated_at — Campaign-management entities carry `created_at` and `updated_at` and `sort_by` accepts `updated_at-desc` on campaigns, line items, promoted tweets and cards, but no updated-since query filter is documented, so incremental sync means paging newest-modified-first until you reach the last synced timestamp; analytics is windowed by `start_time`/`end_time` instead. |
| Webhooks | Não |
| Exportação em massa | Sim — Asynchronous analytics jobs (POST stats/jobs/accounts/:account_id, poll GET stats/jobs/accounts/:account_id, then download the generated data file from the returned URL) |
| Detecção de exclusões | Sim — GET accounts, campaigns, line_items and funding_instruments accept `with_deleted` (default false) to include deleted results, and every entity carries a `deleted` boolean, so removals surface as flagged records rather than ids that silently disappear. |
Destinos populares para Twitter/X 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 Twitter/X Ads
- Quais dados do X Ads o conector extrai?
- 4 objetos: campaign metrics, spend, engagement e ad conversion performance. Cada um vai para a própria tabela com tipos preservados; objetos com histórico (1: campaign metrics) são carregados como append-only.
- A integração do X 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 X Ads?
- Para 43 destinos: bancos relacionais, warehouses, data lakes, planilhas e ferramentas de BI. Cada par X 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 Twitter/X Ads com onboarding guiado
Entre na lista de espera para ter acesso prioritário às integrações de Twitter/X Ads com setup guiado, mapeamento orientado a schema e sync incremental de nível produção.