¿Qué es la API de conversiones de Meta (CAPI)? Guía clara para anunciantes
Si haces publicidad en Meta, seguro que alguien ya te dijo que "configures la CAPI". Normalmente justo después de que te quejaste de que el Administrador de anuncios muestra 12 compras y tu tienda registra 31.
El consejo es correcto. Pero casi todo lo que se ha escrito sobre la API de conversiones está pensado para desarrolladores o lo escribe alguien que quiere venderte algo sin explicártelo. Esta guía es para anunciantes y dueños de negocio que quieren entender qué hace antes de tocar nada.
La API de conversiones en un párrafo
La API de conversiones de Meta (Conversions API o CAPI) es una forma de enviar eventos de conversión —leads, registros, compras— a Meta desde tu servidor, tu CRM o tu backend, en lugar de hacerlo desde el navegador del visitante. El píxel de Meta observa lo que pasa en una página. La API de conversiones informa lo que pasa en tu negocio. Cuando funcionan juntos, Meta obtiene una imagen más completa y fiable de quién convirtió después de ver tus anuncios, y usa esa imagen para decidir a quién mostrárselos después.
Por qué el píxel solo ya no alcanza
El píxel es un fragmento de JavaScript. Solo funciona si se carga, se ejecuta y tiene permiso para enviar datos. Hoy muchas cosas se lo impiden:
- Bloqueadores de anuncios y navegadores privados bloquean directamente las solicitudes a los dominios de Facebook.
- Las restricciones de seguimiento de iOS y la vida más corta de las cookies en Safari rompen el vínculo entre el clic en el anuncio y una conversión que ocurre unos días después.
- Muchas veces la conversión ni siquiera ocurre en la web. Alguien deja sus datos en un formulario y tu vendedor cierra la venta por teléfono una semana después. El píxel nunca ve esa venta.
- Páginas lentas y salidas tempranas. Si alguien cierra la página de agradecimiento antes de que el píxel se dispare, el evento se pierde.
Los dos últimos puntos son los que más se subestiman. En un negocio de generación de leads —clínicas, inmobiliarias, educación, turismo, servicios B2B— el evento que importa (una venta pagada) vive en el CRM, no en una página web. El píxel no puede informarlo. La API de conversiones sí.
Qué busca lograr la API de conversiones de Meta
Meta lo describe como una conexión más fiable entre los datos de marketing y los resultados de los anuncios. En la práctica se resume en tres cosas:
- Mejor medición. Más conversiones reales aparecen en el Administrador de anuncios, así que tu costo por resultado se acerca a la realidad.
- Mejor optimización. El sistema de entrega de Meta aprende de las conversiones. Si solo ve la mitad, aprende de una muestra distorsionada. Si le das ventas reales —no solo formularios enviados— aprende a encontrar personas que de verdad compran.
- Menos dependencia del navegador. Tus datos ya no se pierden cada vez que un navegador cambia sus reglas.
Cómo funciona, paso a paso
Así funciona una configuración típica de generación de leads:
- Una persona hace clic en tu anuncio. Meta agrega un identificador de clic (
fbclid) a la URL de la página de destino, y el píxel lo guarda en la cookie_fbc. - La persona envía un formulario. Tu web, tu CRM o tu integración guarda sus datos de contacto junto con ese identificador de clic.
- Cuando ocurre algo importante —se crea el lead, se califica o paga— tu servidor envía un evento a Meta: el nombre del evento, la hora y datos del cliente como email y teléfono.
- Los datos personales se cifran con hash (SHA-256) antes de salir de tu servidor. Meta compara esos hashes con sus usuarios y atribuye la conversión al anuncio que vio esa persona.
Meta llama calidad de coincidencia de eventos (Event Match Quality, EMQ) a qué tan bien puede vincular tus eventos con personas concretas. Se mide de 0 a 10 en el Administrador de eventos. Solo los eventos con coincidencia se usan para la atribución y la optimización de anuncios; los demás cuentan para la medición básica. Cuantos más identificadores envíes —email, teléfono, nombre, dirección IP, user agent, fbc, fbp, external_id— más alta suele ser la puntuación.
API de conversiones vs píxel de Meta: ¿necesitas los dos?
Sí, en la mayoría de los casos. No compiten entre sí. Meta recomienda usarlos juntos, y la razón es simple: cada uno ve cosas que el otro no ve.
| Píxel de Meta | API de conversiones | |
|---|---|---|
| Dónde funciona | En el navegador del visitante | En tu servidor, CRM o integración |
| Lo bloquean los bloqueadores de anuncios | A menudo | No |
| Ve ventas offline y etapas del CRM | No | Sí |
| Ve el comportamiento en la página (vistas, scroll, carrito) | Sí | Solo lo que envíes |
| Configuración | Pegar un fragmento de código | Código de servidor, un gateway o una integración lista |
Cuando el mismo evento llega por las dos vías, Meta necesita saber que es uno solo, no dos. Eso es la deduplicación: ambas copias deben tener el mismo event_name y el mismo event_id (o coincidir en external_id y fbp). Si esto falla, tus compras se duplican en el Administrador de anuncios: un error muy común en las configuraciones caseras. Lo veremos en detalle en un artículo aparte sobre API de conversiones vs píxel.
Límites que conviene conocer antes de empezar
- La regla de los 7 días. El
event_timede un evento puede tener como máximo 7 días de antigüedad en el momento del envío. Si un solo evento del lote es más antiguo, Meta rechaza toda la solicitud. Esto importa si quieres informar ventas que se cierran semanas después de que llegó el lead: hay que enviarlas en cuanto cambia la etapa, no en una exportación mensual. - Las ventas en tienda física deben subirse dentro de los 62 días posteriores a la conversión, pero cada evento igual tiene que cumplir el límite de 7 días del
event_timeal momento de enviarlo. - El hash es obligatorio para los datos personales. Emails o teléfonos en texto plano no deberían salir de tu servidor.
- Envía casi en tiempo real. Meta recomienda enviar en tiempo real o en lotes cercanos al tiempo real. Los lotes de un día funcionan, pero la optimización reacciona más rápido a datos frescos.
- CAPI no es solo para webs. Los eventos pueden venir de una web, una llamada, un chat, una tienda física, un email o mensajería empresarial: el campo
action_sourcele dice a Meta dónde ocurrió la conversión.
Tres formas de configurar la API de conversiones
1. Integración directa (con un desarrollador)
Tu desarrollador escribe código que llama al endpoint de la API de conversiones, se encarga del hash, los reintentos y la deduplicación, y guarda de forma segura un token de acceso de usuario del sistema. Máxima flexibilidad, pero es trabajo de ingeniería real, y alguien tiene que mantenerlo cuando Meta cambia de versión de la API.
2. Conversions API Gateway
La opción de autoservicio de la propia Meta. Despliegas un gateway en tu propia cuenta de nube (AWS o Google Cloud), conectas tu píxel y el gateway replica los eventos del navegador del lado del servidor. Meta no cobra licencia, pero pagas los recursos de la nube. El detalle: está pensado para eventos de la web. No sabe cuándo se cierra una venta en tu CRM.
3. Una integración lista
Plataformas como Shopify traen CAPI integrada para e-commerce. En los negocios de generación de leads, el hueco siempre fue el CRM: la venta ocurre en HubSpot, Pipedrive, Kommo (AmoCRM), Bitrix24 o una hoja de Google, y nada se la envía a Meta.
Para ese hueco se creó LeadMe. Conectas tu píxel de Meta y tu fuente —un CRM, un formulario, una hoja de cálculo—, eliges qué etapas del negocio se convierten en qué eventos (Lead, Lead calificado, Compra) y LeadMe los envía por la API de conversiones con hash, deduplicación e identificadores de clic resueltos automáticamente. Sin servidores que alquilar y sin código. También funciona con TikTok, Google Ads y otras plataformas, así que los mismos datos del CRM pueden alimentar todos los canales donde anuncias.
Cómo saber si está funcionando
- En Administrador de eventos → Probar eventos, envía un evento de prueba y confirma que llega con el origen "Servidor".
- Revisa la pestaña Resumen un día después: deberías ver eventos recibidos tanto del navegador como del servidor, con la deduplicación indicada en los que se repiten.
- Mira la calidad de coincidencia de eventos. Si es baja, probablemente faltan email, teléfono o identificadores de clic.
- Compara el Administrador de anuncios con tu CRM durante una o dos semanas. Los números nunca coinciden del todo, pero la diferencia debería reducirse de forma notable.
Respuestas cortas a preguntas frecuentes
¿La API de conversiones es gratis?
Meta no cobra por la API en sí. Pagas lo que la hace funcionar: horas de desarrollo, el hosting en la nube del Gateway o la suscripción a una integración.
¿Es lo mismo que la "API de conversiones de Facebook"?
Sí. Es el mismo producto; la plataforma publicitaria de Facebook ahora se llama Meta. Verás "CAPI", "Facebook CAPI" y "API de conversiones de Meta" como sinónimos.
¿La necesito si solo recibo leads y no vendo online?
Los negocios de leads probablemente la necesitan todavía más. Sin ella, Meta optimiza para formularios enviados, incluidos números falsos y personas que nunca contestan el teléfono. Con las etapas del CRM enviadas por CAPI, puede optimizar para leads que terminan pagando.
¿Va a romper mi píxel actual?
No. CAPI funciona junto al píxel. Lo único que hay que hacer bien es la deduplicación, para que una misma compra no se cuente dos veces.
Próximo artículo de la serie: Conversions API Gateway: cuánto cuesta en realidad y cuándo no es la mejor opción.