Menú de la documentaciónEl tracker y los eventos personalizados

El tracker y los eventos personalizados

Cómo se carga el tracker de Vireo, vireo() para eventos personalizados y aplicaciones de una sola página, los atributos de la etiqueta script y qué envía un beacon.

En esta página

Cómo se carga

En un tema de WordPress, Vireo imprime su tracker en el pie de página a través de wp_footer(). No hay nada que añadir. Para plantillas sin hook de pie de página, consulta Instalación.

El tracker envía una página vista por página con navigator.sendBeacon(), una vez cargada la página. Una página abierta en segundo plano se cuenta cuando pasa a ser visible.

Las vistas van a un endpoint pequeño, endpoint.php en la carpeta del plugin, que carga WordPress sin plugins ni tema. Si tu hosting bloquea los archivos PHP dentro de wp-content, o una CDN sirve el plugin desde otra dirección, Vireo usa admin-ajax.php en su lugar. Lo vuelve a comprobar cada hora. Lo que cuesta una página vista, medido.

Vireo excluye su tracker del retraso y la minificación de JavaScript en WP Rocket, Perfmatters, LiteSpeed Cache y FlyingPress, para que no se quede retenido hasta que alguien se desplace por la página.

Eventos personalizados

vireo('event', name);
vireo('event', name, value);
  • name: lo que ha pasado, como newsletter_signup. Se pasa a minúsculas y solo conserva a-z, 0-9, _ y -, hasta 100 caracteres.
  • value: opcional, hasta 100 caracteres, sirve para desglosar un evento en su propia pantalla.

En un tema de WordPress, vireo() existe desde el principio de la página y pone las llamadas en cola hasta que se carga el tracker, así que se puede llamar pronto sin problema.

<button onclick="vireo('event', 'pricing_toggle', 'yearly')">Yearly</button>

Sin nada de JavaScript, pon data-vireo-event="name" en un elemento, con un data-vireo-value="value" opcional. Un clic en él, o en cualquier cosa dentro de él, envía ese evento. Está siempre activo, sin nada que habilitar.

<a href="/pricing/" data-vireo-event="pricing_click" data-vireo-value="header">Pricing</a>

Los eventos aparecen en Eventos principales y pueden ser objetivos en Vireo Pro.

Aplicaciones de una sola página

Si usas Haz esto
Transiciones de vista de Astro Nada. Cada astro:page-load cuenta.
Un router que usa la History API Añade data-spa="history" a la etiqueta del tracker. Cada pushState y cada navegación hacia atrás o hacia delante cuenta.
Cualquier otra cosa Llama a vireo('pageview') después de que se haya renderizado la página nueva.

Una navegación a la misma dirección que la anterior no se cuenta dos veces.

Atributos de la etiqueta script

Fuera de un tema de WordPress, en un front-end headless o en un sitio conectado, el tracker es una etiqueta script que pegas tú. Cópiala de los ajustes de Vireo en lugar de escribirla a mano.

Atributo Significado
data-endpoint Adónde enviar las vistas. Obligatorio fuera de WordPress.
data-site La clave de un sitio conectado. Déjalo fuera en un front-end headless.
data-spa="history" Cuenta como páginas vistas las navegaciones de la History API.
data-post-id El ID de la entrada de WordPress de la página, cuando lo conoces. La etiqueta meta vireo:post-id lo sobrescribe.

Una página headless también puede indicar su entrada de WordPress con <meta name="vireo:post-id" content="123">.

Qué envía un beacon

Una página vista envía la ruta, el referente y el ID de la entrada cuando hay uno. Un evento envía su nombre y su valor. Cuando el lector sale de la página o cambia a otra pestaña, una petición pequeña más envía la ruta y los segundos que la página estuvo delante de él desde el último informe, para el tiempo en la página. No se guarda nada en el navegador ni se crea ninguna cookie.

La etiqueta de headless y de sitio conectado es el mismo script, así que esos sitios también obtienen tiempo en la página.

El tracker no envía nada cuando el navegador tiene activado Do Not Track o Global Privacy Control, ni cuando es un navegador automatizado como Playwright, Puppeteer, Cypress, PhantomJS o Nightmare.

Eventos automáticos

Los eventos automáticos que marcas en Ajustes, Seguimiento envían eventos normales (download, form_submit, mailto_click, tel_click, outbound). «Enlaces y botones pulsados» funciona de otra manera: envía un informe de clic con la página, la ruta de destino y el texto visible, para el informe Enlaces y botones más pulsados, y nunca una query string ni nada escrito en un formulario. Consulta Eventos y enlaces rotos.

Actualizado el 13 de octubre de 2026. ¿Algo está mal o falta? Avísanos.