Ads
Validar un anuncio de Meta Ads, Google Ads o TikTok Ads sin crearlo con la API
POST /ads/validate recibe exactamente el cuerpo de POST /ads y valida cada nivel sin crear nada en la cuenta del cliente. Descubres errores de campo, de página o de media antes de perder tiempo y antes de cualquier riesgo para el presupuesto. En TikTok Ads, que no tiene dry run, Connect verifica cada nivel en la cuenta solo con lecturas.
La llamada
POST /api/ads/validate?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"name": "Black Friday, imagem",
"status": "active",
"campaign": {
"name": "Black Friday",
"budget": {
"amount": 50,
"type": "daily"
},
"facebook_ads": {
"objective": "traffic",
"special_ad_categories": []
}
},
"adset": {
"name": "BR 25-45",
"schedule": {
"start": "2026-11-20T00:00:00-03:00"
},
"targeting": {
"countries": [
"BR"
],
"age_min": 25,
"age_max": 45
},
"facebook_ads": {
"optimization_goal": "link_clicks",
"billing_event": "impressions",
"placements": {
"publisher_platforms": [
"facebook",
"instagram"
]
},
"targeting": {
"interests": [
{
"id": "6003139266461",
"name": "Moda"
}
],
"advantage_audience": false
}
}
},
"ad": {
"format": "image",
"headline": "Black Friday",
"body": "Up to 50% off",
"link_url": "https://loja.com/bf",
"call_to_action": "shop_now",
"media": [
{
"type": "image",
"url": "https://cdn.loja.com/bf.jpg"
}
],
"facebook_ads": {
"page_id": "1068595869664481"
}
}
}Qué puedes hacer
- Validar el árbol completo (campaña, conjunto y anuncio) antes de crear.
- Validar un anuncio sobre una campaña y un conjunto existentes, pasando {"id": ...}.
- Recibir el resultado por nivel.
- Usar luego el mismo cuerpo en POST /ads, sin adaptar nada.
- Validar en Google Ads un anuncio Demand Gen o un grupo de recursos Performance Max, con el mismo cuerpo del POST /ads.
- Validar en TikTok Ads un anuncio de video: campaña y grupo citados, objetivo, presupuesto entre niveles, meta, países, identidad, video y portada.
Reglas y límites
- No crea nada en la cuenta del cliente y no registra operación.
- No necesita Idempotency-Key.
- Cada nivel lo valida la integración; los que dependen de un padre que aún no existe vuelven como skipped.
- Los errores de campo responden 422 validation_error con errors y, en enums, supported_values.
- Usa solo la conexión de customer_integration, en la query, y comprueba que pertenece al cliente.
- En Google Ads el resultado viene por nivel, como en Meta Ads. En Performance Max no hay nivel ad: el grupo de recursos es el conjunto.
- En TikTok Ads, cada nivel vuelve validated y la respuesta trae integration_dry_run: false. Lo que solo la creación revela, como un presupuesto por debajo del mínimo de TikTok, aparece en el POST /ads.
Campos principales
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre del anuncio, y de los niveles que no tengan uno. |
| status | string | No | Estado final previsto del árbol (active o paused). |
| campaign | object | No | {"id": ...} para una campaña existente; sin id, describe la que se crearía. |
| adset | object | Sí | {"id": ...} para un conjunto existente; sin id, describe el que se crearía. |
| ad.format | string | Sí | image o video. |
| ad.link_url | string | Sí | URL de destino del anuncio. |
| ad.media | array | Sí | Archivo(s) del creativo, por url, hash o id. Solo en Meta Ads. |
| ad.facebook_ads.page_id | string | Sí | Página que firma el anuncio. Debe ser de la cuenta de la conexión. Solo en Meta Ads. |
| integration_dry_run | No | En la respuesta, en TikTok Ads: false. TikTok no tiene dry run, y Connect verifica cada nivel solo con lecturas. |
Para quién
Formulario con feedback inmediato
Valida lo que el usuario completó antes de que pulse publicar y muestra los errores de cada nivel en pantalla.
Aprobación por lotes
Valida cientos de anuncios generados desde una plantilla y crea solo los que pasaron.
Agente de IA que se autocorrige
El agente arma el cuerpo, valida, lee los errores, los corrige y solo entonces llama a POST /ads.
Funciona con
Meta Ads
Google Ads
TikTok Ads
Preguntas frecuentes
¿Validar gasta presupuesto o crea objetos?
No. La ruta no crea nada en la cuenta y no registra operación.
¿El cuerpo es distinto al de POST /ads?
No, es el mismo. Puedes validar y, si pasa, enviarlo igual a POST /ads con un Idempotency-Key.
¿Qué significa skipped en el resultado?
Que ese nivel depende de un padre que aún no existe, así que no se puede validar por separado. En TikTok Ads no hay skipped: cada nivel se verifica en la cuenta y vuelve validated.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
