La API de Conversiones de Meta es un canal que envía los eventos de su negocio, como una compra, un registro o una venta cerrada, desde su servidor, su plataforma de sitio web o su CRM directamente a Meta, sin depender solo del navegador del cliente. Complementa al Pixel y no lo reemplaza. Para una pequeña empresa vale la pena cuando la venta ocurre fuera del sitio, en WhatsApp o en el CRM, o cuando el Pixel por sí solo pierde eventos. Para comprobar que funciona, use la herramienta Probar eventos y confirme que cada evento llega una sola vez.
Esta guía explica qué hace la API de Conversiones de Meta, cuándo conviene a una empresa pequeña, los cuidados que evitan eventos duplicados y la prueba de diez minutos para saber si la suya está funcionando. Todo lo que es regla técnica viene de la documentación oficial de Meta, que consultamos para este texto el 30 de octubre de 2026.
Qué es la API de Conversiones de Meta
Es una conexión entre los datos de marketing del anunciante y Meta, que se hace mediante el servidor, la plataforma del sitio web, la aplicación o el CRM. La documentación oficial indica que sirve para ayudar en la segmentación de los anuncios, en la reducción del costo por resultado y en la medición de resultados.
Los eventos que llegan por esta vía entran al mismo conjunto de datos que recibe los eventos del Pixel de Meta. Por eso se usan de forma similar para medición, reportes y optimización. Una sola integración puede enviar eventos de sitio web, aplicación, mensajes de negocio y ventas offline.
El Pixel es un código que se ejecuta en el navegador de quien visita el sitio. La API de Conversiones es su sistema avisándole a Meta. Lo que el navegador no vio, el servidor sí lo vio.
El interés de búsqueda es pequeño y muy específico. Según el Planificador de palabras clave de Google Ads, al 30 de octubre de 2026, “api de conversiones de meta” tiene cerca de 110 búsquedas al mes en Brasil, con una puja de primera posición estimada en R$32.08. Es la puja que Google estima para el primer lugar de la página, no lo que paga cada empresa. Quien busca esto normalmente ya tiene un problema real de medición, y no solo curiosidad.
Píxel y API de Conversiones: cómo se complementan
El Píxel registra lo que ocurre en el navegador, y la API registra lo que su sistema sabe. Usar los dos juntos, con el mismo evento llegando por ambas vías, es la configuración que Meta llama redundante, y depende de una regla de deduplicación, que se explica más adelante.
| Píxel de Meta | API de Conversiones | |
|---|---|---|
| Dónde se ejecuta | En el navegador del visitante | En el servidor, en la plataforma o en el CRM |
| Qué ve | Páginas vistas, clics, formulario enviado | Cualquier cosa que su sistema registre, incluso una venta cerrada después |
| Depende del navegador | Sí | No |
| Necesita código | Un snippet en el sitio web | Depende del método de integración |
| Riesgo principal | Evento perdido | Evento duplicado o mal identificado |
El punto de la última fila es el que más afecta. La API de Conversiones no rompe la medición por ser compleja. La rompe cuando se configura sin verificar la duplicidad.
Cuándo vale la pena para una pequeña empresa
Vale la pena cuando una parte importante de la venta ocurre donde el Pixel no la ve. Ese es nuestro criterio, no una regla de Meta, y funciona mejor que la pregunta “¿debo tenerla o no?”.
Señales de que conviene.
- La conversación de venta ocurre en WhatsApp o por teléfono, y el sitio web solo genera el primer contacto.
- Usted usa un CRM y sabe qué contactos se convirtieron en clientes, pero Meta no lo sabe.
- La cantidad de compras o registros en Meta es visiblemente menor que la de la tienda o la hoja de cálculo.
- Usted invierte lo suficiente en anuncios como para que cada evento perdido perjudique la optimización.
Todavía no es una prioridad si el Pixel ni siquiera está bien instalado o si el objetivo es solo alcance, sin una conversión que usted pueda registrar.
La documentación de Meta indica que, si ya tiene un Pixel, puede activar la API de Conversiones para eventos del sitio web desde el Administrador de eventos, con una opción de un clic, sin código ni costo de configuración. En muchas plataformas de sitios web, ese es el camino más corto para una empresa pequeña. Antes de contratar cualquier desarrollo, verifique si su plataforma ya ofrece esta opción.
Si la duda es si invertir primero en Meta o en Google, nuestra comparativa Google Ads o Meta Ads le ayuda a decidir dónde rinde más el dinero para su tipo de negocio.
Deduplicación de eventos: el cuidado que evita contar la venta dos veces
Si el mismo evento llega por el Pixel y por la API, Meta solo descarta el duplicado si ambos tienen el mismo identificador. Sin eso, una compra aparece como dos, el costo por resultado parece menor de lo que es y la optimización aprende mal.
La documentación oficial describe dos métodos. El recomendado usa el `event_id` y el nombre del evento.
- El `eventID` enviado por el Pixel debe ser igual al `event_id` enviado por la API.
- El nombre del evento en el Pixel debe ser igual al `event_name` de la API.
- Si la misma combinación llega de ambas fuentes para el mismo Pixel dentro de 48 horas, se descarta el evento que llegó después.
El segundo método usa el `event_name` más el `fbp` o el `external_id`, enviados de la misma forma por el navegador y por el servidor. Aquí solo se deduplica el evento del servidor que llega después de un evento del navegador, dentro de las mismas 48 horas. Dos eventos solo del navegador o solo del servidor, aunque sean idénticos, no se deduplican.
La documentación no aclara qué ocurre cuando falta el `event_id`, ni si Meta recurre al segundo método. Por eso la regla práctica es generar el `event_id` en el momento del evento, enviar el mismo valor por ambas vías y verificarlo en la prueba. El detalle completo está en la página oficial de deduplicación.
Qué datos enviar con el evento
El evento necesita al menos un dato del usuario en el formato correcto, y para eventos de sitio web el `client_user_agent` también es obligatorio. Cuantos más datos válidos envíe, mayor es la probabilidad de que Meta vincule el evento con una persona.
La documentación de parámetros de información del cliente resume el formato de cada uno.
| Parámetro | Qué es | Formato |
|---|---|---|
| `em` | Correo electrónico | Sin espacios en los extremos, en minúsculas, con hash SHA-256 |
| `ph` | Teléfono | Sin símbolos, letras ni ceros a la izquierda, con código de país, con hash SHA-256 |
| `fbc` | ID del clic | Viene de la cookie `_fbc`, sin hash |
| `fbp` | ID del navegador | Viene de la cookie `_fbp`, sin hash |
| `client_ip_address` | IP | Nunca sin hash |
| `client_user_agent` | Navegador del usuario | Sin hash |
Para los eventos enviados desde el servidor, la IP y el navegador deben informarse manualmente. En el navegador, el Pixel los agrega solo. Quien usa una plataforma con integración lista no necesita armar esto a mano, pero conviene saber qué se está enviando.
Los datos personales se envían con hash por seguridad, y su sitio debe explicar en la política de privacidad qué datos recopila. Antes de enviar datos de personas, confirme con su área legal qué cubren su política y el consentimiento del visitante. Para el lado de Google, la guía de consent mode v2 muestra cómo el consentimiento afecta la medición.
Cómo verificar si la API de Conversiones de Meta está funcionando
Abra el Administrador de Eventos, vaya a Fuentes de datos, elija el Pixel y use la pestaña Eventos de prueba, que genera un código de prueba para los eventos del servidor. La documentación oficial describe este camino. Es la forma de ver la API funcionando antes de depender de ella.
La prueba, en seis pasos.
- En el Administrador de Eventos, abra su Pixel y entre en Eventos de prueba.
- Copie el código de prueba que genera la herramienta.
- Envíe un evento de servidor con ese código en el parámetro `test_event_code`.
- Vea el evento aparecer en la ventana de pruebas.
- Realice la misma acción en el sitio web, para que el Pixel envíe el mismo evento, y confirme que ambos aparecen con el mismo `event_id`.
- Elimine el `test_event_code` del envío de producción.
Según la documentación, los eventos enviados con `test_event_code` no se descartan. Entran al Administrador de eventos y se usan para segmentación y medición. El código sirve solo para pruebas y no debe quedar en la configuración final.
Después de empezar a enviar, la documentación indica que es posible verificar los eventos en hasta 20 minutos. En Resumen, el Administrador muestra el conteo de eventos brutos, coincidentes y atribuidos, y la columna Método de conexión indica por qué canal llegó cada evento.
Si algún `event_time` tiene más de 7 días, la documentación informa que toda la solicitud devuelve error y no se procesa ningún evento. Envíe los eventos cerca del momento en que ocurren.
Qué cambia la API de Conversiones en su publicidad en Meta
No aumenta las ventas por sí sola. Mejora lo que Meta sabe sobre quién compró, y la campaña aprende con eso. Si la venta se cierra en WhatsApp, enviar esa venta de vuelta es lo que distingue a una campaña que optimiza para conversaciones de una que optimiza para clientes.
Para quienes trabajan con Google Ads, la lógica es la misma. Google también aprende mejor con la venta que con el clic, y el camino es parecido: registrar el origen del contacto y devolver el resultado. Explicamos esta parte en seguimiento de conversiones con GA4 y CRM y, para sitios que quieren más control sobre el envío, en server side tagging.
Cómo trabaja Ciclicko el seguimiento
En Ciclicko, la medición va antes del anuncio. Mapeamos dónde ocurre la venta, definimos qué evento representa dinero real, instalamos y probamos el seguimiento y verificamos que el número de la plataforma coincida con el del CRM o la tienda. Este trabajo se hace para Google Ads y para GA4, que es nuestra especialidad como agencia Google Partner.
La misma disciplina vale para Meta. Un evento sin identificador, sin prueba y sin verificación contra la caja genera un informe bonito y una decisión equivocada. No prometemos aumento de ventas, solo un número en el que usted pueda confiar.
Preguntas frecuentes
¿Qué es la API de Conversiones de Meta? Es una conexión que envía eventos desde su servidor, la plataforma del sitio, la aplicación o el CRM hacia Meta, para ayudar en la segmentación, la medición y la reducción del costo por resultado.
¿La API de Conversiones reemplaza al Pixel? No. Lo complementa. Usarlos juntos exige que el mismo evento tenga el mismo identificador en ambas vías, para que Meta descarte el duplicado.
¿Cómo configurar la API de Conversiones de Meta? Si ya tiene un Pixel, puede activarla para eventos del sitio desde el Administrador de eventos, con una opción de un clic. La otra vía es la integración directa, en la que su servidor envía las solicitudes a la API.
¿Cómo saber si la API de Conversiones está funcionando? Use la pestaña Eventos de prueba del Administrador de eventos, envíe un evento con el `test_event_code` y verifique que aparezca una sola vez, con Pixel y servidor deduplicados.
¿Cuánto tarda Meta en mostrar los eventos? Según la documentación oficial, se pueden verificar hasta 20 minutos después de empezar a enviarlos.
¿Necesito un desarrollador para usar la API de Conversiones? No siempre. Las plataformas de sitios con integración lista y la opción de un clic para quienes ya tienen Pixel resuelven muchos casos. La integración directa y el envío de ventas desde el CRM suelen requerir a alguien que programe.
¿Quiere medir la venta real, y no solo el clic?
Conozca nuestro trabajo de seguimiento de conversiones de Google Ads con CRM y solicite una evaluación de cómo se está midiendo hoy su venta.