Plugin de Craft CMS

MetriXs ofrece un plugin oficial de Craft CMS que añade el tracker a cada página de tu sitio, verifica tu sitio automáticamente y permanece estrictamente opcional: no se carga nada hasta que lo conectas. Sin editar el tema, sin snippets de Twig, sin banner de consentimiento.

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

Antes de empezar

Necesitas una cuenta de MetriXs. El plugin 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 sitio 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 sitio, p. ej. tusitio.com — sin https:// y sin www.
3. Omite la verificación manual del snippet que sugiere el panel — el plugin verifica tu sitio 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 del sitio. Solo da acceso a ese sitio (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 sitio y busca la sección de claves API
3. Pulsa Create API key y dale un nombre, p. ej. «Craft»
4. Copia la clave (mtx_live_...) inmediatamente — se muestra una sola vez y no se puede recuperar después

Paso 3: instala el plugin

Instálalo con Composer desde la raíz de tu proyecto Craft:

composer require metrixs/mx-cookieless-analytics

o instálalo desde el Plugin Store dentro del panel de administración.

Luego activa el plugin:

php craft plugin/install mx-cookieless-analytics

Paso 4: configura el plugin

En el panel de administración, ve a Ajustes → Plugins → MX Cookieless Analytics:

Campo	Qué poner
Enable tracking	Déjalo desactivado por ahora — actívalo tras la verificación
Site API key	La clave del paso 2
MetriXs URL	Deja el valor por defecto https://app.metrixs.eu
Site domain	Déjalo vacío para autodetección desde la URL del sitio
Exclude admins	Activado por defecto — los usuarios con acceso de administración no cuentan

Pulsa Guardar. El plugin verifica tu sitio automáticamente con ese mismo guardado — verás la confirmación verde «site verified» (o un mensaje de error explicando qué revisar). Activa Enable tracking y guarda de nuevo.

Paso 5: comprueba el seguimiento

1. Abre tu sitio 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 usuarios con acceso de administración quedan excluidos por defecto. Los usuarios normales con sesión iniciada sí se siguen. Prueba en incógnito o ajusta la exclusión en los ajustes del plugin.

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 y la API lo vuelve a leer. Solo alguien que controle tu dominio puede servir ese token, lo que demuestra la propiedad El token se retira una vez terminado el intercambio.

Referencia de ajustes

Ajuste	Por defecto	Significado
Enable tracking	Desactivado	Interruptor principal — no se carga nada hasta conectar el sitio y activarlo
Site API key	—	Clave del sitio desde el panel
MetriXs URL	https://app.metrixs.eu	Cambiar solo para endpoints propios (solo HTTPS)
Site domain	Vacío (auto)	Debe coincidir con el dominio en MetriXs
Exclude admins	Activado	No seguir a usuarios con acceso de administración

El script del tracker se sirve desde app.metrixs.eu con una URL versionada, se registra en el head de la página a través del pipeline de assets de Craft y se carga de forma asíncrona (defer). Funciona sin problemas junto a la caché y los CDN.

Solución de problemas

La verificación falla

• Asegúrate de que tu sitio es accesible públicamente por HTTPS (sin modo mantenimiento, sin firewall que bloquee los servidores de MetriXs)
• Guarda otra vez los ajustes del plugin — el intercambio se ejecuta en cada guardado

Sin datos en el panel

• Los ajustes del plugin deben haber mostrado la confirmación «site verified»
• Enable tracking debe estar activado
• El dominio del sitio debe coincidir exactamente con el de MetriXs (sin www., sin https://)
• ¿Has iniciado sesión como administrador? Excluido por defecto — prueba en incógnito

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 plugin.

Configuración sin el panel de administración La verificación automática se ejecuta al guardar ajustes. Si prefieres no usar el panel de administración, instala igualmente el plugin y verifica tu sitio manualmente: el panel muestra tu snippet, y MetriXs confirma la propiedad detectándolo en tu sitio.

Desinstalación

Al eliminar el plugin:

• Tu sitio no se desconecta automáticamente en MetriXs — revoca la clave API en el panel (Ajustes → Sitios → claves API) para detener la ingesta
• Tus datos históricos permanecen en tu cuenta de MetriXs

¿Prefieres sin plugin?

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