¿Qué es la Meta Conversions API (CAPI)?
La Meta Conversions API (CAPI) es la interfaz servidor a servidor de Meta para enviar eventos de conversión desde un sitio web, una app, un CRM o una fuente offline directamente a Meta, en lugar de a través del Pixel del navegador.
Cada evento indica un action_source que describe dónde ocurrió y lleva parámetros de usuario cotejables, a los que se aplica hash antes de enviarse. Cuando un evento de servidor duplica un evento del Pixel, Meta usa event_name más event_id para reconocer el par y contabilizar la acción una sola vez.
- action_source indica
- dónde ocurrió la conversión
- parámetros de coincidencia
- emailnúmero de teléfono
- deduplicación con el Pixel
- event_nameevent_id
Daniil Maximkin Publicado Revisado
- En la práctica
¿Cómo funciona la Conversions API?
La Conversions API envía eventos desde un servidor, un backend o un CRM a Meta por HTTP, de modo que acciones que el Pixel nunca observó —una compra fuera del sitio, una llamada telefónica, un pedido del CRM— también pueden llegar a Meta y aterrizar en el mismo dataset.
Cada evento lleva un nombre de evento, una hora y un conjunto de parámetros; los eventos de sitio web también requieren la URL de origen y el user agent del cliente, el contexto de navegador que Meta no puede ver.
- En la práctica
¿Para qué sirve action_source?
action_source indica dónde ocurrió la conversión, y Meta lo exige en todos los eventos enviados por la API. Enviarlo con precisión es una condición para usar la API.
Los valores aceptados cubren las formas en que puede producirse una conversión: website, app, phone call, chat, physical store, email, system-generated, business messaging y other. Un origen incorrecto representa mal de dónde vino la conversión.
- En la práctica
¿Qué son los parámetros de usuario con hash?
Los parámetros de coincidencia son los identificadores del cliente que permiten a Meta conectar un evento de servidor con una cuenta real, como un email o un número de teléfono. Los valores que identifican personalmente al usuario deben recibir hash antes de enviarse, algo que el Business SDK hace automáticamente.
Enviar varios parámetros de coincidencia independientes da a Meta más formas de confirmar que el evento pertenece a una persona real, que es lo que mide Event Match Quality.
- En la práctica
¿Cómo funciona la deduplicación con el Pixel?
Meta empareja un evento de navegador con su copia en el servidor usando event_name y event_id. El Pixel envía el valor como eventID y la Conversions API como event_id; los dos deben ser la misma cadena para reconocerse como una única acción.
Si los identificadores difieren, Meta puede contabilizar los eventos de navegador y de servidor por separado, lo que sobrestima las conversiones. Si coinciden, la acción se cuenta una sola vez.
- No confundir con
La Conversions API no sustituye al Pixel ni esquiva el consentimiento o las protecciones de privacidad del navegador. La configuración recomendada envía los mismos eventos por ambos canales y los deduplica, porque cada uno observa cosas que el otro no ve.
Un evento de servidor no es automáticamente más preciso: su calidad de coincidencia depende de los identificadores que lleve.
- Dónde comprobarlo
¿Cómo verifico los eventos de servidor en Events Manager?
- Meta Events ManagerdatasetOverview
- Meta Events ManagerdatasetTest Events
Abre Meta Events Manager y selecciona el dataset. El Overview muestra qué fuentes de eventos están reportando, y la herramienta Test Events muestra los parámetros de un evento entrante, incluido si llegó desde el servidor y si se deduplicó contra el navegador.
Los diagnósticos sacan a la superficie los eventos que llegan sin un identificador compartido, la señal más rápida de que falta el par event_id.
