API de Conversiones de Meta: qué es y cómo configurarla
David Parada · Fundador de Escalads
Publicado el · Actualizado el · 10 min de lectura
En este artículo
- Qué es la API de Conversiones de Meta y en qué se diferencia del píxel
- Por qué la API de Conversiones importa desde iOS 14
- Cómo configurar la API de Conversiones paso a paso
- Deduplicación con event_id: cómo evitar ventas duplicadas
- Calidad de coincidencia de eventos: qué datos enviar
- Ejemplo: cuánto cambia lo que Meta ve
- Errores comunes con la API de Conversiones
- Checklist rápido antes de dar por lista la API
La API de Conversiones de Meta (CAPI) es la forma de enviar tus conversiones a Meta desde un servidor o desde tu plataforma de ventas, sin depender del navegador del cliente. Se usa junto al píxel: el píxel capta lo que pasa en la web y la API asegura que las compras reales lleguen aunque haya bloqueadores, cookies borradas o pagos que ocurren fuera de tu sitio. Bien configurada, con deduplicación por event_id y buenos datos del cliente, Meta aprende de más ventas reales.
Ahora, lo práctico: qué cambia con ella, cómo se conecta en las plataformas que más se usan en Latinoamérica y dónde se rompe.
Qué es la API de Conversiones de Meta y en qué se diferencia del píxel
El píxel es un código que vive en tu página. Cuando alguien carga la página de gracias, el navegador de esa persona le avisa a Meta: "hubo una compra". Si el navegador bloquea el aviso, se cierra antes de tiempo o la persona pagó en otra plataforma, Meta nunca se entera.
La API de Conversiones hace el aviso desde otro lugar: tu servidor, tu pasarela o una herramienta intermedia. Meta recibe el evento de una fuente que el navegador no controla.
| Píxel | API de Conversiones | |
|---|---|---|
| Desde dónde se envía | Navegador del cliente | Tu servidor, pasarela o herramienta |
| Lo afectan bloqueadores y cookies | Sí | No |
| Capta navegación (vistas, clics) | Sí, de forma natural | Solo lo que tú le mandes |
| Envía ventas fuera de la web (WhatsApp, llamada, pago por link) | No | Sí |
| Necesita desarrollo | Poco | Depende: nativa en algunas plataformas, webhooks en otras |
| Riesgo de duplicar ventas | Solo | Sí, si se usa con píxel sin event_id |
La conclusión es simple: no es uno u otro, son los dos. El píxel sigue creando la cookie _fbp y capturando el fbclid en la cookie _fbc, datos que luego la API necesita para que Meta reconozca a la persona.
Por qué la API de Conversiones importa desde iOS 14
Con iOS 14.5, en 2021, Apple empezó a pedir a las apps permiso explícito para rastrear al usuario entre apps y sitios (App Tracking Transparency). Muchas personas dicen que no. A eso se suman navegadores que limitan cookies y bloqueadores de anuncios.
El efecto para ti: el píxel ve menos compras de las que ocurren. Meta compensa parte con conversiones modeladas (estimadas), pero el algoritmo optimiza mejor cuando recibe eventos observados con datos para reconocer a la persona. Si tu campaña optimiza para compras y Meta solo ve 6 de tus 10 ventas semanales, está aprendiendo con información incompleta.
Hay otro motivo, muy de Latinoamérica: muchas ventas no pasan por tu web. Se cierran por WhatsApp, en una llamada o con un link de pago de Mercado Pago que el asesor envía por chat. El píxel no puede ver nada de eso. La API sí puede enviarlo, siempre que tengas cómo relacionar la venta con el clic original.
Cómo configurar la API de Conversiones paso a paso
El proceso general, sin importar la plataforma:
- Entra al Administrador de eventos y abre el conjunto de datos (el píxel) que usan tus campañas.
- Genera un token de acceso: en Configuración, sección API de Conversiones, opción de integración directa. Guárdalo como una contraseña.
- Elige el método de envío: integración nativa de tu plataforma, herramienta intermedia (Zapier, Make, n8n, un servicio de tracking) o desarrollo propio.
- Define qué eventos envías. Para ventas, mínimo
Purchaseconvalueycurrency. Si hay agenda o formulario, tambiénLeadoSchedule. - Envía los datos del cliente: correo y teléfono cifrados con SHA-256, más
fbc,fbp, IP y agente de usuario sin cifrar. - Configura la deduplicación si el mismo evento también lo manda el píxel (más abajo te explico cómo).
- Prueba con la herramienta "Probar eventos" del Administrador de eventos usando el
test_event_codeantes de enviar a producción. - Revisa a los 2-3 días la calidad de coincidencia y la pestaña de diagnóstico.
Hotmart
Hotmart tiene integración directa. En la configuración del píxel de tu producto pegas el ID del píxel y el token generado en el Administrador de eventos, verificas el token y guardas. El paso a paso está en la Central de Ayuda de Hotmart sobre el píxel de Meta.
Lo que conviene saber: la integración nativa envía los eventos del checkout de Hotmart, pero no sabe qué pasó antes en tu landing si esta vive en otro dominio. Si tu landing está fuera de Hotmart, pasa los parámetros de rastreo (src, sck o UTMs) al enlace de pago para no perder el origen.
Shopify
Instala la app de Facebook e Instagram y, en la configuración de uso compartido de datos, elige el nivel "Máximo". Con ese nivel Shopify usa el píxel y la API de Conversiones a la vez, según la ayuda de Shopify sobre el uso compartido de datos con Meta. No añadas otro píxel "a mano" en el tema, o duplicarás eventos.
Stripe
Stripe no envía eventos a Meta por sí solo. Lo normal es escuchar el webhook de pago completado (por ejemplo, checkout.session.completed) y desde ahí enviar el Purchase a Meta, ya sea con un servidor propio o con Zapier, Make o n8n. Si en la sesión de pago guardaste como metadatos el fbc, el fbp y las UTMs de la visita, puedes reenviarlos en el evento.
Whop
Whop tiene su propio sistema de rastreo y envío de conversiones a Meta. Revisa en su documentación qué eventos envía y con qué datos. Si además mandas el Purchase desde otra herramienta, desactiva uno de los dos envíos o usa el mismo event_id; si no, tendrás compras duplicadas.
Pasarelas sin integración (Wompi, Mercado Pago, PayU)
Aquí el camino es el de Stripe: webhook de pago aprobado → herramienta intermedia → API de Conversiones. La dificultad no es enviar el evento, es tener a mano el fbc, el fbp y el correo del comprador en el momento del pago. Si tu landing no los capturó y pasó al checkout, el evento llega a Meta con pocos datos y la coincidencia es baja.
Escalads Center resuelve esa parte: conecta estas pasarelas (y Zapier, Make o n8n para lo demás), une cada pago con los datos del clic y lo envía a Meta por la API de Conversiones. Tienes las guías de conexión en el centro de ayuda.
Deduplicación con event_id: cómo evitar ventas duplicadas
Si el píxel dispara Purchase en la página de gracias y tu servidor también envía Purchase por la API, Meta recibe dos eventos por la misma venta. Para que cuente uno, la documentación oficial de deduplicación de Meta pide:
- El mismo nombre de evento en ambos (
Purchaseen el píxel yevent_name: "Purchase"en la API). - El mismo ID de evento:
eventIDen el píxel yevent_iden la API. - Que el segundo llegue dentro de las 48 horas del primero. Pasado ese plazo, Meta no descarta el duplicado.
Cuando coinciden, Meta generalmente se queda con el primero que recibe. Hay un método secundario que usa fbp o external_id, pero funciona peor: depende de que el evento del navegador llegue antes y no sirve si solo tienes una fuente.
Qué usar como event_id: algo único por venta y que ambos lados conozcan. El ID de la orden o de la transacción es lo más práctico. Ejemplo: event_id: "HP1234567890" en la API y fbq('track', 'Purchase', {...}, {eventID: 'HP1234567890'}) en la página de gracias.
Un error típico: generar un ID aleatorio en el navegador y otro distinto en el servidor. Los dos llegan, ninguno coincide, Meta cuenta dos ventas.
Calidad de coincidencia de eventos: qué datos enviar
La calidad de coincidencia (Event Match Quality) es una puntuación de 0 a 10 que Meta muestra por evento en el Administrador de eventos. Mide qué tan bien los datos del cliente que envías permiten reconocer a la persona en Meta. Si no la reconoce, no puede atribuir la venta a un anuncio ni usarla para optimizar.
| Dato | Parámetro | ¿Se cifra? | Comentario |
|---|---|---|---|
| Correo | em |
Sí, SHA-256 | En minúsculas y sin espacios antes de cifrar |
| Teléfono | ph |
Sí, SHA-256 | Con código de país, solo dígitos (57300…) |
| Nombre y apellido | fn, ln |
Sí | Minúsculas |
| ID de clic | fbc |
No | Sale de la cookie _fbc o del fbclid |
| ID de navegador | fbp |
No | Sale de la cookie _fbp |
| IP y navegador | client_ip_address, client_user_agent |
No | Obligatorios para eventos de sitio web |
| ID de cliente propio | external_id |
Recomendado | Tu ID interno del cliente |
El fbc merece atención. Según la documentación de Meta sobre fbc y fbp, su formato es fb.1.<fecha de creación en milisegundos>.<fbclid>, y Meta recomienda enviarlo con cada evento. Es la pieza que dice "esta persona hizo clic en un anuncio". Si tu pago ocurre en otra plataforma, tienes que haberlo guardado antes.
Ejemplo: cuánto cambia lo que Meta ve
Supón un infoproducto de 297 USD con landing propia y checkout en Hotmart. En un mes, Hotmart registra 40 ventas.
- Solo píxel: el evento se dispara en la página de gracias. Parte de los compradores tiene bloqueadores o cierra antes de que cargue. Meta observa, digamos, 28.
- Píxel + API con deduplicación: las 40 ventas llegan por el servidor; las 28 que también vio el píxel se deduplican. Meta recibe 40 eventos únicos.
- Con buena coincidencia: si además envías correo, teléfono,
fbcyfbp, Meta puede reconocer a más de esas 40 personas y atribuirlas a anuncios.
Los números del ejemplo son ilustrativos: la proporción real depende de tu público, dispositivos y montaje. Lo importante es la lógica: la API no crea ventas, hace que Meta vea las que ya tienes. Si quieres entender por qué aun así el Administrador de anuncios no coincidirá con Hotmart, está explicado en Meta Ads no coincide con mis ventas.
Errores comunes con la API de Conversiones
- Duplicar sin deduplicar. Plataforma nativa + Zapier + píxel manual, todos mandando
Purchase. Revisa en el Administrador de eventos cuántas fuentes envían cada evento. - Enviar el valor en la moneda equivocada. Mandar
value: 1200000concurrency: "USD"cuando eran pesos colombianos. Tu ROAS en Meta se vuelve absurdo. - Cifrar datos que no van cifrados, o no cifrar los que sí.
fbc,fbp, IP y agente de usuario van en claro; correo y teléfono, cifrados. - Teléfonos sin código de país.
3001234567no coincide igual que573001234567. - Enviar eventos muy tarde. Meta acepta eventos con fecha de hasta 7 días antes del envío. Si registras ventas por WhatsApp a fin de mes, se quedan fuera.
- Enviar pagos no aprobados. Un
Purchasepor un pago pendiente de efectivo o por una tarjeta rechazada enseña al algoritmo a buscar gente que no paga. - Olvidar los reembolsos. Meta no descuenta la venta si reembolsas. Tu contabilidad sí debe hacerlo.
- No revisar el diagnóstico. El Administrador de eventos avisa de parámetros faltantes o duplicados. Míralo una vez por semana.
Checklist rápido antes de dar por lista la API
Purchasellega convalueycurrencycorrectos.- El mismo
event_iden píxel y API. - Correo y teléfono cifrados;
fbcyfbppresentes en la mayoría de eventos. - Solo pagos aprobados.
- Probado con "Probar eventos" y revisado el diagnóstico.
- Calidad de coincidencia revisada tras unos días de datos.
Con esto, Meta aprende de tus ventas reales. El siguiente paso es saber tú también qué anuncio trajo cada una: te lo explico en cómo saber de qué anuncio viene una venta.
Si manejas varias cuentas y no quieres repetir este montaje en cada cliente, Escalads Center conecta las pasarelas, deduplica y envía las ventas reales a Meta por ti.
Prueba Escalads Center 3 días y cancela cuando quieras.
FIN
Preguntas frecuentes
¿Qué es la API de Conversiones de Meta?
Es una forma de enviar eventos (compras, leads, registros) a Meta directamente desde tu servidor o desde tu plataforma de ventas, en vez de depender solo del píxel del navegador. Como no pasa por el navegador, no la frenan los bloqueadores ni las restricciones de cookies, y te permite enviar ventas que ocurren fuera de tu web.
¿Necesito el píxel si ya tengo la API de Conversiones?
Meta recomienda usar ambos. El píxel capta comportamiento en la web en tiempo real y crea la cookie _fbp; la API asegura que las conversiones importantes lleguen aunque el navegador falle. Si los usas juntos, envía el mismo event_id y event_name en los dos para que Meta no cuente la venta dos veces.
¿Cómo funciona la deduplicación con event_id?
Si el píxel y la API envían el mismo evento con el mismo event_name y el mismo event_id, Meta se queda con uno solo, generalmente el primero que recibe. Solo deduplica si el segundo evento llega dentro de las 48 horas siguientes al primero con ese event_id.
¿Qué es una buena calidad de coincidencia de eventos?
Es la puntuación de 0 a 10 que Meta muestra en el Administrador de eventos según cuántos datos del cliente envías para reconocer a la persona. Más datos útiles (correo, teléfono, fbc, fbp, IP, navegador) suben la puntuación. No hay un número mágico: la meta práctica es enviar todo lo que tengas con consentimiento.
¿La API de Conversiones sirve para ventas por WhatsApp?
Sí. Meta tiene una variante para mensajería empresarial que acepta eventos con action_source business_messaging y el identificador de clic ctwa_clid de los anuncios que abren WhatsApp. También puedes enviar la venta como evento de sitio web si la persona pasó antes por una página tuya con píxel.
David Parada
Fundador de Escalads
Trafficker y fundador de Escalads, agencia de tráfico pago para programas de alto ticket en Latinoamérica. Creó Escalads Center para que las agencias sepan qué hacer después de lanzar una campaña.