API de conversiones de Meta en Tiendanube: la guía completa

El píxel de Meta vive en el navegador del comprador: manda datos siempre que el navegador se lo permita. La API de conversiones (CAPI, por sus siglas en inglés) manda la misma información pero desde el servidor de tu tienda, así que no depende de que el navegador coopere.

En Tiendanube las dos cosas conviven en la misma integración. No son dos herramientas separadas que compitan entre sí: son dos caminos para que la misma venta le llegue a Meta, y Meta las junta.

Para vos, dueño de una tienda, la diferencia práctica es esta: sin CAPI, cada bloqueador de anuncios o cada iPhone actualizado te resta ventas del reporte, aunque la venta haya pasado. Con CAPI, esas ventas vuelven a aparecer.

Los bloqueadores de anuncios (extensiones de navegador, algunos antivirus) cortan directamente el script del píxel antes de que se ejecute. Nunca sale del navegador.

Safari y los navegadores de iOS aplican políticas de rastreo entre sitios que acortan la vida de las cookies que el píxel necesita para identificar al comprador. Cuanto más vieja es la señal, menos confía Meta en ella.

El resultado es siempre el mismo: la venta pasó, la pagaste, la tenés en tu panel de Tiendanube, pero en el Administrador de eventos de Meta no llegó o llegó incompleta. Eso rompe la optimización de tus campañas, porque el sistema aprende de lo que ve, y si no ve la mitad de tus compras, aprende con datos incompletos.

Según la ayuda oficial de Tiendanube, al integrar tu tienda con Facebook, el píxel y la API de conversiones quedan instalados juntos. No existe un botón separado de activación: viene con la conexión.

Durante ese proceso vas a ver una pantalla de permisos: dejá activa la opción que permite acceder a tus anuncios y a las estadísticas relacionadas, porque de ahí sale la información que la integración necesita para mandar los eventos.

Un punto donde se pisan los cables: en algún momento de la integración con Meta puede aparecer la opción de inicializar el Conversions API Gateway. No conviene activarla. Ese gateway es una configuración manual que Meta ofrece para tiendas sin integración nativa, y activarlo sobre una tienda Tiendanube genera conflictos con la que ya está funcionando sola.

Esos tres son los que confirma la documentación oficial. El resto de los eventos —vistas de página, vistas de producto, búsquedas— siguen yendo solo por el navegador, porque son eventos de navegación, no de venta, y no tiene sentido mandarlos por servidor.

En la práctica, esto quiere decir que la API de conversiones cubre justo la parte del embudo donde más se pierde por bloqueadores: el momento en que alguien decide comprar. Es una cobertura acotada a propósito, no un reemplazo total del píxel.

La deduplicación la hace Meta automáticamente en la integración nativa de Tiendanube, sin que tengas que tocar nada. Por eso, si abrís el detalle de un evento de Purchase en el Administrador de eventos y ves un origen de navegador y otro de servidor para la misma compra, no es un error: es el diseño, y te sirve para ver qué tan bien está cubierta esa venta.

Donde sí se rompe es cuando alguien agrega, a mano, un evento de conversión —por ejemplo, un script de compra pegado en Códigos externos de Tiendanube, en la página de gracias. Ese evento manual no comparte el event_id del que manda la integración, así que Meta no lo puede deduplicar: la misma venta queda contada dos o tres veces.

La calidad de coincidencia de eventos es un puntaje que Meta le pone a cada evento según cuántos datos del comprador logra cruzar contra su base. No es un número decorativo: cuanto más alto, mejor arma Meta las audiencias y más rápido sale una campaña de la fase de aprendizaje.

También conviene usar la herramienta «Probar eventos» del Administrador de eventos: navegás tu propia tienda como si fueras comprador y ves, en tiempo real, si el evento llega, con qué parámetros y desde qué origen. Es la forma más rápida de confirmar que una compra de prueba disparó también el servidor, no solo el navegador.

Otro error frecuente: cambiar de tema o de proveedor de pagos y no volver a revisar que Códigos externos siga limpio. Un script viejo de una herramienta de analítica anterior puede seguir mandando un evento de compra que ya no hace falta.

Si tu tienda ya pauta en Meta y nunca revisaste esto, vale la pena hacerlo antes de tocar presupuesto o creativos: escalar una cuenta con eventos duplicados o con calidad de coincidencia baja significa optimizar sobre datos que no reflejan lo que realmente pasó. En Altiva, la revisión de píxel y API de conversiones es el primer paso de cualquier diagnóstico de una cuenta de e-commerce, justamente porque de ahí sale si el problema es de medición o de la campaña en sí.