Guía

Primeros pasos

Da de alta tu sitio, añade una línea de código y confirma tu primer evento. Si te has quedado en "no veo datos", la sección de abajo cubre las causas reales — sin conjeturas.

Paso 01

Da de alta un sitio

Añade tu sitio desde Tus sitios → Nuevo sitio. Atriqo genera un valor data-site único para el snippet de abajo y crea el registro de dominio contra el que se comprueba el tracker — cualquier dominio adicional de ese sitio (ver el aviso de más abajo) lo registras desde Ajustes del sitio.

Paso 02

Añade el snippet del tracker

Pega esto en el <head> de cada página que quieras medir:

<script src="https://api.atriqo.com/track.js" data-site="SITE_ID" async></script>

Sustituye SITE_ID por el valor data-site de tu pantalla de instalación. Una sola línea — sin paquete npm, sin paso de bundler, sin SDK.

Paso 03

Confirma el primer evento

Abre tu sitio en el navegador. La pantalla de instalación comprueba el primer evento automáticamente y pasa por varios estados:

  • Esperando tu primera visita… — comprobando si llega el primer evento.
  • Primer evento recibido — ya ha llegado tu primer evento. Aparece un botón para ir al dashboard.
  • Problema de conexión, reintentando… — una comprobación no pudo contactar con el servidor; Atriqo vuelve a intentarlo solo.
  • Seguimos esperando — todavía no ha llegado ningún evento, pero seguimos comprobando cada 5 segundos. Si tarda más de un par de minutos, estás en el caso de «no veo datos»: sigue leyendo.

No veo datos

Casi todos los casos se deben a una de estas cuatro cosas. Revísalas en este orden.

Dominio distinto, sitio distinto

ejemplo.com y www.ejemplo.com son dos dominios distintos para Atriqo. Si tu sitio responde en ambos y solo has registrado uno, el tráfico del otro no se contará. Añade el dominio que falte desde Ajustes del sitio.

Content Security Policy (CSP)

El snippet es un script cargado desde api.atriqo.com, y además envía sus propias peticiones a ese mismo origen. Si tu sitio tiene una Content-Security-Policy estricta en script-src o connect-src, añade api.atriqo.com a ambas directivas — si no, el navegador bloquea el script o le impide enviar eventos, sin ningún error visible para ti.

Bloqueadores de anuncios

Hoy Atriqo no está en las principales listas de bloqueo de trackers, así que la mayoría de bloqueadores lo dejan pasar. Algunas configuraciones — una lista de filtros personalizada muy estricta, por ejemplo — pueden seguir deteniéndolo. Si los números de un visitante concreto parecen bajos, un bloqueador en su navegador es una causa posible; no es algo que Atriqo pueda garantizar evitar.

Aplicaciones de una sola página (SPA)

Si tu sitio es una app React/Vue/Svelte(Kit), no necesitas llamar a nada manualmente en cada cambio de ruta. El tracker engancha pushState, replaceState y popstate, y registra una vista de página en cada navegación del lado del cliente de forma automática.