Qué es la API de conversiones de Meta
Es una interfaz que te deja mandar a Meta eventos de negocio (un formulario enviado, una compra, una venta cerrada) directamente desde un sistema tuyo: tu servidor, tu plataforma de comercio electrónico o tu CRM. El píxel hace lo mismo desde el navegador del visitante; la API lo hace desde fuera del navegador.
Eso tiene dos consecuencias prácticas. La primera: los eventos no se pierden por bloqueadores ni por restricciones del navegador. La segunda, y más importante para quien vende por teléfono o con comerciales: puedes enviar eventos que ocurren después de la visita, como «cita agendada» o «venta cobrada», que el píxel nunca ve porque suceden en el CRM. Es lo que se conoce como conversiones offline en Meta.
Qué lleva un evento de la API de conversiones
Cada evento es una petición con unos campos básicos. Los principales:
| Campo | Para qué sirve |
|---|---|
event_name | Qué ha pasado (por ejemplo, Lead o Purchase) |
event_time | Cuándo ocurrió, en tiempo Unix |
action_source | Dónde ocurrió: web, correo, teléfono, sistema, etc. |
user_data | Datos para reconocer a la persona: correo y teléfono (con hash), identificadores de clic y navegador |
custom_data | Valor, moneda y detalles del evento |
event_id | Identificador para no contar dos veces el mismo evento si también llega por el píxel |
El correo y el teléfono deben normalizarse (minúsculas, sin espacios, teléfono con prefijo) y enviarse con hash SHA-256 según indica la documentación. El valor y la moneda son los que permiten optimizar por ingresos y no solo por número de eventos.
Cómo configurarla paso a paso
- Decide qué eventos vas a enviar. Empieza por pocos y que importen: lead, lead cualificado y venta.
- Elige el origen del envío. Desde la web (servidor o gestor de etiquetas del servidor) para los eventos de navegación; desde el CRM para los de negocio.
- Captura los identificadores en el momento del clic o del formulario y guárdalos con el contacto: el parámetro
fbclidde la URL (que da lugar afbc), la cookie_fbp, el correo y el teléfono. - Genera un
event_idúnico y úsalo igual en el píxel y en la API cuando ambos envían el mismo evento. - Prueba con la herramienta de eventos de prueba del Administrador de eventos antes de dar nada por bueno.
- Revisa la calidad de cada evento tras unos días (ver nuestra guía de calidad de coincidencia).
Cómo evitar eventos duplicados con el píxel
Si un mismo evento llega por el píxel y por la API, Meta lo cuenta una vez solo si puede reconocer que es el mismo. Para eso necesita el mismo event_name y el mismo event_id en las dos vías. Si falta el identificador, o es distinto, el evento se duplica y los informes inflan las conversiones.
Una regla sencilla: los eventos de navegador pueden ir por ambas vías con el mismo identificador; los eventos de negocio que solo existen en el CRM van solo por la API, con su propio identificador (por ejemplo, el número de la oportunidad).
Errores típicos con la API de conversiones
- Enviar solo correo sin hash o con hash mal hecho. Un hash sobre un dato sin normalizar no coincide con nada.
- No guardar
fbcnifbp. Sin ellos, la coincidencia depende solo de correo y teléfono. - Mandar el evento tarde. Hay un límite de antigüedad para los eventos; consulta la documentación vigente.
- Enviar un valor sin moneda o con valores de prueba que contaminan la optimización.
- Dar por buena la integración porque no da error. Que la API acepte la petición no significa que Meta haya reconocido a la persona.
- Enviar leads que nunca se cualifican como si fueran lo que quieres comprar. Meta aprende de lo que le mandas.
Qué ventaja da frente al píxel solo
El píxel sigue siendo útil, pero cubre únicamente lo que ocurre en el navegador y está expuesto a bloqueadores y cookies rechazadas. La API cubre ese hueco y añade lo que sucede en tu empresa. Meta recomienda usar ambos de forma redundante: lo que uno pierde, lo recupera el otro. Para entender el envío desde el servidor en general, tienes la guía de server-side tracking.
Cómo lo resuelve Acelera Sales
Acelera Sales mide tu publicidad hasta la venta cobrada en el CRM y devuelve esa venta a las plataformas con su API de conversiones. Hay conectores listos para Meta, Google/YouTube, TikTok, LinkedIn, Microsoft y Pinterest, y se conecta con cualquier CRM, con tu web y con los canales donde habla el cliente (WhatsApp, llamadas, chat). Cuando una oportunidad pasa a «cobrada», Acelera Sales envía a Meta el evento con valor, moneda, identificadores de clic y datos del contacto con hash, usando un identificador estable para evitar duplicados. Además vigila la calidad que Meta puntúa para cada evento y, si baja, corrige la causa (un campo que ya no se captura, un formato roto) antes de que el algoritmo lo note. Ver integración con Meta Ads o mirar la demo.
Fuentes
Preguntas frecuentes
¿Qué es la API de conversiones de Meta?
Es el sistema para enviar eventos a Meta desde un servidor o un CRM en lugar de desde el navegador. Sirve para no perder eventos y para enviar los que ocurren fuera de la web, como una venta cerrada.
¿La API de conversiones sustituye al píxel de Meta?
No hace falta sustituirlo. Meta recomienda usar píxel y API juntos, con el mismo identificador de evento para que no se cuente dos veces.
¿Necesito programar para usar la API de conversiones?
Hay integraciones ya hechas en plataformas de comercio electrónico y gestores de etiquetas. Para conectar un CRM a medida o enviar ventas cobradas, normalmente hace falta una integración técnica.
¿Qué es el event_id y por qué importa?
Es un identificador único del evento. Si el píxel y la API envían el mismo evento con el mismo nombre e identificador, Meta lo deduplica y lo cuenta una vez.
¿Cómo compruebo que la API funciona?
Con la herramienta de eventos de prueba del Administrador de eventos y revisando después la calidad de cada evento. Recibir el evento sin error no basta: tiene que coincidir con una persona.