Módulo de PrestaShop

MetriXs ofrece un módulo oficial de PrestaShop que añade el tracker a cada página de tu tienda, verifica tu tienda automáticamente y envía los eventos order_completed desde el servidor — los ingresos, el valor medio de pedido, la tasa de conversión y los productos más vendidos llegan a tu panel de MetriXs, incluidos los pedidos pagados con métodos de redirección como iDEAL o Carte Bancaire. Sin editar el tema, sin código, sin banner de consentimiento.

Esta guía recorre toda la configuración, paso a paso.

Antes de empezar

Necesitas una cuenta de MetriXs. El módulo en sí es gratis y totalmente funcional; el plan gratuito de MetriXs es suficiente para empezar.

1. Ve a app.metrixs.eu y regístrate
2. Verifica tu dirección de correo con el enlace que recibes

Paso 1: añade tu tienda en MetriXs

1. Inicia sesión en el panel de MetriXs
2. Durante el onboarding (o en Ajustes → Sitios), añade el dominio de tu tienda, p. ej. tutienda.com — sin https:// y sin www.
3. Omite el paso de verificación del snippet que sugiere el panel — el módulo verifica tu tienda automáticamente en el paso 5
4. Si se te pide, inicia una prueba o elige el plan gratuito (los eventos requieren un plan activo)

Paso 2: crea una clave API del sitio

El módulo se autentica con una clave API del sitio. Solo da acceso a esa tienda (stats:read + event:write), nunca a tu cuenta, y puede revocarse en cualquier momento.

1. En el panel, ve a Ajustes → Sitios
2. Despliega tu tienda y busca la sección de claves API
3. Pulsa Create API key y dale un nombre, p. ej. «PrestaShop»
4. Copia la clave (mtx_live_...) inmediatamente — se muestra una sola vez y no se puede recuperar después

Paso 3: instala el módulo

1. Descarga el ZIP más reciente del módulo desde la página de releases de GitHub (mx-cookieless-analytics-X.Y.Z.zip)
2. En el back office, ve a Módulos → Gestor de módulos
3. Pulsa Subir un módulo, selecciona el ZIP y espera la confirmación

Alternativamente, descomprímelo en el directorio modules/ de tu instalación de PrestaShop (el nombre de la carpeta debe seguir siendo mx_cookieless_analytics).

Paso 4: configura el módulo

En Módulos → Gestor de módulos, busca MX Cookieless Analytics y pulsa Configurar:

Campo	Qué poner
Enable tracking	Déjalo desactivado por ahora — actívalo tras la verificación (paso 5)
Site API key	La clave del paso 2
MetriXs URL	Deja el valor por defecto https://app.metrixs.eu
Shop domain	Déjalo vacío para autodetección
Exclude logged-in customers	Activado por defecto — tus propias visitas no cuentan

Pulsa Guardar. La verificación arranca automáticamente con ese guardado.

Paso 5: conecta y verifica

Esto sustituye a la verificación manual — solo hay que hacerlo una vez.

1. Tras guardar, el módulo pide a la API de MetriXs un token de desafío de un solo uso y verifica tu tienda automáticamente
2. Verás la confirmación verde «shop verified»
3. En el panel de MetriXs, tu tienda aparece como Verified
4. Activa Enable tracking y guarda de nuevo

Cómo funciona: el módulo pide un token único a la API de MetriXs, lo sirve desde tu propio dominio y la API lo vuelve a leer. Solo alguien que controle tu dominio puede servir ese token, lo que demuestra la propiedad

Paso 6: comprueba el seguimiento

1. Abre tu tienda en una ventana de incógnito y navega unas páginas
2. En el panel de MetriXs, abre la vista en tiempo real — las páginas vistas deben aparecer en segundos

Nota: los clientes con sesión iniciada quedan excluidos por defecto. Prueba en incógnito o ajusta la exclusión en los ajustes del módulo.

Seguimiento de pedidos (incluido)

Cada pedido validado se envía desde el servidor en cuanto se crea — independiente del flujo de pago, así que los métodos de pago con redirección (iDEAL, Carte Bancaire, transferencia) quedan registrados. No hace falta un script de página de agradecimiento que se dispare dos veces al recargar.

Cada pedido llega como un evento order_completed con el total pagado (impuestos incluidos), la moneda, las líneas de pedido y el código de regla de carrito.

En cuanto hagas un pedido de prueba, el panel de MetriXs muestra:

• Ingresos, valor medio de pedido y tasa de conversión
• El embudo de checkout y los productos más vendidos por ingresos
• Un ranking de códigos de descuento si usas reglas de carrito con código

Un paso extra para ver los paneles de comercio:

1. En el panel, ve a Ajustes → Sitios
2. Despliega tu tienda y activa el interruptor Commerce

Los ingresos se convierten a EUR automáticamente con los tipos diarios del BCE y se muestran en la moneda de visualización que elijas.

Referencia de ajustes

Ajuste	Por defecto	Significado
Enable tracking	Desactivado	Interruptor principal — no se carga nada hasta conectar la tienda y activarlo
Site API key	—	Clave del sitio desde el panel
MetriXs URL	https://app.metrixs.eu	Cambiar solo para endpoints propios
Shop domain	Vacío (auto)	Debe coincidir con el dominio en MetriXs
Exclude logged-in customers	Activado	No seguir cuentas de clientes con sesión

Solución de problemas

La verificación falla

• Asegúrate de que la tienda es accesible públicamente por HTTPS (sin modo mantenimiento, sin firewall que bloquee los servidores de MetriXs)
• Revisa los módulos de seguridad del alojamiento que bloquean bots desconocidos — la API de MetriXs lee la URL de desafío de tu tienda
• Guarda otra vez la página de ajustes: el módulo reintenta (como mucho una vez cada 5 minutos)

Sin datos en el panel

• La página de ajustes debe mostrar la confirmación «shop verified»
• Enable tracking debe estar activado
• El dominio de la tienda debe coincidir exactamente con el de MetriXs (sin www., sin https://)
• ¿Has iniciado sesión como cliente? Excluido por defecto — prueba en incógnito
• ¿Caché de página completa? Purúrala para que el script del tracker llegue a tus páginas

Sin ingresos en el panel

• Haz un pedido de prueba y comprueba el evento order_completed en tiempo real
• Activa el interruptor Commerce del sitio (Ajustes → Sitios) — los paneles de ingresos están ocultos sin él

Clave API perdida Las claves no se pueden recuperar tras crearlas. Revoca la antigua en el panel (Ajustes → Sitios → claves API), crea una nueva y actualízala en el módulo.

Desinstalación

Al desinstalar el módulo:

• Tu tienda queda marcada automáticamente como desconectada en MetriXs (los eventos dejan de aceptarse)
• Tus datos históricos permanecen en tu cuenta de MetriXs
• Los ajustes del módulo se eliminan de tu base de datos

¿Prefieres sin módulo?

Siempre puedes añadir el tracker manualmente con el fragmento de las guías de plataformas — el módulo solo automatiza la instalación, la verificación y el seguimiento de pedidos.