Saltar al contenido
Data y MarTech

API de Conversiones de Meta: guía de implementación sin errores

Marcelo RodríguezCEO de Megáfono Digital. 29 de octubre de 2026. 3 min de lectura.

Respuesta corta: la API de Conversiones de Meta envía eventos desde su servidor directamente a Meta, en lugar de depender solo del píxel en el navegador. Se usa junto al píxel, con un identificador de evento común para no contar dos veces, y con datos del cliente cifrados para que Meta asocie cada evento a una persona.

Los bloqueadores de anuncios, las restricciones de los navegadores y los permisos de privacidad hacen que el píxel en el navegador pierda eventos. La API de Conversiones de Meta recupera esa señal enviándola desde el servidor, y además permite enviar eventos que nunca pasan por el sitio, como una venta cerrada en el CRM.

Píxel y API: juntos, no uno u otro

Meta recomienda una configuración redundante: el píxel envía el evento desde el navegador y la API envía el mismo evento desde el servidor. Meta los deduplica si ambos llevan:

  • El mismo nombre de evento (por ejemplo, Lead).
  • El mismo identificador de evento (event_id).

Si el identificador no coincide, Meta cuenta dos conversiones y los reportes se inflan.

Qué datos enviar

Parámetro Qué es Cómo se envía
em Correo electrónico Normalizado y cifrado con SHA-256
ph Teléfono con código de país Normalizado y cifrado con SHA-256
fn, ln Nombre y apellido Normalizados y cifrados
fbc Identificador del clic en el anuncio Tal cual, desde la cookie o el parámetro fbclid
fbp Identificador del navegador Tal cual, desde la cookie del píxel
client_ip_address, client_user_agent IP y navegador Tal cual, solo en eventos del sitio
action_source Origen del evento website, system_generated, crm, entre otros

Cuantos más identificadores válidos envíe, mejor podrá Meta asociar el evento a una persona. Eso se refleja en la calidad de coincidencia de eventos del Administrador de eventos.

Opciones de implementación

  • Integración con socios: muchas plataformas de e-commerce y CRM tienen conexión nativa. Es la vía más rápida si su herramienta la ofrece.
  • Gateway de la API de Conversiones: solución de Meta que se instala en su nube con poca programación.
  • Contenedor server-side de Google Tag Manager: buena opción si ya centraliza su medición en GTM. Lo explicamos en GTM server-side.
  • Integración directa: su equipo técnico envía eventos a la API desde su backend o su CRM.

Eventos del sitio y eventos del CRM

La API sirve para dos cosas distintas:

  1. Recuperar eventos del sitio (Lead, Schedule, Purchase) que el píxel pierde.
  2. Enviar eventos del CRM (lead calificado, venta), que es lo que permite optimizar hacia clientes. Lo detallamos en conversiones offline.

Lista de verificación

  1. Píxel y API envían el mismo event_id para cada evento del sitio.
  2. Correo y teléfono se normalizan antes de cifrar (minúsculas, sin espacios, teléfono con código de país).
  3. fbc y fbp se capturan y guardan en el CRM junto al lead.
  4. Los eventos se envían en tiempo real o con el menor retraso posible.
  5. Se usa el código de prueba del Administrador de eventos antes de publicar.
  6. El tratamiento de datos cumple con el consentimiento del usuario y la ley aplicable.

Cómo lo trabajamos en Megáfono

En Data y MarTech implementamos la API de Conversiones con deduplicación, eventos de CRM y validación en el Administrador de eventos.

¿Sus reportes de Meta no cuadran con el CRM? Agende un diagnóstico y revisamos su configuración.

Preguntas frecuentes

¿La API reemplaza al píxel?

No. Meta recomienda usar ambos con deduplicación. El píxel aporta señales del navegador; la API aporta confiabilidad y eventos fuera del sitio.

Los datos se envían cifrados y deben contar con el consentimiento correspondiente. Revise su política de privacidad y la normativa de su país, como la Ley 8968 en Costa Rica.

¿Cómo sé si está funcionando?

En el Administrador de eventos verá los eventos del servidor, el porcentaje deduplicado y la calidad de coincidencia. Úselos como control mensual.

Reciba la guía completa por correo

Un correo al mes con lo que funciona en pauta, IA y datos.

Opcional: al suscribirse también puede agendar una reunión con el equipo.