Plugin de Shopware 6

MetriXs tiene un plugin oficial de Shopware 6 que añade el tracker a cada página de tu tienda y verifica tu tienda automáticamente. Se mantiene estrictamente opt-in: no carga nada hasta que lo conectas. Sin editar el tema, sin snippets Twig, sin banner de consentimiento.

Esta guía recorre la instalación completa, paso a paso.

Nota

El plugin es compatible con Shopware 6 autoalojado (6.5 y 6.6). Las tiendas Shopware Cloud usan un sistema de extensiones distinto («apps») y todavía no están soportadas.

Antes de empezar

Necesitas una cuenta de MetriXs. El plugin en sí es gratuito y totalmente funcional; un 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 → Sites), añade el dominio de tu tienda, por ejemplo tutienda.es — sin https:// y sin www.
3. Omite el paso de verificación por snippet del panel — el plugin verifica tu tienda automáticamente en el paso 4
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 plugin se autentica con una clave API limitada al sitio. Solo concede acceso a esa tienda (stats:read + event:write), nunca a tu cuenta, y puedes revocarla en cualquier momento.

1. En el panel, ve a Ajustes → Sites
2. Despliega tu tienda y busca la sección API keys
3. Pulsa Crear clave API y dale un nombre, por ejemplo «Shopware»
4. Copia la clave (mtx_live_...) inmediatamente — se muestra una sola vez y no se puede recuperar después

Paso 3: instala el plugin

1. Descarga el último ZIP del plugin desde la página de releases de GitHub (metrixs-mxcoan-X.Y.Z.zip)
2. En la administración de Shopware, ve a Extensiones → Mis extensiones
3. Pulsa Subir extensión y selecciona el archivo ZIP

El plugin está probado en Shopware 6.5 y 6.6 (autoalojado).

Paso 4: configura el plugin

En la administración de Shopware, ve a Extensiones → Mis extensiones → MX Cookieless Analytics → Configurar:

O pulsa Connect with MetriXs: se abre el panel de MetriXs donde creas (o abres) tu cuenta, y la tienda se añade, verifica y el seguimiento se activa automáticamente. Sin copiar claves API.

Campo	Qué introducir
Enable tracking	Déjalo desactivado por ahora — actívalo tras la verificación
Site API key	La clave del paso 2
MetriXs API URL	Deja el valor por defecto https://app.metrixs.eu

Pulsa Guardar. El plugin verifica tu tienda automáticamente en el mismo guardado. La verificación se ejecuta como máximo una vez cada 5 minutos — si corriges un error (por ejemplo, una clave equivocada), espera un momento y vuelve a guardar.

Luego activa Enable tracking y guarda de nuevo. Shopware reconstruye la caché del tema al activar el plugin, así que el tracker aparece en tus páginas de inmediato.

Paso 5: verifica que el seguimiento funciona

1. Abre tu tienda en una ventana de incógnito y navega por algunas páginas
2. Abre el panel de MetriXs y revisa la vista Tiempo real — las páginas vistas deberían aparecer en segundos

Cómo funciona la verificación: el plugin pide a la API de MetriXs un token de desafío de un solo uso, lo sirve desde tu propio dominio (/mxcoan/challenge) y la API lo recupera. Solo alguien que controla tu dominio puede servir ese token, lo que demuestra la propiedad. El token se elimina cuando el handshake termina.

Pedidos e ingresos

Con el plugin conectado, los pedidos completados llegan solos: el plugin informa de un pedido cuando su transacción pasa a Pagado, y MetriXs lo cuenta como conversión, así las vistas de ingresos y conversión se llenan sin ningún ajuste extra. Cada informe lleva el total bruto del pedido, la moneda, el número de pedido y las líneas (nombre, precio, cantidad). No se envía nada personal - ni nombre, ni dirección, ni correo, ni enlace al pedido.

Un pedido se informa una sola vez, aunque se reembolse después o cambie de estado. Si MetriXs está brevemente inaccesible, el informe no se pierde: se reintenta en el siguiente cambio de estado.

Nota

¿Varios canales de venta en dominios distintos? Solo se inyecta el dominio que se verificó en el handshake. Añade los demás dominios en MetriXs y usa un plugin, o el snippet, por dominio.

Referencia de ajustes

Ajuste	Por defecto	Significado
Enable tracking	Desactivado	Interruptor maestro — no se carga nada hasta que la tienda esté conectada y esto activado
Site API key	—	Clave limitada al sitio, desde el panel
MetriXs API URL	https://app.metrixs.eu	Cámbialo solo para endpoints propios

El script del tracker se sirve desde app.metrixs.eu con una URL con versión, se inyecta en el <head> de cada página y se carga de forma asíncrona (defer). Funciona sin problemas con la caché HTTP y la caché de página completa de Shopware: el plugin vacía la caché al conectar.

Solución de problemas

La verificación falla

• Asegúrate de que la tienda es accesible públicamente por HTTPS (sin modo mantenimiento, sin cortafuegos que bloqueen los servidores de MetriXs)
• Revisa los módulos de seguridad del hosting que bloquean bots desconocidos — la API de MetriXs recupera la URL de desafío desde el dominio público de tu tienda
• Guarda de nuevo la página de ajustes: el plugin reintenta la verificación (como máximo una vez cada 5 minutos)

Sin datos en el panel

• Enable tracking debe estar activado y la tienda conectada (verificada)
• El dominio debe coincidir exactamente con el dominio de MetriXs (sin www., sin https://)
• ¿Navegas por tu propia tienda como administrador? Las visitas al storefront cuentan como cualquier visitante — prueba desde una ventana de incógnito si solo ves tu propio tráfico
• ¿Usas caché de página completa? El plugin la vacía al conectar; si activaste el seguimiento sin reconectar, vacía la caché manualmente

Los ingresos siguen en cero

• Los pedidos no necesitan ningún ajuste, pero sí una tienda conectada: el plugin activa la función de comercio del sitio al verificar
• Solo cuentan las transacciones que llegan a Pagado; los pedidos “en proceso” todavía no suman

Clave API perdida Las claves no se pueden recuperar tras su creación. Revoca la antigua en el panel (Ajustes → Sites → API keys), crea una nueva y actualízala en los ajustes del plugin.

Desinstalar

Cuando desinstalas el plugin:

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

¿Prefieres sin plugin?

Siempre puedes añadir el tracker manualmente con el snippet de las guías de plataformas — el plugin simplemente automatiza la instalación, la verificación y la gestión de la caché.