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

CampoTipoObligatorioDescripción
customer_integrationstringSíEl uuid de la conexión del cliente. Define la cuenta de anuncios. Va siempre en la query.
idstringSíEn /pixels/{id}/events: el id del pixel, obtenido de GET /ads/facebook_ads/pixels.
refreshbooleanNoIgnora el caché de 600 s y consulta de nuevo la plataforma.
event_namestringNoEn la respuesta: el nombre del evento que el pixel registró.
countintegerNoEn la respuesta: cuántas veces ocurrió el evento en los últimos 90 días.
last_fired_atstringNoEn la lista de pixels: cuándo disparó el pixel por última vez.
is_unavailablebooleanNoEn 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.

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.