Puntos clave
- La API de conversiones envía a Meta eventos web, de app, de mensajería empresarial y ventas fuera de línea desde un sistema de su empresa, no desde el navegador.
- No reemplaza al píxel: Meta recomienda enviar los mismos eventos por ambas vías y deduplicarlos con el mismo event_name y event_id dentro de 48 horas.
- Con un píxel ya instalado, la versión para eventos web se activa en un clic desde el administrador de eventos, sin código ni tarifas de configuración; el gateway se instala en su propia nube y su costo es el de la nube o el del socio.
- Correo y teléfono se envían convertidos con SHA-256; el teléfono debe llevar el código de país, que en Perú es 51, y la IP, el fbp y el fbc van sin hash.
- El reglamento de la Ley 29733 (D. S. 016-2024-JUS) considera datos personales a los identificadores en línea y exige consentimiento directo para la publicidad, así que el servidor debe respetar el banner de cookies.
La API de conversiones de Meta (antes API de conversiones de Facebook, conocida como CAPI) conecta los datos de su servidor, su plataforma web, su app o su CRM directamente con Meta, sin depender del navegador del visitante. Sirve para que Meta reciba ventas, formularios y otros eventos que el píxel no llega a ver, y Meta recomienda usarla junto con el píxel, enviando los mismos eventos por las dos vías y deduplicándolos.
Esta guía se basa en la documentación oficial de Meta y en el reglamento de la Ley 29733, revisados el 16 de noviembre de 2026. Si todavía no tiene el píxel instalado, empiece por nuestra guía del píxel de Meta.
¿Qué es la API de conversiones de Meta?
Es una herramienta de Meta que crea una conexión entre los datos de marketing de un anunciante y los sistemas de Meta. En lugar de que el navegador del cliente avise «esta persona compró», el aviso sale de un sistema de su empresa. Según la documentación oficial, una sola integración puede enviar cuatro tipos de eventos:
- Del sitio web: formularios, carritos, compras.
- De app: acciones dentro de una aplicación móvil.
- De mensajería empresarial: conversaciones en WhatsApp, Messenger o Instagram Direct.
- Fuera de línea: ventas en tienda, por teléfono o registradas en su sistema.
Los eventos del servidor se asocian a un identificador de conjunto de datos (dataset) y Meta los procesa igual que los del píxel.
¿Para qué sirve la API de conversiones?
Meta indica que la API ayuda a la segmentación de los anuncios, a reducir el costo por resultado y a medir los resultados. En la práctica, a una empresa peruana le sirve para tres cosas:
- Recuperar eventos que el navegador pierde. Según Meta, el píxel puede perder eventos web por problemas de conexión de red o por errores al cargar la página; la API los envía desde el servidor.
- Informar ventas que se cierran después. Por ejemplo, una distribuidora de Ate recibe una cotización por formulario y la venta se concreta días después, cuando el cliente paga por transferencia o Yape. Esa compra ocurre en su sistema, no en la web, y solo la API puede enviarla.
- Medir canales fuera de la web. El parámetro action_source admite email, website, app, phone_call, chat, physical_store, system_generated, business_messaging y other, para que Meta sepa dónde ocurrió la conversión.
Un límite que conviene conocer: cada evento puede tener como máximo 7 días de antigüedad (event_time) al enviarlo. Si un lote trae un solo evento más antiguo, Meta devuelve un error para toda la solicitud y no procesa ninguno.
¿En qué se diferencia del píxel de Meta?
El píxel es un código que se ejecuta en el navegador de cada visitante; la API envía los eventos desde un sistema de su empresa.
| Aspecto | Píxel de Meta | API de conversiones |
|---|---|---|
| Desde dónde envía | El navegador del visitante | Su servidor, plataforma, app o CRM |
| Qué eventos capta | Lo que pasa en la web abierta | Web, app, mensajería y ventas fuera de línea |
| Fallas de red o de carga | El evento puede perderse | Lo envía desde el servidor |
| Parámetros obligatorios | Los pone el código del píxel | action_source en todos; event_source_url y client_user_agent en los eventos web |
| Antigüedad del evento | Se envía cuando ocurre | Hasta 7 días antes del envío |
No hay que elegir uno: Meta recomienda una configuración redundante, con los mismos eventos (por ejemplo Purchase, InitiateCheckout y Contact) enviados por el píxel y por la API. Para que la misma compra no se cuente dos veces, ambos envíos llevan la misma clave y Meta descarta el duplicado.
¿Cómo funciona la deduplicación de eventos?
El método recomendado por Meta usa el nombre y el identificador del evento:
- El eventID del píxel debe ser igual al event_id de la API, y el nombre del evento del píxel igual al event_name de la API.
- Los envíos deben ir al mismo identificador de píxel y llegar dentro de las 48 horas siguientes al primer evento con ese event_id. Los posteriores se descartan.
- Si los dos eventos no difieren en contenido, Meta suele quedarse con el que llegó primero.
- Meta pide que el eventID sea un valor único. En la práctica, conviene usar el número de pedido o de transacción, porque navegador y servidor pueden enviar el mismo valor sin coordinarse aparte.
El método alternativo compara el event_name con fbp (la cookie del navegador) o con external_id (su identificador del cliente), pero en general solo deduplica si el evento llega primero desde el navegador y después desde el servidor.
Por ejemplo, una tienda virtual de Miraflores que envía «Purchase» con el pedido 10458 desde el píxel y desde el servidor verá una sola compra. Si el servidor envía «purchase» en minúsculas o un número distinto, Meta contará dos.
¿Qué es el gateway de la API de conversiones?
El gateway de la API de conversiones (Conversions API Gateway) es una opción de autoservicio del administrador de eventos para enviar los eventos web por el píxel y por la API sin un equipo de desarrollo dedicado:
- Se instala una instancia de servidor en la nube de su empresa. Meta documenta despliegues en AWS EKS, AWS ECS Express y Google Cloud (GCP).
- El píxel envía los eventos a Meta y al gateway, que los convierte en eventos de la API y los reenvía.
- El event_id para deduplicar se genera de forma automática.
- Una instancia puede atender varios dominios y varios píxeles, y trae un portal para ver la actividad de eventos y la tasa de éxito.
Según Meta, el único costo del gateway son los recursos de la nube o las tarifas del socio que lo aloje: la factura de AWS o Google Cloud la paga su empresa, y se necesita cierto conocimiento técnico. Si solo envía eventos del sitio web, la propia documentación aclara que la API de conversiones con Meta no requiere alojamiento ni mantenimiento.
¿Cuáles son las formas de implementarla?
Esta tabla ordena los caminos que describe Meta de menos a más esfuerzo técnico; la última columna es nuestra lectura para empresas peruanas.
| Método | Qué dice Meta | Cuándo encaja |
|---|---|---|
| API de conversiones con Meta (un clic) | Con un píxel ya instalado, se activa desde el administrador de eventos para eventos web, sin código, configuración ni tarifas de configuración. | Webs de servicios que solo miden eventos web. |
| Integración de la plataforma | Las plataformas que ofrecen el píxel pueden sumar la API. | Tiendas en plataformas que ya traen la conexión. |
| Gateway | Autoservicio en su nube (AWS o GCP); cuesta lo que cobre la nube o el socio. | Varias webs o píxeles y alguien técnico disponible. |
| Google Tag Manager del lado del servidor | Recoge eventos web y fuera de línea desde un servidor. | Empresas que ya miden con Tag Manager y Google Analytics 4 (GA4). |
| Zapier | Envía eventos a la API desde esa plataforma de automatización. | Ventas registradas en hojas de cálculo o formularios. |
| Integración directa | Conexión entre el servidor del anunciante y la API. | Ventas por teléfono, en tienda o en un CRM propio; requiere programador. |
Por ejemplo, a una empresa de servicios de Lince que recibe formularios suele bastarle el píxel bien configurado más la opción de un clic; una empresa que cierra ventas por teléfono o en su local necesita la integración directa desde su sistema de ventas, con action_source phone_call o physical_store.
¿Qué datos se envían y cómo se protegen?
La calidad de la API depende de los datos que acompañan a cada evento. Según las buenas prácticas de Meta:
- Obligatorios: action_source en todos los eventos; event_source_url y client_user_agent en los eventos web. Meta recomienda sumar external_id y event_id.
- Para la coincidencia: correo (em), teléfono (ph), IP (client_ip_address) y nombres (fn, ln). Un evento que solo trae datos amplios, como nombre más género (fn + ge o ln + ge), se considera inválido.
- Con hash SHA-256: correo, teléfono, nombres, fecha de nacimiento, género, ciudad, región, código postal y país.
- Sin hash: client_ip_address, client_user_agent, fbc y fbp.
Antes del hash, cada dato se normaliza. El correo va sin espacios y en minúsculas. El teléfono va solo con dígitos, sin ceros iniciales y siempre con el código de país, aunque todos sus clientes sean de un mismo país. En Perú el código es 51: «+51 987 654 321» se normaliza como 51987654321.
Meta califica la coincidencia con la calidad de coincidencia de eventos (Event Match Quality), de 1 a 10, y recomienda llegar a 6,0 o más. Por ahora solo existe para los eventos web.
Pasos para implementarla en una empresa peruana
- Defina los eventos. Para una web de servicios: Lead y Contact. Para una tienda: ViewContent, AddToCart, InitiateCheckout y Purchase con su valor en soles (código PEN).
- Revise el consentimiento: política de privacidad, banner de cookies y un servidor que respete la decisión del visitante.
- Elija el método según la tabla anterior, con el mismo píxel para navegador y servidor.
- Configure la deduplicación: mismo event_name y mismo event_id en ambos canales.
- Normalice y aplique el hash a correo y teléfono, con el 51 delante.
- Pruebe. Los eventos deberían verse en el administrador de eventos dentro de los 20 minutos siguientes al envío. Pruebe con sus propios datos: los eventos de prueba que no coinciden con una cuenta pueden descartarse.
- Controle tres indicadores: frescura (el retraso promedio, lo más cerca posible de tiempo real), tasa de deduplicación (cuanto más alta, mejor) y calidad de coincidencia.
¿Cómo se aplica la Ley 29733 y el consentimiento?
El Reglamento de la Ley 29733, aprobado por el Decreto Supremo 016-2024-JUS (publicado en El Peruano el 30 de noviembre de 2024 y vigente a los 120 días calendario), tiene cuatro puntos que tocan a la API de conversiones:
- Los identificadores en línea son datos personales (art. III, numeral 4). El fbp, la IP o un correo con hash sirven justamente para emparejar a la persona con su cuenta.
- La publicidad requiere consentimiento directo del titular (art. 26.1).
- Enviar datos a Meta es una transferencia: requiere el consentimiento del titular, salvo las excepciones del artículo 14 de la Ley, y siempre debe informársele (art. 13.1 y 13.2).
- Si los datos salen del país, el receptor debe estar en un país con nivel adecuado de protección o el exportador debe otorgar garantías adecuadas (art. 18).
En la práctica, la API no sirve para saltarse el banner de cookies: si el visitante rechaza las cookies publicitarias, el servidor tampoco debería enviar sus eventos web. En el resumen del administrador de eventos, Meta muestra cuántos eventos se descartaron por controles de consentimiento y otras políticas. Los datos de salud y los sensibles tienen definiciones propias (art. III, numerales 5 y 6): una clínica o un consultorio debe consultar a un abogado antes de enviar eventos. Más detalle en nuestra guía de la ley de protección de datos personales.
¿Se pueden medir las ventas que se cierran por WhatsApp?
Sí, con la API de conversiones para mensajería empresarial. Cubre WhatsApp, Messenger e Instagram en los anuncios que llevan a un chat, con eventos como LeadSubmitted, QualifiedLead y Purchase; la optimización por compras solo está disponible en los anuncios que llevan a Messenger y a WhatsApp.
En WhatsApp, la pieza clave es el ctwa_clid, el identificador del clic en el anuncio que llega en el webhook de mensajes. Los eventos se envían con action_source business_messaging, deben reflejar solo lo que ocurre en la conversación y Meta no los deduplica. Exige una app de desarrollador, acceso avanzado a los permisos de WhatsApp y la Cloud API alojada por Meta (Meta indica que el cliente On-Premises venció el 23 de octubre de 2025); por eso no funciona con la app de WhatsApp Business del celular, sino con la API de WhatsApp Business. Si evalúa anunciar dentro de WhatsApp, vea nuestra guía de publicidad en WhatsApp.
Errores frecuentes al implementar la API de conversiones
- Nombres distintos en el píxel y en el servidor («Lead» y «lead»): la deduplicación falla y los resultados se inflan.
- event_id distinto en cada canal: cada envío parece un evento nuevo.
- Teléfonos sin el 51 o con espacios antes del hash: el dato no coincide.
- Lotes con eventos de más de 7 días: Meta rechaza la solicitud entera.
- Aplicar hash a la IP o al fbp, que van sin convertir.
- No revisar después: un cambio de tema, de plugin o de servidor puede cortar el envío. Siga los cambios de la plataforma en novedades de Meta Ads en 2026.
¿Quiere que la configuremos por usted?
En nuestro servicio de analítica web definimos con usted los eventos que importan a su negocio, configuramos el píxel y las conexiones con Meta, dejamos la medición sujeta al consentimiento de cookies y probamos cada evento, junto con Google Analytics 4 y Google Tag Manager, con las cuentas a nombre de su empresa. Si además busca quien gestione sus campañas, vea el servicio de Meta Ads.
Fuentes
- Meta for Developers: Conversions API · consultado el 2026-11-16
- Meta for Developers: Handling Duplicate Pixel and Conversions API Events · consultado el 2026-11-16
- Meta for Developers: Best Practices - Conversions API · consultado el 2026-11-16
- Meta for Developers: Server Event Parameters · consultado el 2026-11-16
- Meta for Developers: Customer Information Parameters · consultado el 2026-11-16
- Meta for Developers: Conversions API Gateway · consultado el 2026-11-16
- Meta for Developers: Conversions API Guides · consultado el 2026-11-16
- Meta for Developers: Conversions API for Business Messaging · consultado el 2026-11-16
- Meta for Developers: Verifying Your Conversions API Setup · consultado el 2026-11-16
- Decreto Supremo 016-2024-JUS, Reglamento de la Ley 29733 (El Peruano, 30-11-2024) · consultado el 2026-11-16

