API de Conversiones de Meta: cómo configurarla sin duplicar eventos

¿Qué es la API de Conversiones de Meta y en qué se diferencia del píxel?

La API de Conversiones (Conversions API o CAPI) envía eventos como compras, añadidos al carrito o formularios desde tu servidor a Meta, en lugar de hacerlo desde el navegador del visitante. El píxel funciona con JavaScript en la página, así que un bloqueador de anuncios, las restricciones de cookies o una carga lenta pueden hacer que el evento se pierda.

El error más habitual es pensar que la API sustituye al píxel. Lo que Meta recomienda es una configuración redundante: el mismo evento llega desde el píxel y desde el servidor, y Meta los empareja para contarlo una sola vez. Si el navegador pierde el evento, el servidor cubre el hueco; si el evento del servidor llega con poca información, las cookies que lleva el píxel (fbp y fbc) ayudan a atribuirlo.

Si te preguntas por qué ni siquiera con píxel y API cuadran las cifras con tu tienda o con GA4, lo explicamos en por qué no coinciden los números de Shopify, Meta y GA4.

¿Qué método de configuración te conviene?

Si vendes con una plataforma como Shopify o Tiendanube, empieza por su integración nativa; si tu web es a medida, elige entre la puerta de enlace (Conversions API Gateway) o una integración directa. Lo que decide es el equipo técnico que tienes y cuánto necesitas personalizar los eventos.

Una regla práctica: si el panel de tu tienda tiene un apartado para conectar Meta o pegar un token de acceso, empieza por ahí. Si no lo tiene y no cuentas con desarrolladores, mira la puerta de enlace. Si tienes un checkout propio, renovaciones de suscripción o ventas offline que quieras atribuir, la integración directa te dará datos más fiables a largo plazo.

¿Cómo se activa en Shopify, Tiendanube y otras plataformas?

En Shopify, la API de Conversiones depende del nivel de uso compartido de datos de la app Facebook & Instagram; en Tiendanube se activa sola al conectar tu portafolio comercial de Meta. En ambos casos, el trabajo real está en elegir bien el ajuste y comprobar el resultado en Probar eventos.

Shopify

En el administrador de Shopify ve a Canales de ventas > Facebook & Instagram > Configuración > Configuración para compartir datos (en inglés, Sales channels > Facebook & Instagram > Settings > Data sharing settings; el texto exacto puede variar según el idioma del panel) y elige el nivel de uso compartido de datos de clientes. Según la ayuda de Shopify, el nivel Estándar solo usa el píxel de Meta, mientras que los niveles Mejorado (Enhanced) y Máximo (Maximum) añaden la API de Conversiones y comparten nombre, ubicación, correo electrónico y teléfono del cliente para mejorar la coincidencia. Shopify también te pide actualizar tu política de privacidad al hacer este cambio.

Tiendanube

Tiendanube, habitual entre las tiendas de Latinoamérica, lo simplifica aún más: en su centro de ayuda indica que, al conectar tu portafolio desde la sección Instagram y Facebook del administrador (botón Conectar con Meta o Editar conexión), la API de Conversiones de Meta se activa automáticamente y no hace falta configuración adicional. Revisa durante la conexión que el píxel y la cuenta publicitaria correctos estén seleccionados y que el dominio esté verificado en Meta.

WooCommerce, VTEX y webs propias

En el resto de plataformas la lógica es la misma: generas un token de acceso en Meta, en Administrador de eventos > tu conjunto de datos > Configuración > API de conversiones, y lo pegas junto al ID del píxel en el plugin o la integración correspondiente. Si no encuentras el campo, pide la ruta actual al soporte de tu plataforma.

¿Cómo funciona la deduplicación entre el píxel y la API?

Meta cuenta dos eventos como uno si el eventID del píxel coincide con el event_id del servidor y los nombres del evento (event y event_name) son idénticos. Según la documentación de Meta, la deduplicación se aplica a los duplicados recibidos dentro de las 48 horas siguientes al primer evento, y en general se conserva el que llega primero.

Lo más robusto para las compras es derivar el ID del número de pedido. Por ejemplo, para el pedido 10482 el navegador envía fbq('track', 'Purchase', {value: 89.90, currency: 'EUR'}, {eventID: 'order_10482'}) y el evento de servidor incluye "event_name": "Purchase" y "event_id": "order_10482". En una tienda mexicana sería igual con currency: 'MXN'.

Un ejemplo ilustrativo de por qué importa: una semana con 120 pedidos reales. El píxel captura 95 y la API 118. Sin deduplicación, el Administrador de eventos puede mostrar hasta 213 compras; las compras y el ROAS aparecen unas 1,8 veces por encima de la realidad y el algoritmo optimiza con una señal falsa. Con la deduplicación funcionando, la cifra se queda cerca de 120.

Meta admite un segundo método: enviar el mismo nombre de evento junto con fbp y/o external_id en lugar de event_id. Pero la documentación aclara que solo funciona cuando el evento llega primero desde el navegador y después desde el servidor, y que no sirve si usas una única fuente (solo navegador o solo servidor). Úsalo como señal de apoyo, no como método principal.

¿Cómo se normalizan y se pasan a hash los datos del cliente?

Correo, teléfono, nombre, apellido, ciudad y código postal se limpian primero según las reglas de formato de Meta y después se les aplica hash SHA-256; la IP, el user agent, fbc y fbp se envían sin hash. Si la limpieza previa está mal, el hash también lo estará y no habrá coincidencia.

¿Qué formato debe tener el teléfono en España y Latinoamérica?

Las tiendas guardan el teléfono de mil maneras: 612 34 56 78, +34 612-345-678 o 0034612345678 en España; 55 1234 5678 o +52 (55) 1234-5678 en México. La regla de Meta es quitar símbolos y ceros iniciales y añadir el código de país, así que antes del hash deben quedar como 34612345678 y 525512345678. Si queda un “+”, un “00” delante o falta el prefijo del país, el hash será distinto y ese campo no aportará nada a la coincidencia. Si tu formulario pide el país en un campo aparte, comprueba que al unirlos no se repita el prefijo (por ejemplo, 3434612345678). En Argentina, Colombia o Chile aplica lo mismo con 54, 57 y 56; valida el formato local de móviles antes de automatizarlo.

• El hash SHA-256 se calcula sobre el valor ya normalizado
• El teléfono lleva código de país y solo contiene dígitos
• El correo está en minúsculas y sin espacios
• client_ip_address y client_user_agent se envían en bruto
• Las cookies fbc y fbp también viajan en el evento de servidor
• Los clientes con sesión iniciada tienen un external_id estable

¿Qué es la calidad de coincidencia de eventos y cómo se mejora?

La calidad de coincidencia de eventos (Event Match Quality, EMQ) puntúa del 0 al 10 lo bien que los datos de cliente que envías desde el servidor permiten vincular cada evento con una cuenta de Meta. La ves por evento en el Administrador de eventos, dentro de tu conjunto de datos. La Dataset Quality API de Meta ofrece lo mismo con los campos composite_score y match_key_feedback, que indica qué claves de coincidencia recibes y en qué porcentaje de eventos.

Subir el EMQ casi nunca exige una herramienta nueva, sino completar los campos que faltan. En una compra casi siempre tienes el correo y el teléfono; si no se están enviando, ese es el primer arreglo. Después vienen fbc (el identificador de clic del anuncio), fbp, IP y user agent. En eventos de parte alta del embudo, como PageView, es normal que la puntuación sea baja porque no hay datos personales; céntrate en Purchase, InitiateCheckout y Lead.

1. Mide Anota el EMQ del evento Purchase y las recomendaciones de parámetros que muestra el Administrador de eventos.
2. Detecta huecos Mira qué clave llega en pocos eventos (suele ser el teléfono o fbc).
3. Corrige Ajusta la normalización en el código o en los ajustes de tu plataforma.
4. Valida Revisa los parámetros de los nuevos eventos en Probar eventos.
5. Espera y compara Deja unos días para que se actualice la puntuación y apunta la fecha del cambio.

La misma API informa también de la salud de la deduplicación: el campo event_coverage muestra el porcentaje medio, en los últimos 7 días, de eventos del píxel que también cubre la API de Conversiones con claves de deduplicación compartidas. Si es bajo, tu servidor no está enviando algunos eventos.

¿Cómo compruebo la configuración con Probar eventos?

Abre tu conjunto de datos en el Administrador de eventos, entra en la pestaña Probar eventos, envía el código de prueba como test_event_code en los eventos del servidor y comprueba que el mismo evento aparece desde el navegador y desde el servidor, con uno de ellos deduplicado. Hacer un pedido real de prueba es la verificación más fiable.

1. Copia el código En Probar eventos, copia el código de la sección de eventos del servidor.
2. Dispara eventos Mira un producto, añádelo al carrito y completa un pedido de prueba.
3. Revisa las fuentes Compara las filas de Purchase del navegador y del servidor, y sus event_id.
4. Revisa los parámetros Comprueba que el evento de servidor trae em/ph con hash, fbc, fbp, IP y user agent.
5. Quita el código Al terminar, elimina test_event_code de los envíos en producción.

¿Qué debes vigilar después de la configuración?

Durante las dos primeras semanas, compara cada semana las compras de Meta con los pedidos de tu tienda y revisa el EMQ y las alertas del Administrador de eventos. La API de Conversiones no sirve para inflar cifras sino para acercarlas a la realidad; si Meta muestra claramente más compras que pedidos, vuelve a revisar la deduplicación.

No olvides el consentimiento. Aunque los eventos del servidor no dependan del navegador, debes explicar en tu política de privacidad qué datos compartes y para qué, conforme al RGPD en España y a la ley de protección de datos de cada país latinoamericano. Tratamos la relación entre consentimiento de cookies y medición en nuestro artículo sobre Consent Mode v2 y privacidad.

Poner lado a lado las conversiones de Meta, Google Ads y GA4 es la forma más práctica de detectar desviaciones pronto. El análisis de conversiones de Marpany cruza esas fuentes con los datos de tu tienda, así puedes ver si, tras activar la API, las compras se acercan de verdad al número de pedidos. Qué métricas mirar lo tienes en la guía de KPI de rendimiento publicitario, y cómo mejorar la tasa de conversión en tu web, en optimización de conversiones en e-commerce.

Próximos pasos

• Elige el método según tu plataforma: integración nativa, Gateway o API directa
• Elimina los códigos de píxel duplicados de la plantilla o de Google Tag Manager
• Usa para Purchase un event_id común derivado del número de pedido
• Normaliza los teléfonos con código de país (34, 52, 57, 54, 56) y solo dígitos antes del hash
• Valida navegador y servidor con un pedido de prueba en Probar eventos
• Revisa el EMQ y las alertas cada semana tras el lanzamiento; los menús citados son los de septiembre de 2026 y pueden cambiar