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, comonewsletter_signup. Se pasa a minúsculas y solo conservaa-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.