Configuración de Matomo en un blog con Astro

May 10 2025 · 5min · linux

Introducción

La idea de esta entrada es configurar Matomo en un blog creado con Astro. Para ello vamos a usar una integración de Matomo para Astro llamada Astro Matomo

Creación del Sitio Web en Matomo

• Para ello deberemos loguearnos en Matomo y crear un nuevo sitio web.
• Para ello deberemos ir a la sección de Todos los Sitios web y luego a Agregar un nuevo Sitio de Internet.
• Seleccionaremos Sitio de Internet
• Le datemos un nombre al sitio web, por ejemplo Blog de Cursos de Desarrollo
• Le daremos una URL, por ejemplo https://blog.cursosdedesarrollo.com
• Y pulsamos en Guardar
• Después debería aparecer el nuevo sitio web en la lista de sitios web.
• Pulsaremos en el enlace Ver Código de rastreo
• Ahí debería aparecer el código de seguimiento con el código del setSiteId y la url del sitio de matomo que deberemos usar más adelante.

Instalación del plugin de Matomo en Astro

npm install astro-matomo

Configuración de la integración

Para ello deberemos editar el fichero astro.config.mjs y añadir la integración

import matomo from 'astro-matomo'
import { defineConfig } from 'astro/config'

// https://astro.build/config
export default defineConfig({
  site: 'https://example.lol',
  integrations: [
    matomo({
      enabled: import.meta.env.PROD, // Only load in production
      host: 'https://analytics.example.lol/',
      setCookieDomain: '*.example.lol',
      trackerUrl: 'js/', // defaults to matomo.php
      srcUrl: 'js/', // defaults to matomo.js
      siteId: 666,
      heartBeatTimer: 5,
      disableCookies: true,
      debug: false,
      viewTransition: {
        contentElement: 'main'
      }
    }),
  ]
})

En este caso las direcciones de host, setCookieDomain y siteId son las que nos da Matomo para poder cargar el script de seguimiento. Por ello deberemos cambiar estos valores.

Por ejemplo en mi caso serían:

• host: https://matomo.cursosdesarrollo.com/
• setCookieDomain: *.cursosdesarrollo.com
• siteId: 3