Ads
Listar pixels y eventos de conversión de Meta Ads con la API
Dos rutas muestran los pixels de la cuenta de anuncios del cliente y los eventos que cada pixel registró, con el conteo del período. El id del pixel va en el conjunto de anuncios optimizado para conversión, y lo lees todo por la conexión del cliente, sin implementar la API de Meta.
La llamada
GET /api/ads/facebook_ads/pixels/900000000000001/events?customer_integration=<connection uuid> Authorization: Bearer <merchant token> x-customer-token: <customer token>
Qué puedes hacer
- Listar los pixels de la cuenta con GET /ads/facebook_ads/pixels, con id, nombre, last_fired_at, created_at e is_unavailable.
- Ver los eventos que un pixel registró con GET /ads/facebook_ads/pixels/{id}/events, con event_name y count.
- Usar el id del pixel en adset.facebook_ads.promoted_object.pixel_id en un conjunto optimizado para conversión.
- Forzar una lectura nueva de la plataforma con refresh=true.
Reglas y límites
- El conteo de eventos cubre los últimos 90 días, la ventana que usa la integración para que los eventos raros no desaparezcan.
- No está paginada: vienen como máximo 200 ítems por lectura.
- Caché de 600 s por conexión. meta.cached y meta.cached_at muestran si vino del caché, y refresh=true lo ignora.
- Un id de pixel que no es de la cuenta de la conexión responde 404 ads_object_not_found.
- La conexión va siempre en ?customer_integration= y la llamada exige Authorization y x-customer-token.
Campos principales
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| customer_integration | string | Sí | El uuid de la conexión del cliente. Define la cuenta de anuncios. Va siempre en la query. |
| id | string | Sí | En /pixels/{id}/events: el id del pixel, obtenido de GET /ads/facebook_ads/pixels. |
| refresh | boolean | No | Ignora el caché de 600 s y consulta de nuevo la plataforma. |
| event_name | string | No | En la respuesta: el nombre del evento que el pixel registró. |
| count | integer | No | En la respuesta: cuántas veces ocurrió el evento en los últimos 90 días. |
| last_fired_at | string | No | En la lista de pixels: cuándo disparó el pixel por última vez. |
| is_unavailable | boolean | No | En la lista de pixels: indica si el pixel no está disponible. |
Para quién
Revisar el pixel antes de lanzar
Tu SaaS verifica que el pixel del cliente registró Purchase en los últimos 90 días antes de permitir optimizar por compra.
Diagnóstico de seguimiento en una agencia
Una agencia lista los pixels y la fecha del último disparo para encontrar los que dejaron de funcionar.
Agente de IA que elige el evento
Un agente lee los eventos del pixel, elige el de mayor volumen y configura el conjunto de anuncios con él.
Funciona con
Meta Ads
Preguntas frecuentes
¿Qué período cubre el conteo de eventos?
Los últimos 90 días, la ventana que usa la integración para que los eventos raros no desaparezcan.
¿Dónde uso el id del pixel?
En adset.facebook_ads.promoted_object.pixel_id, en un conjunto de anuncios optimizado para conversión.
¿Cómo sé si el pixel funciona?
GET /ads/facebook_ads/pixels trae last_fired_at e is_unavailable, y la ruta de eventos muestra qué eventos llegaron y cuántas veces.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
