Conector de origen
Conector de X Ads
Integración de X Ads con bases de datos, warehouses y herramientas de BI
Fuente de rendimiento de anuncios para analítica de campañas en X. Datrise captura entidades de Twitter/X Ads como métricas de campañas, gasto, engagement y rendimiento de conversiones, y luego entrega modelos normalizados y tipados para reporting en warehouse, atribución y flujos de IA.
La X Ads API v12 (ads-api.x.com) se autentica con OAuth 1.0a, las cargas incrementales usan updated_at, y el proveedor 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.
De los 4 objetos, 3 se sincronizan con upsert por clave primaria y 1 como flujos append-only, de modo que cada ejecución incremental solo mueve lo que cambió desde la última marca de agua. Cada objeto llega a su propia tabla (por ejemplo `twitter_x_ads_campaign_metrics`) con el esquema derivado de la API de X Ads, no de un CSV, en cualquiera de los 43 destinos soportados.
Datrise está en acceso anticipado: elige un destino abajo para ver el pipeline de X Ads y únete a la lista de espera para recibir el conector con onboarding guiado.
Qué datos de Twitter/X Ads extrae Datrise
Cada objeto llega a su propia tabla tipada. El modo de sync se deriva del objeto: los objetos de historial se anexan, el resto se actualiza con upsert.
| Objeto | Tabla de destino | Modo de sync |
|---|---|---|
| campaign metrics | twitter_x_ads_campaign_metrics | Append incremental por marca de tiempo |
| spend | twitter_x_ads_spend | Upsert por clave primaria, incremental por updated-at |
| engagement | twitter_x_ads_engagement | Upsert por clave primaria, incremental por updated-at |
| ad conversion performance | twitter_x_ads_ad_conversion_performance | Upsert por clave primaria, incremental por updated-at |
API de Twitter/X Ads: datos de configuración del conector
Verificado contra la documentación del proveedor el 2026-09-14. Los valores desconocidos se dejan en blanco, no se inventan.
| API | X Ads API v12 (ads-api.x.com) |
|---|---|
| Autenticación | 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. |
| Paginación | 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. |
| Límite de peticiones | 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 | No |
| Exportación masiva | Sí — 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) |
| Detección de borrados | Sí — 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
Elige un destino abajo para abrir la página de pipeline lista para usar.
- AAirtable
Destino de hoja relacional para equipos de operaciones y go-to-market.
Ver pipeline - AAmazon Athena
SQL serverless sobre tablas del data lake en S3.
Ver pipeline - AAmazon DynamoDB
Base key-value y documental serverless en AWS.
Ver pipeline - AAmazon QuickSight
BI serverless en AWS con SPICE y analítica embebida.
Ver pipeline - AAmazon Redshift
Almacén a escala petabyte en AWS con Spectrum.
Ver pipeline - AAmazon S3 Data Lake
Zona de aterrizaje en object storage para parquet y snapshots.
Ver pipeline - AApache Superset
BI open source para exploración SQL, gráficos y publicación de dashboards.
Ver pipeline - AArchivos CSV
Destino de archivos planos para exportaciones y compartición ligera.
Ver pipeline - AAzure Data Lake Storage
Almacenamiento ADLS Gen2 para cargas analíticas.
Ver pipeline
Preguntas sobre el conector de Twitter/X Ads
- ¿Qué datos de X Ads extrae el conector?
- 4 objetos: campaign metrics, spend, engagement y ad conversion performance. Cada uno se carga en su propia tabla con tipos preservados; los objetos con historial (1: campaign metrics) se cargan como append-only.
- ¿La integración de X Ads es incremental?
- Sí. Tras la carga inicial completa, cada ejecución lee solo los registros cambiados desde la última marca de agua (updated-at o timestamp del evento) y aplica upsert o append según el objeto.
- ¿A dónde puedo cargar los datos de X Ads?
- A 43 destinos: bases de datos relacionales, warehouses, data lakes, hojas de cálculo y herramientas de BI. Cada par X Ads → destino tiene su propia página con el mapeo de objetos a tablas.
Otras fuentes de Ads
Otras fuentes de la misma categoría, cada una con su propia página de conector.
Acceso anticipado
Lanza tu pipeline de Twitter/X Ads con onboarding guiado
Únete a la lista de espera para obtener acceso prioritario a integraciones de Twitter/X Ads con setup guiado, mapeo consciente del esquema y sincronización incremental de nivel producción.