Cuando WordPress es solo tu editor y una web en Astro o Next.js muestra las entradas a los lectores, tu plugin de analítica de WordPress se queda en blanco. Cuenta las páginas que WordPress construye para los visitantes, y en una web headless WordPress no construye ninguna. Los lectores cargan el front-end, y WordPress solo responde a las llamadas de su API.
La solución habitual es una herramienta de analítica aparte en el front-end. Funciona, pero entonces los números viven en un sitio distinto al de tu contenido. Una página vista llega como una dirección del tipo /blog/my-post/, sin saber qué entrada muestra, quién la escribió ni cuándo se publicó.
Hay otra forma: devolver a WordPress las páginas vistas del front-end y asociar cada una a la entrada que muestra.
Cómo funciona en Vireo
Vireo Analytics te da una etiqueta de script para el front-end. La etiqueta carga el script de seguimiento de Vireo desde tu web WordPress y le envía cada página vista. WordPress asocia la página a una entrada, así que Páginas principales, la pantalla de estadísticas de cada entrada y la columna Vistas del administrador se llenan como lo harían con un tema.
Vireo solo acepta estas páginas vistas desde la dirección del front-end que introduzcas. Pega la etiqueta en cualquier otra web y no registra nada. Es gratuito para un front-end.
Configúralo
- En WordPress, ve a Vireo Analytics, Ajustes, Otros sitios, Front-end headless.
- Introduce la «Dirección del sitio front-end»: la dirección que ven los lectores, con
https://. - Haz clic en «Guardar ajustes».
- Copia la etiqueta que aparece en «Añadir al front-end».
Se parece a esto, con tus propias direcciones:
<script defer src="https://cms.example.com/wp-content/plugins/vireo-analytics/assets/js/tracker.js" data-endpoint="https://cms.example.com/..."></script>
Copia siempre la etiqueta desde la pantalla de ajustes en vez de escribirla. La dirección del endpoint depende de tu hosting, y la pantalla muestra la que funciona en el tuyo.
La etiqueta tiene que seguir siendo un script clásico. El script de seguimiento lee su configuración de su propia etiqueta, y un script que un empaquetador ha convertido en módulo no puede hacerlo. Los dos frameworks de abajo lo dejan intacto si lo añades como se muestra.
Astro
Pega la etiqueta en el layout que usan todas las páginas, justo antes de </body>:
---
// src/layouts/Base.astro
---
<html lang="en">
<head>...</head>
<body>
<slot />
<script defer src="https://cms.example.com/wp-content/plugins/vireo-analytics/assets/js/tracker.js" data-endpoint="https://cms.example.com/..."></script>
</body>
</html>
Astro empaqueta las etiquetas <script> simples, pero una etiqueta con atributos distintos de src se deja tal como está escrita, así que esta sigue siendo un script clásico sin ningún cambio.
Si usas las transiciones de vista de Astro, el script de seguimiento cuenta cada cambio de página por su cuenta, escuchando el evento astro:page-load de Astro. Mantén la etiqueta en el layout compartido para que esté en todas las páginas en las que pueda aterrizar un lector. Astro ejecuta un script de la misma dirección una sola vez por visita, así que el script de seguimiento no se carga dos veces mientras los lectores navegan.
Next.js
En el App Router, añádela al layout raíz con next/script. Pasa los atributos data- a la etiqueta del script:
// app/layout.tsx
import Script from 'next/script';
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>{children}</body>
<Script
src="https://cms.example.com/wp-content/plugins/vireo-analytics/assets/js/tracker.js"
data-endpoint="https://cms.example.com/..."
data-spa="history"
/>
</html>
);
}
Mantén data-spa="history" en la etiqueta. Next.js cambia de página sin recargar, actualizando la dirección mediante la History API del navegador. Con ese atributo, cada uno de esos cambios y cada paso atrás o adelante cuenta como una página vista. Sin él, solo se cuentan las cargas completas de página.
El mismo atributo sirve para cualquier otro framework cuyo router use la History API. Si el tuyo hace otra cosa, llama a vireo('pageview') después de renderizar cada página nueva.
Asocia las páginas a las entradas
Vireo asocia por ruta. Si el front-end conserva los enlaces permanentes de WordPress, de modo que /my-post/ en el front-end es la entrada que está en /my-post/ en WordPress, no tienes que hacer nada.
Si las rutas difieren, por ejemplo porque el front-end pone las entradas bajo /blog/, añade el ID de WordPress de la entrada al head de cada página:
<meta name="vireo:post-id" content="123">
Ya tienes el ID: es id en la REST API y databaseId en WPGraphQL. En Astro, imprime la etiqueta en el head del layout de la entrada. En Next.js, añádela con generateMetadata usando other: { 'vireo:post-id': String(post.id) }.
Vireo prueba primero la ruta y usa el ID solo cuando la ruta no coincide con ninguna entrada. Las páginas que no son entradas, como tu página de inicio o un listado de etiquetas, se cuentan igualmente por dirección. Para casos más complicados, un desarrollador puede asignar rutas a entradas en PHP con el filtro vireo_headless_post_id.
Eventos personalizados
En un tema de WordPress, Vireo imprime un pequeño stub vireo() que pone en cola las llamadas hasta que se carga el script de seguimiento. En un front-end no hay stub, así que protege la llamada:
window.vireo?.('event', 'newsletter_signup');
Los eventos del front-end aparecen en Eventos principales junto con todos los demás. La documentación del tracker recoge las reglas para los nombres y valores de los eventos.
Tráfico de prueba y Search Console
Las páginas vistas solo se aceptan desde la dirección que introdujiste, lo que deja fuera de tus cifras los despliegues de vista previa y localhost. Un desarrollador puede añadir más direcciones con el filtro vireo_headless_allowed_origins.
Para Search Console, conecta la propiedad de la dirección del front-end, ya que es el sitio que indexa Google. Las búsquedas detrás de cada entrada explica lo que obtienes con ello.
Un front-end que no es tu blog
El ajuste headless es para un front-end que muestra las entradas de tu WordPress. Una web aparte, como una de documentación o una landing hecha con otra cosa, es en cambio un sitio conectado: tiene sus propios números, y un selector de sitio en el Resumen permite cambiar entre ellos. Un sitio conectado es gratuito, y puede recoger Core Web Vitals con una segunda etiqueta.