Saltar al contenido
Funciones Integraciones Precios Documentación
Iniciar sesión Empieza gratis

Instalar el tracker

El tracker (t.js) pesa unos 2 KB, no usa cookies, no escribe nada en el dispositivo del visitante y nunca bloquea el renderizado de la página (defer).

Snippet HTML

<script defer src="https://www.byanalytics.co.unikaweb.es/t.js" data-site="TU_CLAVE_DE_WEB"></script>

Colócalo en el <head> de todas las páginas. Tu clave está en Ajustes de la web → Instalación.

Atributos opcionales

Atributo Para qué sirve
data-api="https://…/api/e" Envía los eventos a otro endpoint (por ejemplo un proxy propio).
data-hash Cuenta los cambios de #hash como páginas vistas (routers con hash).
data-local Registra también en localhost (desactivado por defecto).

Aplicaciones SPA

React, Vue, Svelte, Next.js, Nuxt y cualquier aplicación que use la History API se registran automáticamente: cada pushState o popstate es una página vista. Las View Transitions de Astro funcionan sin configuración.

Astro

Usa el componente de integrations/astro:

---
import ByAnalytics from '../components/ByAnalytics.astro';
---
<head>
  <ByAnalytics site="TU_CLAVE_DE_WEB" />
</head>

Laravel

composer require byanalytics/laravel

Define BYANALYTICS_SITE_KEY en tu configuración y añade el componente Blade a tu layout:

<x-byanalytics />

El paquete también puede enviar eventos desde el servidor mediante la API de eventos.

WordPress y WooCommerce

Instala el plugin byanalytics de integrations/wordpress, abre Ajustes → byanalytics y pega tu clave de web. Las compras de WooCommerce se registran como eventos purchase con el total del pedido como ingreso.

Comprueba la instalación

Abre tu web en una ventana normal del navegador y mira Tiempo real en byanalytics. El asistente de instalación también espera al primer evento y se pone en verde cuando llega.

No se registran visitas cuando:

  • la página se sirve desde localhost (salvo con data-local);
  • el navegador está automatizado (navegadores headless, navigator.webdriver);
  • el visitante se ha excluido (ver abajo);
  • el user agent es de un bot conocido; estos se cuentan aparte como visitas de bots.

Excluir tus propias visitas

Ejecuta esto una vez en la consola del navegador estando en tu web:

localStorage.setItem('byanalytics_ignore', '1')

Borra la clave para volver a contar.

Content Security Policy

Si tu web usa CSP, permite el script y el endpoint de recogida:

script-src 'self' https://byanalytics.co;
connect-src 'self' https://byanalytics.co;