Ads
Ver los anuncios de todos tus clientes de Meta Ads con la API
Tres rutas bajo /merchants/ads dan el panorama de campañas, conjuntos y anuncios de todos tus clientes, solo con el token del merchant y sin x-customer-token. Monitoreas toda la base en una llamada, sin recorrer cliente por cliente y sin implementar la API de Meta.
La llamada
GET /api/merchants/ads/campaigns?customer=<customer uuid>&effective_status=disapproved&per_page=50 Authorization: Bearer <merchant token>
Qué puedes hacer
- Listar campañas, conjuntos y anuncios de todos los clientes con GET /merchants/ads/campaigns, /merchants/ads/adsets y /merchants/ads.
- Limitar a un cliente con customer o a una cuenta con customer_integration.
- Filtrar por status y por effective_status, como disapproved, with_issues o pending_review.
- Identificar al dueño de cada objeto con customer_uuid y customer_integration_uuid.
- Incluir los eliminados con include_deleted=true y paginar con page y per_page.
Reglas y límites
- Estas rutas usan solo Authorization: Bearer. No llevan x-customer-token, y customer y customer_integration son filtros, nunca credencial.
- Muestran lo que Connect guarda: lo que creó o ya escribió en las cuentas. Una cuenta con campañas antiguas solo aparece tras la primera escritura por Connect.
- Los datos son el último estado conocido, con synced_at. refresh=true relee los objetos de la respuesta, pero exige customer_integration.
- El customer y la conexión informados deben ser del merchant del token. Con ambos, la conexión debe ser de ese cliente.
- per_page va de 1 a 100 (por defecto 15) y la respuesta es {data, links, meta}.
Campos principales
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| customer | string | No | El uuid de uno de tus clientes. Sin él, la respuesta incluye a todos los clientes. |
| customer_integration | string | No | El uuid de una conexión de uno de tus clientes, para limitar a una sola cuenta. Con customer, la conexión debe ser de ese cliente. |
| status | string | No | Filtra por el último estado conocido: active o paused. |
| effective_status | string | No | Filtra por el último estado efectivo visto, como pending_review, disapproved o with_issues. |
| refresh | boolean | No | Relee los objetos de la respuesta en la plataforma y actualiza Connect. Exige customer_integration. |
| include_deleted | boolean | No | Incluye los objetos eliminados, con deleted_at. |
| per_page | integer | No | Ítems por página, de 1 a 100. El valor por defecto es 15. |
| customer_uuid | string | No | En la respuesta: el cliente dueño de la cuenta de cada objeto. |
Para quién
Monitorear anuncios rechazados en toda la base
Un SaaS de tráfico lista con effective_status=disapproved y avisa a cada cliente afectado, sin consultar cuenta por cuenta.
Vista del gestor en una agencia
Una agencia ve las campañas activas de todos los clientes en una sola pantalla, filtrando por cliente cuando necesita profundizar.
Agente de IA de soporte
Un agente recibe la consulta de un cliente, filtra por customer y responde qué está activo, pausado o con problemas.
Funciona con
Meta Ads
Preguntas frecuentes
¿Necesito x-customer-token en estas rutas?
No. Usan solo el Bearer del merchant. El cliente y la conexión entran como filtros (customer y customer_integration) y se verifican contra tu merchant.
¿En qué se diferencia de GET /ads/campaigns?
GET /ads/campaigns es de un cliente, con x-customer-token y conexión obligatoria. La ruta de /merchants/ads cubre a todos los clientes y muestra lo que Connect guarda.
¿Los datos están actualizados?
Son el último estado conocido, indicado en synced_at. Para actualizar, usa refresh=true junto con customer_integration.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
