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

CampoTipoObligatorioDescripción
customerstringNoEl uuid de uno de tus clientes. Sin él, la respuesta incluye a todos los clientes.
customer_integrationstringNoEl 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.
statusstringNoFiltra por el último estado conocido: active o paused.
effective_statusstringNoFiltra por el último estado efectivo visto, como pending_review, disapproved o with_issues.
refreshbooleanNoRelee los objetos de la respuesta en la plataforma y actualiza Connect. Exige customer_integration.
include_deletedbooleanNoIncluye los objetos eliminados, con deleted_at.
per_pageintegerNoÍtems por página, de 1 a 100. El valor por defecto es 15.
customer_uuidstringNoEn 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.

Relacionadas

Ver todo lo que puedes hacer con Ads

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.