Solución de problemas

La mayoría de los problemas se deben a un puñado de causas. Empieza por No aparecen datos, que también cubre los píxeles publicitarios que no se cargan.

No aparecen datos

Repasa estos puntos en orden. Cada uno se comprueba rápido.

1. Lee la tarjeta de estado de la instalación. Abre Settings → Projects, despliega tu sitio y mira la tarjeta del panel Install snippet. «Waiting for data» significa que nunca ha llegado nada. «Installed» con un «Last data» antiguo significa que funcionó una vez y se detuvo. Haz clic en Check again después de visitar tu sitio.

2. ¿Está el tracker en la página? Mira el código fuente de tu página y busca el script t.js, con data-key="pk_…". Debe estar en todas las páginas que quieras rastrear, dentro del <head>. Con el paquete npm, comprueba que el provider envuelve toda tu aplicación y añade debug: true a su configuración para ver los mensajes [klickbee] en la consola del navegador (la etiqueta script no tiene opción de depuración).

3. ¿Es correcta la clave? El data-key (o projectKey) debe ser exactamente la clave que aparece en Settings → Projects. Un error tipográfico, una clave copiada de otro sitio o una clave que se ha rotado desde que instalaste el tracker son las causas habituales. Si rotaste la clave, la anterior dejó de funcionar de inmediato.

4. ¿Son correctos los allowed origins? Si Allowed origins no está vacío, solo se aceptan eventos de esos orígenes exactos. Comprueba el esquema, el host y el puerto: example.com y www.example.com son orígenes distintos, y también lo son http y https. Los dominios de staging y de vista previa necesitan su propia línea. O vacía la lista mientras depuras. Cuando el origen es incorrecto, tanto la analítica como los píxeles publicitarios fallan en silencio.

5. ¿Estás probando como un visitante? Las visitas de herramientas automatizadas (navegadores headless, curl, scripts, rastreadores y similares) se descartan a propósito. Haz la prueba en una ventana normal del navegador.

6. ¿Algo bloquea el script? Los bloqueadores de anuncios y algunas extensiones de privacidad bloquean los scripts de analítica. Abre tu sitio en una ventana privada sin extensiones, o busca t.js en la pestaña de red del navegador.

7. ¿El navegador pide que no se le haga seguimiento? Si el navegador del visitante envía Do Not Track, el tracker no hace nada, por diseño. Prueba con ese ajuste desactivado. Tu propio navegador puede tenerlo activado sin que lo sepas.

8. ¿Está esperando el modo de consentimiento? Con el paquete npm y requireConsent: true, no se registra nada hasta que se ejecuta grantConsent(). Un visitante que lo ha rechazado tampoco es rastreado. Consulta Privacidad y consentimiento.

9. ¿Ha alcanzado el sitio el límite de su plan o está suspendido? Un sitio Free incluye 1,000 sesiones al mes. Cuando se aplica el límite del plan y un sitio lo ha alcanzado, las sesiones nuevas dejan de registrarse hasta que el contador se reinicia el día 1 del mes (UTC) o pasas a Pro. Un sitio suspendido no registra nada en absoluto. La parte superior del panel muestra el contador mensual de los sitios Free, y Settings → Billing muestra el estado del sitio. Consulta Facturación.

10. ¿Es demasiado estrecho el intervalo de fechas? Las páginas ofrecen 24h, 7 days, 30 days y 90 days. Un sitio recién creado puede no tener nada en una ventana más antigua.

11. ¿Está seleccionado el sitio correcto? El selector de sitios de la parte superior de la barra lateral define qué sitio estás consultando.

Si sigues sin ver nada, abre las herramientas de desarrollo de tu navegador, ve a la pestaña Network, recarga tu sitio y busca una petición a /api/ingest. Su código de estado te dice qué está pasando:

Si no hay ninguna petición, el script no se está ejecutando o no está enviando: vuelve a los puntos 2, 6, 7 y 8.

El tracker funciona, pero algo no cuadra

Los recuentos de sesiones o de visitantes difieren de los de otra herramienta. Una sesión es una pestaña del navegador: una pestaña nueva inicia una sesión nueva, y un visitante que borra los datos de su navegador cuenta como un visitante nuevo. No se cuentan los visitantes cuyo navegador envía Do Not Track, las visitas bloqueadas por un bloqueador de anuncios ni los bots.

El cambio de página de mi aplicación de página única no se contó. Con la etiqueta script, una nueva página vista necesita un cambio de ruta. Un cambio de ?query o de #hash por sí solo no cuenta. Con el cliente npm simple, tienes que llamar tú mismo a pageview().

Veo $scroll en Top events. Es un evento del tracker, no un error. Consulta Rastrear eventos.

Los mapas de calor dicen «No recording of this page yet». Los mapas de calor se dibujan sobre una grabación de la página. Asegúrate de que replay está activado (data-replay no es false, o replay: true con el paquete npm) y navega por la página una vez. Los mapas de calor de clics también necesitan que autocapture esté activado.

Los objetivos de clic nunca se completan. Los objetivos de clic necesitan autocapture activado, y la etiqueta debe coincidir exactamente con el texto o el aria-label del elemento, incluidas las mayúsculas y minúsculas. Consulta Objetivos.

Los píxeles de Meta, Google Ads o LinkedIn no se disparan. La lista de píxeles se obtiene con la misma comprobación de allowed origins que los eventos, así que repasa primero el punto 4. Después, asegúrate de que el píxel está Enabled y usa su botón Test en la página Pixels: una superposición lista cada píxel como «fired» o «no request yet». Un bloqueador de anuncios puede suprimir las peticiones de los píxeles. Un ID mal escrito tampoco rastrea nada y sin ningún error. Consulta Píxeles publicitarios.

Las conversiones no llegan a Meta ni a Google Ads. Las conversiones enviadas desde los servidores de Klickbee se procesan por lotes, así que espera unos minutos. Para conocer los requisitos de cada plataforma, consulta Conversiones.

El paso de consentimiento no detiene mi seguimiento. Si usas la etiqueta script, no puede esperar al consentimiento: añade el script después de que el visitante dé su conformidad. Consulta Privacidad y consentimiento.

Cuenta e inicio de sesión

Nunca me llegó el correo de verificación. En la pantalla de registro, haz clic en Resend email; en la pantalla de inicio de sesión, haz clic en Resend verification email. Revisa tu carpeta de spam. No puedes iniciar sesión hasta que el correo esté verificado.

El enlace de una invitación dice que ha caducado. Las invitaciones caducan a los 7 días. Pide a un owner o admin del sitio que la reenvíe desde Settings → Team. Consulta Invitar a tu equipo.

¿Sigues atascado?

Contáctanos o escribe a hello@klickbee.com e incluye:

• la dirección de tu sitio y el nombre del sitio en Klickbee,
• cómo instalaste el tracker (etiqueta script o paquete npm),
• lo que ves en la tarjeta de estado de la instalación,
• el código de estado de la petición a /api/ingest, si lo has mirado.

La clave pública pk_… se puede compartir sin problema.